.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: lines prefab</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>lines prefab</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/prefabs.html">Prefabs</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

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

.ig >>
<center><a href="prefab_lines_ex.html">
<img src="../gallery/prefab_img/lines1thm.gif" border=0> &nbsp;
<img src="../gallery/prefab_img/lines3thm.gif" border=0>
 <br><b>View the lines prefab examples</a></b><br><br></center>
.>>

.LP
\fBlines\fR is a 
.ig >>
<a href="prefabs.html">
.>>
\0prefab
.ig >>
</a>
.>>
for producing line plots with optional point symbols and error bars, for up to four groups.
For the first group data points are in data fields given in \fBx\fR and \fBy\fR, and 
optional error bar value given in \fBerr\fR.
By default \fBx\fR is assumed to be continuous numeric, but it can be categories
if \fBcats\fR is specified. 
(For chronological X data, use the
.ig >>
<a href="prefab_chron.html">
.>>
\0chron prefab
.ig >>
</a>
.>>
instead.)
To display a second line, use \fBy2\fR, \fBerr2\fR, etc.
Same for third and fourth lines.

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

.SH Parameters

.ig >>

<table cellpadding=2 bgcolor=A0A0A0 width=600>

<tr bgcolor=FFFFEC align=center><td><b>Prefab<br>parameter<br>name</td><td>Data type</td>
<td>Default</td><td>Description</td>
<td>Examples<br><small>(ignore line wrapping)</td></tr>


<tr bgcolor=FFFFFF>
<td><b><a href="prefab_stdparms.html">Standard parameters</a></td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td colspan=2>Most of the <a href="prefab_stdparms.html">standard prefab parameters</a> may be used.
You <font color=D00000>must specify</font> <b>data</b> (the name of the input data file).
The clickmap parameters aren't available with this prefab.</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>x</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td><font color=D00000>must be specified</font></td>
<td><nobr>Identifies the data field that will hold</nobr> X component for all curves.</td>
<td><tt>x=2<br><br>x=pmb</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>y<br><br>y2<br>y3<br>y4</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td><b>y</b> <font color=D00000>must be specified</font></td>
<td>Identifies the data field that will hold Y component(s),
<b>y</b> for the first curve, <b>y2</b> for a second curve, and so on.</td>
<td><tt>y=3 y2=4<br><br>y=pmr</td>
</tr>



<tr bgcolor=FFFFFF>
<td><b>cats</td>
<td><tt>yes</tt> or <tt>no</td>
<td><tt>no</td>
<td>If <tt>yes</tt>, X values are understood to be alphanumeric categories, 
not continuous numeric values.</td>
<td><tt>cats=yes</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>linedet<br><br>linedet2<br>linedet3<br>linedet4</td>
<td><a href="linedetails.html">linedetails</a></td>
<td>thin lines in red, blue, green, and orange</td>
<td>Controls the line style, color, etc. for up to four curves.
If doing multiple lines, you can specify <tt>linedet2</tt> without having to specify <tt>linedet</tt> (etc), if you want.
</td>
<td><tt>"linedet= width=0.4 color=red"<br><br>"linedet2= width=0.4 color=blue"</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>pointsym<br><br>pointsym2<br>pointsym3<br>pointsym4</td>
<td><a href="symboldetails.html">symbol</a></td>
<td>outlined square, triangle, diamond, and inverted triangle</td>
<td>Controls the appearance of data points.
May be given as <tt>none</tt> for no point symbol.
If doing multiple lines, you can specify <tt>pointsym2</tt> without having to specify <tt>pointsym</tt> (etc), if you want.
</td>
<td><tt>"pointsym= shape=circle style=outline fillcolor=pink"</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>fill<br><br>fill2<br>fill3<br>fill4</td>
<td><a href="color.html">color</a></td>
<td>&nbsp;</td>
<td>If specified, the area under the plotted line to be filled with the given color.
If doing multiple lines, you can specify <tt>fill2</tt> without having to specify <tt>fill</tt> (etc), if you want.
</td>
<td><tt>fill=dullyellow</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>step</td>
<td><tt>yes</tt> or <tt>no</td>
<td><tt>no</td>
<td>Render stairstep lineplot(s).  Point symbols are turned off.  Applies to all lines.</td>
<td><tt>step=yes</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>errcolor</td>
<td><a href="color.html">color</a></td>
<td><tt>black</td>
<td>Error bar color.  Applies to all lines plotted.</td>
<td><tt>errcolor=gray(0.6)</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>errwidth</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>0.08</td>
<td>Width of error bar tails.</td>
<td><tt>errwidth=0.12</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>errthick</td>
<td><a href="linedetails.html">line thickness value</a></td>
<td>0.5</td>
<td>The thickness of the error bar lines.</td>
<td><tt>errthick=1</td>
</tr>

<tr bgcolor=FFFFEC><td colspan=5>
<h3>Additional parameters</h3> 
The following are available and are exactly the same as documented in the
<a href="lineplot.html">proc lineplot manual page</a>..  see that page for descriptions and usage.  
All are optional.
<br>
<br>

<b>gapmissing</b> &nbsp; &nbsp; gap the line on missing data
<br>
<br>
<b>numbers</b> &nbsp; &nbsp; display the plotted numbers
<br>
<br>
<b>clip</b> &nbsp; &nbsp; clip to the plotting area
<br>
<br>
<b>accum</b> &nbsp; &nbsp; summate values from left to right
</td></tr>

</table>
.>>

.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>
.>>
