ENVISION commands


PROGRAM NAME

putplot2 - Non-Interactive 2D Plot Display

DESCRIPTION

Putplot2 is a visualization program that displays data as a 2D plot. There are many parameters which control how the plot is displayed. For example, an axis may be displayed and the plot type, line type, marker type, and plot color can also be specified.

It is possible to display a 2D axis with 2D plots using the [-axis2d] argument. By default, 2D plots are displayed without axes.

When displaying a 2D plot, the plot type can be specified using the [-ptype2d] argument. There are six valid plot types which are as follows:

"" 1 - Line
2 - Discrete
3 - Bar Graph
4 - Poly Marker
5 - Line Marker

A line type can also be specified when displaying 2D plots using the [-ltype2d] argument. There are seven valid line types which are as follows:

"" 1 - Solid
2 - Dotted
3 - Dot Dash
4 - Short Dash
5 - Long Dash
6 - Odd Dashed
7 - Grid Dotted

A marker type can be specified when displaying 2D plots using the [-mtype2d] argument. Note that marker type only has an effect when plot type is set to Poly Marker or Line Marker. There are sixteen valid marker types which are as follows:

"" 1 - Arc
2 - Bow Tie
3 - Box
4 - Caret
5 - Circle
6 - Cross
7 - Dagger
8 - Diamond
9 - Dot
10 - Hexagon
11 - Point
12 - Square
13 - Triangle
14 - V
15 - X
16 - Pixel

A plot foreground color can be specified when displaying 2D plots using the [-pcolor2d] argument. Note that the plot color is not used with plot types that are automatically colored such as color marker and color line. The plot color can be any valid color supported on your display. For a list of available colors, run the command % xcolors.

By default, the visualization display will share its colormap with all other applications running at the same time; that is, it does not not use a "private colormap", but rather makes use of the "default colormap". It is possible to specify that the visualization display allocate its own private colormap or "grab" all available colors for its own use. This is done using the [-priv] argument. When [-priv] is specified, moving the mouse pointer into the display window will cause the display to have its private colormap installed; moving the pointer out of the display window will cause the private colormap to be de-installed. This results in the technoflashing phenomenon characteristic of private colormap installation.

Color allocation can also be controlled and set to either "read-only" or "read/write" using the [-alloc] argument. When set to "read only", once a color cell has been allocated, it can have its color set only once; from then on, the color cell can be shared by multiple applications, but not changed. If the visualization display requires the color displayed to change, it must re-allocate the color cell, forcing a re-display of data. This can be an expensive procedure. In contrast, after a "read/write" color cell is allocated, it can have its color changed at any time without re-allocation; the data being displayed does not need to be redisplayed, and the color update process is much more efficient. However, the colors used in the visualization display cannot be shared by other applications.

The input file containing the data to be plotted is monitored by default; the file is checked every 2 seconds for change, and if it has been modified, the plot is updated accordingly. The interval at which the input file is checked for modification may be specified using the [-update] argument.

On creation, the plot display window may be placed manually (the default method), or placed automatically. For automatic placement of the plot window, specify the desired location in device (screen) coordinates using the [-x] and [-y] arguments.

While the display window should be created with a default size that is appropriate to plot the data, a width and height for the window can be specified explicitly using the [-width] and [-height] arguments, where values represent number of pixels. Alternatively, you may allow the plot window to size itself initially, and then use the window manager to interactively modify its size as desired.

REQUIRED ARGUMENTS

-i
type: infile
desc: File containing 2D plot

OPTIONAL ARGUMENTS

-axis2d
type: boolean
desc: Display 2D axes with 2D plot
default: true
-ptype2d
type: list
desc: Specifies the plot type for 2D plots
default: 1 "Line"
-ltype2d
type: list
desc: Specifies the line type for 2D plots
default: 1 "Solid"
-mtype2d
type: list
desc: Specifies the marker type for 2D plots
default: 12 "Square"
-pcolor2d
type: string
desc: Specifies the plot color for 2D plots
default: Red
-priv
type: boolean
desc: Use private colormap
default: false
-alloc
type: cycle
desc: Color allocation policy
default: 1 "Read Only"
-x
type: integer
desc: X location for GUI autoplacement
default: -1
bounds: -1 < [-x] < 1000
-width
type: integer
desc: Window width
default: 512
bounds: -1 < [-width] < 1000
-y
type: integer
desc: Y location for GUI autoplacement
default: -1
bounds: -1 < [-y] < 1000
-height
type: integer
desc: Window height
default: 512
bounds: -1 < [-height] < 1000
-update
type: float
desc: How often to check input file for modification
default: 2
bounds: value >= 0.0

EXAMPLES

% putplot2 -i plot2d:sine

SEE ALSO

putdata(1), putplot3(1)

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.