3.1 Instantiation of a Gist Plotter Object

Calling Sequence

import Gist

pl1 = Gist.Plotter ( [<display>] [, <keylist>] )

Description

All arguments to the instantiator are optional. All arguments except the first must be given as keyword arguments. Even the first may be given as a keyword argument, using either filename or display as the keyword. The <display> argument tells where (i. e., on what device) you wish the PyGist Xwindow to appear. It should be given in standard IP format, as a quoted character string, e. g. "allaria.llnl.gov:0.0" or "128.112.45.118:0.0". If you omit this argument, or supply a " " (blank), then PyGist will attempt to read your DISPLAY environment variable, and if it has a value, will open a window where it specifies. If your DISPLAY variable is not defined, PyGist gives up in despair. If you wish to write only to a file and not have a display Xwindow, you may set this keyword to "", "none", or None.

The Plotter instantiator accepts the following keywords:

n, dpi, wait, private, hcp, dump, legends, style

Keyword Arguments

The following keywords are allowed:

n (default 0): the number of the graphics window (0 to 7 are allowed). each plotter object corresponds to a separate window.

dpi (default 100 for 2-D, 75 for 3-D):the size of the window wanted. 100 and 75 are allowed; 100 is the larger size.

wait (1): used to make sure everything is plotted before changing frames.

private (0): use a common colormap.

hcp: if not present, use default hardcopy file used by all windows. If present, names a file unique to this window. Use ".ps" suffix for a postscript file or ".cgm" suffix for a cgm file.

dump (0): if 1, dumps the color palette at the beginning of each page of hardcopy output, otherwise converts to grey scale.

legends (0): controls whether (1) or not (0) curve legends are dumped to the hardcopy.

style ("work.gs"): name of a Gist style sheet to use for this window.