.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: proc venndisk</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>proc venndisk</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.41 Mar2009
     </small><br><a href="../doc/scripthome.html">Scripts</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH proc_venndisk PL "11-MAR-2009   PL ploticus.sourceforge.net"

.LP
\fBproc venndisk\fR creates Venn diagrams.  Ploticus 2.33+ can also create "Venn magnitude charts".


.ig >>
<br><br><br>
.>>

.SH Venn diagrams

.ig >>
<center>
<a href="../gallery/venn.htm">
<img src="../gallery/venn.gif">
<br>
Click to see example code
</a>
</center>
.>>

To create a venn diagram, write a script that invokes proc_venndisk once for each disk.
For each disk you supply the coordinates (in inches or cm) of the disk center and the area.  
Thus it is a manual process not very suitable for automation.
.LP
The following attributes are used in producing traditional venn diagrams.
\fClocation\fR (or \fCbottomlocation\fR) and \fCarea\fR \fBmust\fR be supplied.

.ig >>
<br><br>
.>>
.LP
\fBlocation\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#xy">
.>>
\0x y
.ig >>
</a>
.>>
.IP \0
Location of the center of the disk.
Typically absolute units, but may be scaled units if \fC(s)\fR is appended to x and y values 
(requires an areadef).
.br
Example: \fClocation: 3 4\fR
.br
Example: \fClocation: 44(s) 48(s)\fR

.LP
\fBbottomlocation\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#xy">
.>>
\0x y
.ig >>
</a>
.>>
.IP \0
Specify the location of the bottom of the disk.  Used instead of \fClocation\fR... allows
several disks to be aligned along the bottom.

.ig >>
<br><br>
.>>

.LP
\fBarea\fR
.ig >>
&nbsp; &nbsp;
.>>
square inches (or cm)
.IP \0
The area of the disk in square inches or cm (whatever you're using as
.ig >>
<a href="attributetypes.html#positionunits">
.>>
\0absolute units).
.ig >>
</a>
.>>
See also \fCareascale\fR below.
.br
Example: \fCarea: 8\fR

.ig >>
<br><br>
.>>

.LP
\fBcolor\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
Color of the disk.  If not specified red will be used.

.ig >>
<br><br>
.>>

.LP
\fBlegendlabel\fR 
.ig >>
&nbsp; &nbsp;
.>>
text
.ig >>
&nbsp; &nbsp;
.>>
(formerly known as \fBlabel\fR)
.IP \0
A label to appear in a legend.  
The \fC\\n\fR construct can be used to force a line break when the legend is displayed,
or the label can be wordwrapped using proc legend wraplen attribute.
.ig >>
<a href="legend.html">
.>>
\0proc legend
.ig >>
</a>
.>>
must be invoked afterwards to render the legend.

.ig >>
<br><br><br>
.>>

.SH Venn magnitude charts
.ig >>
<a name=vennmag></a>
<center>
<a href="../gallery/vennmag.htm">
<img src="../gallery/vennmag.gif">
<br>
Click to see example code
</a>
</center>
.>>

To create a venn magnitude chart, write a script that sets up a plotting area (proc areadef),
gets some area values (proc getdata), and then invokes proc_venndisk one time.  One disk will be
rendered for each row of input data.  
.LP
The following attributes are used in producing venn magnitude charts.
\fBareafld\fR must be specified.

.ig >>
<br><br>
.>>

.LP
\fBareafld\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field containing an area value.
See also \fCareascale\fR below.

.ig >>
<br><br>
.>>

.LP
\fBxfld\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field containing a plottable X location in the plotting area.  Each disk will be
centered over these X locations.  If not specified, successive disks will be placed 
at X=1, X=2 ...

.ig >>
<br><br>
.>>

.LP
\fBcolorfld\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field containing a 
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
value.  If not specified the \fCcolor\fR attribute will be used.
A data field can contain \fCnone\fR which will suppress fill on the disk.

.ig >>
<br><br>
.>>

.LP
\fBcolor\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
May be specified to set all disks to this color.

.ig >>
<br><br>
.>>
.LP
\fByloc\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#plotvalue">
.>>
\0plottable Y value
.ig >>
</a>
.>>
.IP \0
Sets the Y location of the bottoms of all disks.  If not specified Y=0.5 is used.

.ig >>
<br><br>
.>>
.LP
\fBlabelfield\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field containing label text.  If this attribute is specified labels will be rendered
below each disk.  Label text can contain \fC\\n\fR to get line breaks.

.ig >>
<br><br>
.>>
.LP
\fBlabeldetails\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="textdetails.html">
.>>
\0textdetails
.ig >>
</a>
.>>
.IP \0
Font, color, size of the labels.

.ig >>
<br><br><br>
.>>

.SH General attributes 
These attributes can be used with Venn diagrams or magnitude charts.

.LP
\fBareascale\fR
.ig >>
&nbsp; &nbsp;
.>>
h
.IP \0
A scaling factor to be applied to the given area value(s),
allowing them to reflect the reality of the application.
Area value(s) will be multiplied by this scaling factor in order to derive an appropriate
disk area value in inches (or cm).

.ig >>
<br><br>
.>>

.LP
\fBdensity\fR
.ig >>
&nbsp; &nbsp;
.>>
h
.IP \0
This allows the density of the dot fill to be adjusted.  1.0 is the default.
A lower value reduces the dot density; a higher value increases dot density.
A value of 0 completely suppresses dot fill, to do outline-only disks for example.

.ig >>
<br><br>
.>>

.LP
\fBoutline\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>
\fC | no | yes | bevel\fR
.IP \0
Default is \fCyes\fR.
If \fCyes\fR or a  
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>
specification is given, disk is outlined.  
If \fCno\fR, disk is not outlined.
.br
Exmaple: \fCoutline: width=1.0\fR

.ig >>
<br><br>
.>>

.LP
\fBdotsize\fR
.ig >>
&nbsp; &nbsp;
.>>
h
.IP \0
\fIh\fR is a value in absolute units controlling the size of the fill dots (actually
tiny line segments; \fIh\fR is the length of each tiny segment).
Default is 0.008 (inches).
If you're not seeing fill dots on your output device try raising this value slightly.
You can also try 0.0 to get one-pixel dots on some (but not all) output devices.

.ig >>
<br><br>
.>>

.LP
\fBsolidfill\fR
.ig >>
&nbsp; &nbsp;
.>>
yes | no
.IP \0
If yes, disks are filled with solid color.  

.ig >>
<br><br><br>
.>>

.SH Venn magnitude chart variations
.ig >>
<center>
<a href="../gallery/vennmag2.htm">
<img src="../gallery/vennmag2.gif">
<br>
Venn magnitude chart without dot fill.  Click to see example code
</a>
<br>
<br>

<a href="../gallery/vennmag3.htm">
<img src="../gallery/vennmag3.gif">
<br>
Venn magnitude chart with solidfill.  Click to see example code
</a>
</center>

.>>

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif"> 
</center>
</td></tr>
</table>
<br>
<center>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> &nbsp; </td><td>
<a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12" 
width="120" height="30" border="0" 
alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a>
</td></tr></table>


</center>
.>>

