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