NAME

grafplot -- Plot all components downstream from a given component.

USAGE

grafplot grftable compname

DESCRIPTION

This task plots all component names in a graph that are downstream from a specified component, called the root component. A component is considered to be "downstream" from the root component if a path passes through both components and the root component occurs first in the path. The "root" component is considered to be downstream from itself, so at least one component name is always plotted. Because any given graphics device has a limited resolution, there is an upper limit to the number of components that can be plotted. This limit varies according to the size of the portion of the instrument graph being plotted. If the device limit is exceeded, this task will terminate with an error message and nothing will be plotted. The user can then run graflist to view that portion of the instrument graph and can select a new root component.

PARAMETERS

grftable = "mtab$*.tmg" [file name]

The name of the graph table to be plotted. If a filename template is specified, the task will plot from the most recent graph table matching the template.

compname [string]

Name of the root component at which to start plotting. All components that are downstream from compname will be plotted. This parameter is not case sensitive and leading and trailing space do not affect the match. If more than one component matches compname, the component having the smallest value in the INNODE column will be used. Optionally, the match can be made unique by specifying an INNODE number as part of the compname string. The INNODE number follows the component name, separated by white space. If compname is null or consists only of white space, the entire graph will be plotted.

(title = "") [string]

The title printed at the bottom of the plot.

(device = "stgraph") [string]

The name of the graphics output device.

EXAMPLES

Plot components downstream from hrs_echa:

  sy> grafplot hstgraph.tab hrs_echa

BUGS

The task has problems when plotting more than a small section of the HST graph.

REFERENCES

Written by B.Simon

SEE ALSO

graflist, grafpath