Back to library index.
Package graph-plotkey (in graph.i) - keywords for plotting functions
Index of documented functions or symbols:
SEE: rspace
SEE: rspace
SEE: hollow
DOCUMENT closed= plotting keyword
or smooth= plotting keyword
selects closed curves (closed=1) or default open curves (closed=0),
or Bezier smoothing (smooth>0) or default piecewise linear curves
(smooth=0). The value of smooth can be 1, 2, 3, or 4 to get
successively more smoothing. Only the Bezier control points are
plotted to an X window; the actual Bezier curves will show up in
PostScript hardcopy files. Closed curves join correctly, which
becomes more noticeable for wide lines; non-solid closed curves
may look bad because the dashing pattern may be incommensurate
with the length of the curve.
PLOTTING COMMANDS: plg, plc (smooth only)
DOCUMENT color= plotting keyword selects line or text color. Valid values are the strings "bg", "fg", "black", "white", "red", "green", "blue", "cyan", "magenta", "yellow", or a 0-origin index into the current palette. The default is "fg". Negative numbers may be used instead of the strings: -1 is bg (background), -2 is fg (foreground), -3 is black, -4 is white, -5 is red, -6 is green, -7 is blue, -8 is cyan, -9 is magenta, and -10 is yellow. (The negative numbers are actually taken modulo 256, so -1 is also 255, -2 is 254, and so on.) A color can also be a triple [r, g, b], with values running from 0 for dark to 255 for full intensity. Beware, however, of specifying an rgb color (either as a color keyword or to the plf, pli, or plfp commands) if your display is not a true color display (for example, if it is 8 bits deep or less). In that case, it may switch to a 5x9x5 color cube, which causes a significant degradation in quality of rendering with smooth color palettes. Furthermore, the hcp command will not work properly for rgb colors if the file is a CGM. Use the rgb=1 keyword in the window command to avoid having to re-issue a palette command after the first rgb object is drawn (this is unnecessary on true color screens). PLOTTING COMMANDS: plg, plm, plc, pldj, plt
SEE ALSO: type, width, marks, marker, mcolor, rays, closed, smooth
SEE: edges
DOCUMENT edges= plotting keyword
or ecolor= plotting keyword
or ewidth= plotting keyword
set the appearance of zone edges in a filled mesh plot (plf or plfp).
By default, edges=0, and the zone edges are not plotted. If
edges=1, a solid line is drawn around each zone after it is
filled; the edge color and width are given by ecolor and ewidth,
which are "fg" and 1.0 by default.
PLOTTING COMMANDS: plf
SEE: edges
DOCUMENT font= plotting keyword
or height= plotting keyword
or opaque= plotting keyword
or orient= plotting keyword
or justify= plotting keyword
selects text properties. The font can be any of the strings
"courier", "times", "helvetica" (the default), "symbol", or
"schoolbook". Append "B" for boldface and "I" for italic, so
"courierB" is boldface Courier, "timesI" is Times italic, and
"helveticaBI" is bold italic (oblique) Helvetica. Your X server
should have the Adobe fonts (available free from the MIT X
distribution tapes) for all these fonts, preferably at both 75
and 100 dpi. Occasionally, a PostScript printer will not be
equipped for some fonts; often New Century Schoolbook is missing.
The font keyword may also be an integer: 0 is Courier, 4 is Times,
8 is Helvetica, 12 is Symbol, 16 is New Century Schoolbook, and
you add 1 to get boldface and/or 2 to get italic (or oblique).
The height is the font size in points; 14.0 is the default.
X windows only has 8, 10, 12, 14, 18, and 24 point fonts, so
don't stray from these sizes if you want what you see on the
screen to be a reasonably close match to what will be printed.
By default, opaque=0 and text is transparent. Set opaque=1 to
white-out a box before drawing the text. The default orient
(orient=0) is left-to-right text; set orient=1 for text rotated 90
degrees so it reads upward, orient=2 for 180 degree rotation so
it is upside down, and orient=3 for 270 degree rotation so it
reads downward.
The default text justification, justify="NN" is normal is both
the horizontal and vertical directions. Other possibilities
are "L", "C", or "R" for the first character, meaning left,
center, and right horizontal justification, and "T", "C", "H",
"A", or "B", meaning top, capline, half, baseline, and bottom
vertical justification. The normal justification "NN" is equivalent
to "LA". Common values are "LA", "CA", and "RA" for garden variety
left, center, and right justified text, with the y coordinate at the
baseline of the last line in the string presented to plt. The
characters labeling the right axis of a plot are "RH", so that the
y value of the text will match the y value of the corresponding
tick. Similarly, the characters labeling the bottom axis of a plot
are "CT". The justify= may also be a number, horizontal+vertical,
where horizontal is 0 for "N", 1 for "L", 2 for "C", or 3 for "R",
and vertical is 0 for "N", 4 for "T", 8 for "C", 12 for "H",
16 for "A", or 20 for "B".
PLOTTING COMMANDS: plt
SEE ALSO: color
SEE: font
DOCUMENT hide= plotting keyword sets the visibility of a plotted element. The default is hide=0, which means that the element will be visible. Use hide=1 to remove the element from the plot (but not from the display list). PLOTTING COMMANDS: plg, plm, plc, plv, plf, pli, plt, pldj
SEE ALSO: legend
DOCUMENT hollow= plotting keyword
or aspect= plotting keyword
set the appearance of the "darts" of a vector field plot. The
default darts, hollow=0, are filled; use hollow=1 to get just the
dart outlines. The default is aspect=0.125; aspect is the ratio
of the half-width to the length of the darts. Use the color
keyword to control the color of the darts.
PLOTTING COMMANDS: plv
SEE ALSO: color
SEE: font
DOCUMENT legend= plotting keyword sets the legend for a plot. The default legend is a concatentation of the strings used in the original plotting command (plg, plm, etc.), except for the plt command, which has no default legend. Legends are never plotted to the X window; use the plq command to see them interactively. Legends will appear in hardcopy output unless they have been explicitly turned off. PLOTTING COMMANDS: plg, plm, plc, plv, plf, pli, plt, pldj
SEE ALSO: hide
DOCUMENT marker= plotting keyword selects the character used for occasional markers along a polyline, or for the polymarker if type is "none". The special values '\1', '\2', '\3', '\4', and '\5' stand for point, plus, asterisk, circle, and cross, which are prettier than text characters on output to some devices. The default marker is the next available capital letter, 'A', 'B', ..., 'Z'. PLOTTING COMMANDS: plg, plc
SEE ALSO: type, width, color, marks, rays, mspace, mphase, msize, mcolor
DOCUMENT marks= plotting keyword selects unadorned lines (marks=0), or lines with occasional markers (marks=1). Ignored if type is "none" (indicating polymarkers instead of occasional markers). The spacing and phase of the occasional markers can be altered using the mspace and mphase keywords; the character used to make the mark can be altered using the marker keyword. PLOTTING COMMANDS: plg, plc
SEE ALSO: type, width, color, marker, rays, mspace, mphase, msize, mcolor
SEE: mspace
SEE: mspace
SEE: mspace
DOCUMENT mspace= plotting keyword
or mphase= plotting keyword
or msize= plotting keyword
or mcolor= plotting keyword
selects the spacing, phase, and size of occasional markers placed
along polylines. The msize also selects polymarker size if type
is "none". The spacing and phase are in NDC units (0.0013 NDC
equals 1.0 point); the default mspace is 0.16, and the default
mphase is 0.14, but mphase is automatically incremented for
successive curves on a single plot. The msize is in relative
units, with the default msize of 1.0 representing 10 points.
The mcolor keyword is the same as the color keyword, but controls
the marker color instead of the line color. Setting the color
automatically sets the mcolor to the same value, so you only
need to use mcolor if you want the markers for a curve to be a
different color than the curve itself.
PLOTTING COMMANDS: plg, plc
SEE: font
SEE: font
DOCUMENT rays= plotting keyword selects unadorned lines (rays=0), or lines with occasional ray arrows (rays=1). Ignored if type is "none". The spacing and phase of the occasional arrows can be altered using the rspace and rphase keywords; the shape of the arrowhead can be modified using the arroww and arrowl keywords. PLOTTING COMMANDS: plg, plc
SEE ALSO: type, width, color, marker, marks, rspace, rphase, arroww, arrowl
DOCUMENT region= plotting keyword selects the part of mesh to consider. The region should match one of the numbers in the IREG array. Putting region=0 (the default) means to plot the entire mesh, that is, everything EXCEPT region zero (non-existent zones). Any other number means to plot only the specified region number; region=3 would plot region 3 only. PLOTTING COMMANDS: plm, plc, plv, plf
SEE: rspace
DOCUMENT rspace= plotting keyword
or rphase= plotting keyword
or arroww= plotting keyword
or arrowl= plotting keyword
selects the spacing, phase, and size of occasional ray arrows
placed along polylines. The spacing and phase are in NDC units
(0.0013 NDC equals 1.0 point); the default rspace is 0.13, and
the default rphase is 0.11375, but rphase is automatically
incremented for successive curves on a single plot.
The arrowhead width, arroww, and arrowhead length, arrowl are
in relative units, defaulting to 1.0, which translates to an
arrowhead 10 points long and 4 points in half-width.
PLOTTING COMMANDS: plg
SEE: closed
DOCUMENT triangle= plotting keyword sets the triangulation array for a contour plot. The triangulation array must be the same shape as the IREG (region number) array, and the correspondence between mesh zones and indices is the same as for IREG. The triangulation array is used to resolve the ambiguity in saddle zones, in which the function Z being contoured has two diagonally opposite corners high, and the other two corners low. The triangulation array element for a zone is 0 if the algorithm is to choose a triangulation, based on the curvature of the first contour to enter the zone. If zone (i,j) is to be triangulated from point (i-1,j-1) to point (i,j), then TRIANGLE(i,j)=1, while if it is to be triangulated from (i-1,j) to (i,j-1), then TRIANGLE(i,j)=-1. Contours will never cross this "triangulation line". You should rarely need to fiddle with the traingulation array; it is a hedge for dealing with pathological cases. PLOTTING COMMANDS: plc
DOCUMENT type= plotting keyword selects line type. Valid values are the strings "solid", "dash", "dot", "dashdot", "dashdotdot", and "none". The "none" value causes the line to be plotted as a polymarker. You should also check the plmk function if you need polymarkers. The type value may also be a number; 0 is "none", 1 is "solid", 2 is "dash", 3 is "dot", 4 is "dashdot", and 5 is "dashdotdot". PLOTTING COMMANDS: plg, plm, plc, pldj
SEE ALSO: width, color, marks, marker, rays, closed, smooth, plmk
