next up previous contents
Next: 3D Data Up: Commands currently recognized Previous: The Input Data

General Plotting Commands

PLOTMODE - how data points are to be plotted, must be followed by either: BARS, BARS2, BOXES, FILLEDBOXES, CROSSES, DIAMONDS, ELLIPSES, LINES, HISTOGRAM, FILLED-HISTOGRAM, FILL, BAR-GRAPH, STACKED-BAR, PILLAR, SPLINE, DASHEDLINES, SYMBOL, NICE-SYMBOL or NODATA,. These specify either error bars (the default), errors bars with horizontal bars at the top and bottom of the vertical bar rather than at the middle, error boxes, error crosses, error diamonds, error ellipses, connect points with lines, plot using a histogram, connect points with dashed lines. SYMBOL plots the requested symbol very nearly centered on the data points (centering in the ``Y" direction is not yet guaranteed). SYMBOL also requires the character string which is to be plotted as an argument. NICE-SYMBOL plots symbols such as filled boxes, open circles etc. precisely centered on the data value. Argument is the type of symbol to draw (star, box, cross, circle, filled-circle, or filled-box). NODATA means that the no plotting of the data is done. Useful if you just want to plot the axes.
SYMBOLSIZE changes the size of symbols plotted with the ``NICE-SYMBOL'' option of PLOTMODE.
SPLINE - plots a cubic spline fit to your data. (Same effect as using the SPLINE option for PLOTMODE).
TITLE - overwrites the graph title to be used. Must be followed by: graph title
XLABEL - overwrites the x-axis title to be used. Must be followed by: new x-axis title
YLABEL - overwrites the y-axis title to be used. Must be followed by: y-axis title
TITLE2, TITLE3, TITLE4, XLABEL2, XLABEL3, XLABEL4, and YLABEL2 are extra positions for user defined titles (see example). Use like TITLE etc. For label locations run the file title_demo.rob in the Demos directory.
TEXT - add text to the graph, followed by 1) text, and then 2) the x and y coordinates of where the text string will start from. See the section on ``Text Strings'' for more details.
CENTRETEXT/CENTERTEXT - add text to the graph. The difference between this and the TEXT command is that CENTRETEXT plots the text centered on the X coordinate. Arguments: 1) text string, 2) x and y coordinates.
RIGHTTEXT - add text to the graph. The difference between this and the TEXT command is that RIGHTTEXT plots text right-justified to the specified X coordinate. Arguments: 1) text string, 2) x and y coordinates.
TEXTSIZE - gives size of characters, argument is: size of character in ``points".
TENPOINT, TWELVEPOINT, FOURTEENPOINT, EIGHTEENPOINT - use text size as specified (units are ``points").
WIDTH0, WIDTH1, WIDTH2, WIDTH4, WIDTH8 - change the width of lines. The default width is 0. This is supposed to give faster plotting under X Windows. On high resolution postscript devices it is possible that this might give some problems.
SOLIDLINES, DASHEDLINES, DOTTEDLINES, DOTDASHEDLINES - specify different line styles for drawing. The default is to use solid lines.
NORMAL - use normal font style. i.e. neither bold nor italic.
BOLD - use bold fonts. ITALIC - use an Italic (for Times-Roman) or oblique (for Helvetica or Courier) style fonts.
BOLDITALIC - use bold italic/oblique fonts.
TIMES - use the Times-Roman family of fonts.
HELVETICA - use the Helvetica family of fonts. This is a sans serif font.
COURIER - use the Courier font family. This is a mono-spaced (non-proportional) font and will probably look ugly for most applications.
TANGLE - angle at which text is to be plotted, argument is angle in degrees. The default is 0 degrees.
DATALIMITS - user defined constraints on minimum and maximum data values to be plotted (The DFLIMITS command described later is more general) DATALIMITS is useful if you want to zoom in on a region of interest. Argument: minimum x, minimum y, maximum x, maximum y.
PAGEUSE - specifies percentage fraction of plotting area to be used. Useful for constructing multi-panel graphs. Argument is: coordinates bottom left hand corner and top right hand corner in percentages. Default is: bottom left hand corner is 20.,20., top right corner is 90.,90.
LINE - draw a line. Argument: start coordinates and end coordinates.
DASHEDLINE - draw a dashed line. Arguments: 1) start and end coordinates, 2) no. of dashes, ratio of space to dash size.
MOVETO - set the current plot position without drawing a line. Argument: coordinates of position.
LINETO - draw a line from the present plot position to the specified point and set the present plot position to that point too. Argument: coordinates of position.
POLYLINE - draw a series of connected lines. Arguments: coordinates of points to be connected.
POLYGON - draw a series of connected lines with the last point connected to the first point. Arguments: coordinates of points to be connected.
POLYFILL - draw a filled polygon. Uses the ``odd even'' filling rule. Arguments: coordinates of points defining the polygon. BOX - draw a box. Argument: coordinates of bottom left hand corner and top right hand corner.
FILLEDBOX - draw a filled box. Argument: coordinates of bottom left hand corner and top right hand corner.
CIRCLE - draw a circle. Argument: coordinates of center and radius in units of the X axis.
FILLEDCIRCLE - draw a filled circle. Argument: coordinates of center and radius in units of the X axis.
ELLIPSE - draw an ellipse. Argument: coordinates of the center and a corner of a bounding box.
ARC - draw a circular arc. Argument: center, radius (X axis units), start angle and end angle. Angles are measured in degrees.
ARROW - draw an arrow. Argument: start and end coordinates.
SINGLEARROW - arrow heads on one end of arrow (default).
DOUBLEARROW - arrow heads on both ends of arrow.
ARROWLINE - draw arrow head using two lines (default).
ARROWHOLLOW - draw hollow arrow head.
ARROWFILL - draw filled arrow head.
ARROWSIZE - specify size of arrow head. Argument: size of arrow head.
ARROWANGLE - specify shape of arrow head. Argument: opening angle of arrow head in degrees.
TITLES - plot titles to graph and axes (default).
NOTITLES - don't put titles on graph and axes.
AXES - draw axes (default).
NOAXES - don't draw axes.
LABELAXES - label axis at tick marks (default).
NOLABELAXES - don't label axis tick marks.
LABELXAXIS - label the x-axis at tick marks (default).
NOLABELXAXIS - don't label the x-axis at tick marks.
LABELYAXIS - label the y-axis at tick marks (default).
NOLABELYAXIS - don't label the y-axis at tick marks.
NTICKX - changes the approximate number of tick marks to use in the x-direction. The default is to use about 10 (the program adjusts the exact number to give good looking plots). Argument: approximate number of tick marks for the x direction.
NTICKY - as NTICKX but for the y direction. Argument: approximate number of tick marks in the y direction.
MINORAXES - also minor tick marks for both axes.
NOMINORAXES - don't draw any minor tick marks (default).
LOGAXES - Axes are to be logarithmic. Note, this doesn't do anything to the data, it is assumed that your data already is log values.
LINEARAXES - Use normal non-logarithmic axes (default).
LOGXAXIS - the x axis is log.
LINEARXAXIS - the x axis is linear.
LOGYAXIS - the y axis is log.
LINEARYAXIS - the y axis is linear.
USERAXIS - draw a user defined axis. Argument: id, ticksize, start x coordinate, start y coordinate, distance between tick marks, number of tick mark intervals (integer). id is an integer defining axis direction, 0 is x direction, 1 is y direction. To get tick marks to go on the opposite side of the axis make tick size a negative number.
USERAXISLABEL - user defined axis labels. Arguments, 1): start value for labels, increment value. 2) id, start x coordinate, start y coordinate, interval between labels, number (integer) of labels. id is as in USERAXIS above.
LOGAXIS - as for USERAXIS except that a logarithmic axis will be used.
LOGAXISLABEL - as for USERAXISLABEL except labels will be written as [tex2html_wrap_inline275].
PENCOLOUR - This alters the color used to plot your graph or portions of it. Argument: one of either white, blue, green, yellow, red, magenta, cyan or black. (This command has a number of aliases including ``COLOR'').
TOPAXIS - draw an axis at the top of the plot .
NOTOPAXIS - don't draw an axis at the top of the plot.
BOTTOMAXIS - draw an axis at the bottom of the plot.
NOBOTTOMAXIS - don't draw an axis at the bottom of the plot.
RIGHTAXIS - draw an axis at the right hand side of the plot.
NORIGHTAXIS - don't draw an axis at the right hand side of the plot.
LEFTAXIS - draw an axis at the left hand side of the plot.
NOLEFTAXIS - don't draw an axis at the left hand side of the plot.
ALLAXES - draw all of the above axes (default). XTICKSIZE - specify the size of the tick marks used for the X axis. Units are the dimensions of the Y axis.
YTICKSIZE - specify the size of the tick marks used for the X axis. Units are the dimensions of the Y axis.
DEFAULTTICKSIZE - let Robot calculate tick sizes to be used (default).
EXTERNALTICKS - plot external ticks marks.
INTERNALTICKS - plot internal tick marks (default).
EXTERNALXTICKS - plot external tick marks on the X axis.
INTERNALXTICKS - plot internal tick marks on the X axis.
EXTERNALYTICKS - plot external tick marks on the Y axis.
INTERNALYTICKS - plot internal tick marks on the Y axis.
MINORTICKSIZE - specify the size of the minor tick marks. Argument is the ratio of minor tick mark size to major tick mark size.
MINORTICKFREQUENCY - specify the frequency of minor tick marks. Argument: approximate ratio of minor tick mark frequency to major tick mark frequency.
RGB - Specify the color using intensities for red, green and blue. Argument: R, G and B values. These must be scaled between 1 and 256.
RGBDATA - only specify the color used for plotting the data itself. Axes, text, and anything else is left in the current plot color.
RGBREST - specify the color for plotting everything apart from the data. The color used to plot the data is left in the current plot color.
RESET - resets everything to default values, i.e. plot data as error bars, plot axes with labels, add titles to graphs, use from 20-90% of plot dimensions in both x and y directions, don't divide into sub-windows, use standard pen color/thickness, use approximately 10 tick mark intervals in x and y directions.
NXTPAG (N) - start a new page.
DIVWINDOW - divide the plotting area into several sub-windows. Argument: no. of windows in x-direction, no. of windows in y direction.
SELWINDOW - select a subwindow. Argument: no. of sub-window in x and y directions.
WINDOWGAP - specify spacing between sub-windows. Argument: percentage gap between windows. Default is to have no gap. XWINDOWGAP - as WINDOWGAP but specifies gap in just X direction.
YWINDOWGAP - as WINDOWGAP but specifies gap in just Y direction.
VALUES/SHOW - causes printing of values of various ROBOT parameters, e.g. data limits, plotting limits, version no. of ROBOT being used.
ECHO - causes extra output to be written to the screen (deprecated).
NOECHO - reduces output written to screen (deprecated).
CURSOR - calls up the graphics cursor. When RETURN is pressed the coordinates are stored as the variables XCURSOR and YCURSOR which can be used as parameters for the arguments to other commands (e.g. the arithmetic ones).



next up previous contents
Next: 3D Data Up: Commands currently recognized Previous: The Input Data



Robin Corbet
Sat May 3 16:56:08 EDT 1997