1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
|
.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: ploticus scripts handbook</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>Ploticus Scripts Handbook</h2></td>
<td align=right>
<small>
<a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
Version 2.33 Jun'06
</small><br><a href="../doc/scripthome.html">Scripts</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>
.TH Ploticus_Scripts_Handbook PL "02-JUN-2006 PL ploticus.sourceforge.net"
.ig >>
<center>
<table cellpadding=5 border=1><tr bgcolor=FFFFEC><td align=center>
<FORM ACTION="http://search.freefind.com/find.html" METHOD="GET" target="_self">
Search the ploticus web site:
<INPUT TYPE="HIDDEN" NAME="id" VALUE="80868605">
<INPUT TYPE="HIDDEN" NAME="pid" VALUE="r">
<INPUT TYPE="HIDDEN" NAME="mode" VALUE="ALL">
<INPUT type="HIDDEN" name="n" value="0">
<INPUT TYPE="TEXT" NAME="query" SIZE="20">
<INPUT TYPE="SUBMIT" VALUE=" Go ">
<br>
<small>(Powered by <A HREF="http://www.freefind.com">FreeFind</A>)</small>
</FORM>
</td></tr></table>
</center>
<br>
<ul>
<br><br>
<b><a href="pl.1.html">The pl(1) command</a></b> produces plots from scripts, eg: <tt>pl -png scat1.pl</tt>
<br><br>
<b><a href="../gallery">Gallery of script examples</a></b> <br><br>
<b><a href="news.html">What's new</a></b><br><br>
<br>
<h3>Quick start</h3>
<ul>
1. <a href="download.html">Download the software</a>, and install.
<br>
2. Write your script using your favorite text editor (peruse the script examples gallery to find examples)
<br>
3. Execute the pl command (<tt>pl <i>scriptfile</i></tt>)
</ul>
<br>
<br>
<h3>Writing scripts</h3>
<ul>
<a href="scripts.html">Introduction to scripts</a><br>
<a href="scriptsyntax.html">Script syntax</a><br>
<a href="scriptsyntax.html#procs">Specifying procedures and attributes</a><br>
<a href="variables.html">Variables</a><br>
<a href="scriptsyntax.html#directives">Directives</a> <tt>
<a href="scriptsyntax.html#proc">#proc</a>
<a href="scriptsyntax.html#endproc">#endproc</a>
<a href="scriptsyntax.html#procdef">#procdef</a>
<a href="scriptsyntax.html#saveas">#saveas</a>
<a href="scriptsyntax.html#clone">#clone</a>
<br>
<a href="scriptsyntax.html#set">#set</a>
<a href="scriptsyntax.html#setifnotgiven">#setifnotgiven</a>
<a href="scriptsyntax.html#call">#call</a>
<a href="scriptsyntax.html#if">#if</a>
<a href="scriptsyntax.html#ifspec">#ifspec</a>
<br>
<a href="scriptsyntax.html#for">#for</a>
<a href="scriptsyntax.html#while">#while</a>
<a href="scriptsyntax.html#loop">#loop</a>
<a href="scriptsyntax.html#break">#break</a>
<a href="scriptsyntax.html#continue">#continue</a>
<br>
<a href="scriptsyntax.html#exit">#exit</a>
<a href="scriptsyntax.html#include">#include</a>
<a href="scriptsyntax.html#cat">#cat</a>
<a href="scriptsyntax.html#return">#return</a>
<br>
<a href="scriptsyntax.html#write">#write</a>
<a href="scriptsyntax.html#shell">#shell</a>
<a href="scriptsyntax.html#sql">#sql</a>
</tt>
<br>
<a href="variables.html#system">System variables</a>
</ul>
<br>
<br>
<h3>Plotting procs</h3>
<ul>
<a href="annotate.html">proc annotate</a> - add annotation<br>
<a href="areadef.html">proc areadef</a> - define a plotting area<br>
<a href="autorange.html">notes on automatic scaling</a><br>
<a href="axis.html"> proc axis (xaxis/yaxis)</a> - render an axis<br>
<a href="bars.html">proc bars</a> - bar graphs, histograms, error bars, floating bars, timelines<br>
<a href="categories.html">proc categories</a> - define a set of categories for an axis<br>
<a href="curvefit.html">proc curvefit</a> - generate a curve from data points<br>
<a href="drawcommands.html">proc drawcommands</a> - draw using command set<br>
<a href="getdata.html">proc getdata</a> - get or specify plot data<br>
<a href="legend.html">proc legend</a> - render a legend<br>
<a href="line.html">proc line</a> - draw arbitrary lines<br>
<a href="lineplot.html">proc lineplot</a> - produce a line plot<br>
<a href="page.html">proc page</a> - set page-wide attributes/ break page<br>
<a href="pie.html">proc pie</a> - produce a pie graph<br>
<a href="rangebar.html">proc rangebar</a> - produce a rangebar / boxplot<br>
<a href="rangesweep.html">proc rangesweep</a> - produce a range sweep<br>
<a href="rect.html">proc rect</a> - draw an arbitrary rectangle <br>
<a href="scatterplot.html">proc scatterplot</a> - produce a scatterplot or grid or data point display<br>
<a href="settings.html">proc settings</a> - <b>overall settings</b> for units, notations, etc<br>
<a href="vector.html">proc vector</a> - vector plots<br>
<a href="venndisk.html">proc venndisk</a> - venn diagrams <img src="../gallery/gif/new.gif"><br>
</ul>
<br>
<br>
<h3>Utility procs</h3>
<ul>
<a href="breakaxis.html">proc breakaxis</a> - break an axis or bar, to display extreme values<br>
<a href="defineunits.html">proc defineunits</a> - explicitly define scaling units<br>
<a href="import.html">proc import</a> - import an external PNG image file<br>
<a href="legendentry.html">proc legendentry</a> - define a legend entry explicitly<br>
<a href="print.html">proc print</a> - show outliers, contents of variables, etc. (deprecated)<br>
<a href="processdata.html">proc processdata</a> - internal processing of data:
<br> - accumulate
<br> - break processing
<br> - count/summate on instances
<br> - joins
<br> - row numbering
<br> - compute percents
<br> - reverse row order
<br> - rotation of row/column matrix
<br> - find mean, sd, min, max
<br> - compute totals
<br>
<a href="tabulate.html">proc tabulate</a> - perform tabulations & frequency distributions<br>
<a href="trailer.html">proc trailer</a> - specify data at end of script<br>
<a href="usedata.html">proc usedata</a> - set the current data set for plotting<br>
</ul>
<br>
<br>
<h3>Functions</h3>
<ul>
<a href="functions.html">Introduction</a><br>
<a href="functions.html">plotting functions</a> <br>
<a href="functions.html#arithmetic">arithmetic functions</a> <br>
<a href="functions.html#strings">string functions</a> <br>
<a href="functions.html#commalists">list handling functions</a> <br>
<a href="functions.html#dates">date functions</a> <br>
<a href="functions.html#times">time functions</a><br>
<a href="functions.html#misc">misc functions</a><br>
</ul>
<br>
<br>
<br>
<br>
<h3>Reference</h3>
<ul>
<br><a href="dataformat.html">Input data for plotting</a>
<br><a href="scaleunits.html">Data types and scaling: numeric, category, date, time</a>
<br><a href="attributetypes.html">Absolute units, scaled units, etc.</a>
<br><a href="attributetypes.html#n">Attribute types: dfield, plotvalue, locvalue, printf, string, text, multilinetext</a>
<br><a href="linedetails.html">Linedetails</a>
<br><a href="symboldetails.html">Symboldetails</a>
<br><a href="textdetails.html">Textdetails</a>
<br><a href="select.html">Select expressions</a>
<br><a href="color.html">Colors</a>
<br><a href="fonts.html">Fonts</a>
<br><a href="dates.html">Dates</a>
<br><a href="times.html">Times</a>
<br><a href="config.html">Your ploticus config file - settings to be in effect all the time</a>
<br>
<br><a href="news.html">What's new - general</a>
<br><a href="prefab_news.html">What's new - prefabs</a>
<br><a href="faq.html">FAQ</a>
<br><a href="http://groups.yahoo.com/group/ploticus">Newsgroup</a>
<br><a href="pl.1.html">pl(1) man page</a>
<br><a href="api.html">libploticus API</a>
<br><a href="web.html">Web usage notes</a>
<br><a href="clickmap.html">Imagemap, clickmap & mouseover text bubbles</a>
<br><a href="dynamic.html">Dynamic content and just-in-time usage notes</a>
<br><a href="cgi.html">Direct CGI mode</a>
<br><a href="paper.html">Paper-based report usage notes</a>
<br><a href="posters.html">Large-sized poster usage notes</a>
<br><a href="prepress.html">Pre-press work usage notes</a>
<br><a href="svg.html">SVG notes</a>
<br><a href="swf.html">SWF (shockwave-flash) notes</a>
<br><a href="http://ploticus.sourceforge.net/doc/download.html">Download</a>
<br><a href="buildinfo.html">Build instructions</a>
<br><a href="support.html">Troubleshooting & support</a>
<br><a href="limits.html">Limitations</a>
<br><a href="Copyright.html">Copyright and permissions <img src="../doc/gpl.gif" border=0></a>
<br><a href="http://ploticus.sourceforge.net/steve.html">Steve Grubb's home page</a>
</ul>
<br>
<br>
<h3><a href="welcome.html">Back to ploticus home</a></h3>
<h3><a href="prefabs.html">Ploticus prefabs handbook</a></h3>
</ul>
.>>
.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 <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
.>>
|
