.-
help for ^venndiag^              (STB-47: gr34; STB-48: gr34.1)
.-

  ^venndiag^ varlist [^if^ exp] [^in^ range] [, ^c1()^ ^c2()^ ^c3()^ ^c4()^ 
     ^la^bel^()^ ^nof^rame ^nog^raph ^nol^abel  ^g^en^()^ ^li^st^()^  ^mis^sing ^sh^ow^()^
     ^t1^itle^()^ ^t2^title^()^ ^t3^title^()^ ^pr^int ^sa^ving^()^ ^pen()^ ^thick()^
     ^r1^itle^()^ ^r2^title^()^ ^r3^title^()^  ^r4^itle^()^ ^r5^title^()^ ^r6^title^()^]


Description
------------

^venndiag^ produces a so-called ^Venn diagram^ of the variables in varlist

The ^Venn diagram^ consists of a number of rectangles each corresponding
to one of the variables in varlist. The rectangles are arranged such that
they overlap and delimit areas. In each area the counts of records is 
shown for the relevant combination of ^varlist^ 

With two variables A and B, the counts of records (A== 1 & B== 1) is 
placed in the overlapping area of A and B. In area A (non A+B) the count 
(A== 1 & B!= 1) is placed and in area B (non A+B) the count (A!=1 & B==1).

Note: ^-^ A grid can be placed on the screen for further placement of texts 
          if a system macro is set with the command (global S_grid = "y")
      ^-^ Information retrievable in S_* variables after execution
      ^-^ Size of text can be set with ^Set textsize^ (<120 recommended)


---------

^venndiag^ could be used, for example, to

  ^-^ show how many persons have different symptoms indicated in the 
           variables in varlist. E.g astma, hayfever and eczema 

  ^-^ show in a household survey the numbers of having cats, dogs and birds

  ^-^ count specific diagnoses placed in one or several variables 

  ^-^ combine variables and achieve frequency counts in logfile 
      and in a new variable

  ^-^ create combined variable of 2-4 variables (with or without missing) 


Options
--------
^nograph^  Do not show graph, regardless of contents of ^SHow^

^show()^  Show in diagram:                   (default ^cptf^)
       ^p^ percent of area (area/total)
       ^c^ Count in each area
       ^t^ Percent of each variable (variable/total) (! SUM > 100 %)
       ^v^ Add variable name instead of A B C D
       ^f^ Add footnote explaining percentages
       ^n^ Display Nill (= 0) counts and percentages
       ^x^ Leave out counts and percentages in the nonABCD area
       ^all^ short form for all

^nolabel^ Disregards all labelling, regardless of contents of ^LA^bel

^label()^ Show to the right of diagram:   (default ^adft^)
       ^c^ variable names and value ^c^ounted in each variable
       ^f^ filename and date 
       ^d^ overall description 
       ^m^ indicates counts of missing in each variable  
       ^t^ titles are shown 
       ^a^ date of creation of graph added
       ^i^ information of number of records
       ^x^ show e^x^tra titles in r1title....r6title (do not use with ^mic^)
      ^all^ short form for all labels

^t1title(^string^)^ ^t2title(^string^)^ ^t3title(^string^)^ titles shown on graph
           Default t1(Venn Diagram) t2() t3(N = #records)

^r1^title^()^ ^r2^title^()^ ^r3^title^()^  ^r4^itle^()^ ^r5^title^()^ ^r6^title^()^ 
           Titles to show if ^x^ is included in label()

^saving(^file^)^ Save graph to file named as string (replacing file)
         On Win-95/MAC also saved as wmf file (see gphprint)

^gen()^  Add variable named in () to dataset. Must be non existing. The user
           must save the dataset after running venndiag to keep the generated
           variable. A note describing if/in or missing values is created for 
           the generated variable. Can be redisplayed with @note@ 
  
^c1(^integer^)^ ^c2(^integer^)^ ^c3(^integer^)^ ^c4(^integer^)^ 
           Specifies which value to regard as outcome in v1...v4 (default 1) 

^noframe^  Remove outer frame  

^missing^  Include all records regardless of missing variables in ^varlist^

^list(^vars^)^ List ^varlist^ and ^vars^ after combining variables

^pen()^    which pens to use in the graph ?.  E.g. pen(257): Pen 2 for texts
           pen 5 for rectangles, pen 7 for frame. Default pen(123)  

^print^    print graph immediately (Win-95 & MAC only)  

^thick()^  thickness of pens on ^printing^ (Win-95 & Mac), default thick(995). 
           Note link to ^pen()^. Eg. thick(5112) when pen(234).
           For thick frame and thin rectangle when pen is ^pen(123)^ specify: 
           ^thick(559)^. Pen number is defined by position in thick(). 
           Thickness on screen can vary depending on the local setup. Some
           experimentation might be necessary.


Examples
---------

 . ^venndiag astma eczema hayfever^
 . ^venndiag astma eczema hayfever, missing noframe^
 . ^venndiag cat dog bird, label(dftv) pen(246) thick(191714) print^
 . ^venndiag astma eczema hayfever, show(pf)                /*^
       ^*/ t1(Selfreported Allergic Outcomes in Youngsters) /*^
       ^*/ t2(The Odense Adolescence Cohort) t3(Study. Denmark,1996) la(dt)^

 Counting on different outcome values
 . ^venndiag d1  d2  d3, c1(812) c2(2) c3(830) gen(vdvar)^

 Applying if or in
 . ^venndiag d1 d2 if r > 0, saving(diagnose)^
 . ^venndiag d1 d2 in 1/400, list(id) label(md) show(fpn) ^


Author
-------

         Jens M.Lauritsen 
         County of Fyn, Odense Denmark
         jm.lauritsen@@dadlnet.dk

Also see
---------

    STB: STB-48 gr34.1, STB-47 gr34
On-line: help for @stb@, @gphprint@, @set textsize@, @gph@, @note@