Ploticus > Scripts >
proc catlines

proc catlines displays individual plots, one per category in X. Useful in comparing various entities, each of which have a displayable characteristics curve. Typically line plots are rendered, but column bars are also possible. Error bars and data point symbols are optional. New in 2.40

Plot data set must be ordered on category then subcategory.

Categories must be set up in X (based on catfield, see below), and a numeric axis in Y.


catfield, subcatfield, valfield, and subcats attributes must all be specified.

plotmode     lines | bars | symonly

    Controls the type of plot rendered for each category. Default is lines which gives lineplots. If bars is specified bar graphs will be rendered instead (and see the column bar options below). If symonly is specified no line plot or bar graph will be generated, and you must specify dpsymbol (see below) to plot data points only. bars and symonly are new in 2.41

catfield     dfield

    A data field that contains primary category tags. This is the same data field that plot area X axis categories should be based on. There will be one curve drawn for each primary category.

subcatfield     dfield

    A data field that contains secondary category tags. Secondary categories determine plot position within a given curve. Specify the set of allowable secondary categories in the subcats attribute.

valfield     dfield

    A data field that contains the numeric plottable value.

subcats     list | auto

    A comma-delmited or space-delimited list of allowable subcats, or else auto which causes the data set to be scanned to determine the list of allowable subcats at some performance penalty. The order found here determines the left-to-right plotting position.
    Example: subcats: A B C
    Example: subcats: auto

errfield     dfield

    A data field that contains a numeric error bar value. Optional.. if omitted no error bars will be drawn. For example if valfield contains means, this field might contain SEM or SD.

plotwidth     h

    Controls the width of the plot region within the category space and allows for separating margins on each side. Usable range of h is 0.2 to 0.8 or so. For lineplots default is 0.6 ; for bars the default is set based on number of subcategories.

select     select expression

    Allows data rows to be selected for inclusion using a selection expression.
    Example: @@2 = B

Lineplot options

linedetails     linedetails

    Color, line width, dash style for lineplot curves.

gapmissing     yes | no

    Default is yes. If no, data points that are missing in any curve will be bridged. If yes, missing data points cause the curve to be interrupted.

Column bar options

You must specify plotmode: bars in order to use these options. New in 2.41

barcolor     color

    Specify this attribute if you want all bars in a group to be this color. Default is green.

barcolorlist     list of color

    Specify this attribute if you want bars in a group to have different colors. A comma- or space-delimited list of colors.
    Example: barcolorlist: green,red,blue

barlinewidth     linewidth

    Linewidth of bars. Default is 2.0 ; use higher numbers for thicker bars, lower numbers for thinner bars.

crossover     h

    If specified, values less than h will result in downward bars. Typically specified as 0 so that negative values give downward bars.

Data point options

Data point symbols can be rendered with lineplots (plotmode: lines) or alone (plotmode: symonly).

dpsymbol     symboldetails

    Default is for small light-gray data point symbols to be rendered (specifically, style=filled color=gray(0.7) shape=circle radius=0.02). Specify another symboldetails for a different data point symbol. Specify none to omit data points.

altsymbol     symboldetails

    If specified, defines an alternate symbol to be drawn when altwhen condition is true.

altwhen select expression

    A conditional expression that, if true, causes the altsymbol to be drawn instead of the dpsymbol.

Error bar options

Error bars will be rendered if errfield is specified (see above).

errbardetails     linedetails

    Color and line width for error bars.

taillen     h

    Size of error bar tails in inches (cm). Default is 0.04 inches.


Ploticus 2.42 ... May 2013 Terms of use /