input data formats


Welcome     Gallery     Handbook


Manual page for input_data_formats(PL)

DESCRIPTION

Plotting is driven by data. The plot data may be specified within a ploticus script, or it may be contained in a file, or be the result of executing a shell command. proc getdata is used to specify or read in plotting data.

Ploticus uses field-oriented data. Most plotting is done based on fields. For example, a bargraph can be rendered based upon the values in field #2 of each row of data. A set of data should contain one or more rows (lines).

Fields may be delimited in one of three ways. The delimitation must be specified in proc getdata. The three ways are:

  • white-space (any combination of spaces or tabs)
  • comma (often called spreadsheet or .csv)
  • tab

Fields may be surrounded by "double quotes"; this must be done when a field contains embedded delimiter characters.

The number of fields should be consistent across records.

A comment character (specified as a proc getdata attribute) may be given as the first character on a line; it causes that line to be ignored.

Beginning in version 1.40 it is possible to set ploticus variables from within a data file using the construct: #set VARIABLE = value.

EXAMPLES

Gallery examples include:
scat7.dat (white-space delimited)
stock.csv (comma delimited)
timeline3 (data specified within script)
km2 (data specified within script).

DETAILS

The plotting procedures generally access specific fields and process the data from top to bottom. For example, a bar graph might be made by drawing one bar for each data record based on the value in field 2.

Proc getdata is used to read in a data file for plotting. After proc getdata has been executed, the plotting procedures can access the data by record and field.


HANDLING MISSING DATA

Ploticus can handle missing plot data values. In data sets that are to be plotted, missing items should be denoted by a value that is not plottable, e.g. for numeric data, a value that is non-numeric. The plotting procedures omit non-plottable values (the details of how this is handled are given in the man page for each plotting proc). An Gallery example involving missing numeric data represented by dashes(-) is volunteers


data display engine  
Copyright Steve Grubb




data display engine  
Copyright Steve Grubb


Markup created by unroff 1.0,    August 30, 2001.