Manual page for Standard_prefab_parameters(PL)

Google




Standard prefab parameters


Welcome     Gallery     Handbook


The following parameters are accepted by all prefabs unless otherwise stated. The data parameter is always required.

data

Name of data file. Always required. May be given as - if data are to be read from standard input.

x

Data field to plot in X. Either a number (eg 2 for the 2nd field) or a name if data file contains a field name header and header=yes is specified.

y

Data field to plot in Y. Either a number (eg 2 for the 2nd field) or a name if data file contains a field name header and header=yes is specified.

err

Data field for plotting vertical error bar around ( x, y ). If not specified no error bars will be drawn. Either a number (eg 2 for the 2nd field) or a name if a data file contains a header.

title

A plot title to be centered at the top, for example: title="My first plot"
The parameter titledet is also available for controlling details of title placement and appearance.

rectangle

Four numbers (x1 y1 x2 y2) specifying a plot area rectangle in inches from lower-left. x1 and y1 are the coordinates of the lower-left corner of the rectangle, and x2 and y2 are the coordinates of the upper-right corner.
Example: rectangle="1 1 3 1.8"

xlbl

Label for X axis, for example: xlbl="Date of receipt"
The parameter xlbldet is also available for controlling details of X label placement and appearance. For example, to adjust the label downward 8/10 inch: -xlbldet=adjust=0,-0.8.

xrange

Range for numeric X axis. This is two values, a min and a max. Example: "xrange=0 100" . xrange causes automatic scaling in X to be disabled.

xinc

Increment amount for numeric X axis. Normally this is one value. It is also possible to supply two values, in which case the second will be taken as the units. For example: "yinc=100 1000" will put a stub every 100,000, and the stubs will be in thousands (see proc axis stubs documentation for more info.)

xlog

Logarithmic X axis. Allowable values are log and log+1.

xgrid

If yes, vertical grid lines will be drawn at each X stub. May also be specified as a linedetails attribute.

ylbl

Label for Y axis, for example: ylbl="Temperature [C]"
The parameter ylbldet is also available for controlling details of Y label placement and appearance. For example, to adjust the label leftward 8/10 inch: -ylbldet=adjust=-0.8,0.

yrange

Range for numeric Y axis. This is two values, a min and a max, for example: "yrange=0 100" For prefabs where it is appropriate, yrange may also be given as yrange=0 which fixes the min at 0 but allows the max to be automatically determined from the data. When two values are given, yrange causes all automatic scaling in Y to be disabled.

yinc

Increment amount for numeric Y axis. Normally this is one value. It is also possible to supply two values, in which case the second will be taken as the units. For example: "yinc=100 1000" will put a stub every 100,000, and the stubs will be in thousands (see proc axis stubs documentation for more info.)

ylog

Logarithmic Y axis. Allowable values are log and log+1.

ygrid

If yes, horizontal grid lines will be drawn at each Y stub. May also be specified as a linedetails attribute.

autow

If yes, width of plotting area will be automatically determined by the data.

stubvert

If yes, X axis stubs will be rendered vertically.

delim

Data file field delimitation method, either space, comma, or tab. space is the default, and indicates that fields will be delimited on "white space". See data formats for more information.

header

yes if first non-comment line of data file contains field names. These names may be used to reference the data fields. Default is no.

comment

Indicates data file comment character or symbol. Default is //.

select

A conditional expression for selecting data records to include. One at-sign should be used, not two. Example: select="@1 = A"

clickmapurl

A template for generating URLs when an HTML clickmap is being generated. The -map command line option must be used in order to turn on clickmap generation. Bars (including those done using vbars , chron and dist ), scatterplot points ( scat ), and pie slice labels may be mapped. See the clickmap page for more information. (Note: with the dist prefab , the label is in data field 1 and the count in field 2.)

include1

Specifies a file containing ploticus script code. The code is included after the plotting area has been set up but before the data display is drawn. May be useful in adding baselines, etc.

include2

Specifies a file containing ploticus script code. The code is included after the data display is drawn. May be useful for adding annotation.


data display engine  
Copyright Steve Grubb


Markup created by unroff 1.0,    December 10, 2002.