.-
help for ^venndiag^                                        {STB-47: gr34)
.-

Venn Diagram
------------

  ^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^()^ 
     ^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 asthma, 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^
--------

^c1(^integer^)^ ^c2(^integer^)^ ^c3(^integer^)^ ^c4(^integer^)^ 
           Specifies which value to regard as outcome in v1...v4 (default 1) 

^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

^noframe^  Remove outer frame 

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

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

^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@  

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

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

^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

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

^print^ Print graph immediately (Windows 95 and Macintosh only)  

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

^r1^title^()^ ^r2^title^()^ ^r3^title^()^  ^r4^itle^()^ ^r5^title^()^ ^r6^title^()^ 
           Titles to shown, when ^x^ is included in label()


Examples
---------

 . ^venndiag asthma eczema hayfever^
 . ^venndiag asthma eczema hayfever, missing noframe^
 . ^venndiag cat dog bird, label(dftv) show(cptfvx)^
 . ^venndiag asthma 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
         jml@@dadlnet.dk


Also see
---------

    STB:  STB-47 gr34
On-line:  help for @stb@, @gphprint@, @graph@, @gph@, @note@