ListPlot(1) AMIGA Manual ListPlot(1) ›1mNAME ›0mListPlot - a vanilla plotting filter ›1mSYNOPSIS ListPlot ›0m[ options ] ›1mDESCRIPTION ›0m›3mListPlot ›0ma simple 2D plotting filter based on the ›3mPLPLOT ›0mplotting library. Its principle advantage is that it supports a variety of graphics devices. ›3mListPlot ›0mreads from stdin and writes to stdout unless input and/or output files are specified on the command line. The program accepts a file of n-tuples. Each tuple consists of a sequence of space-separated numbers terminated with a newline. The first element of each tuple is assumed to be the independent variable. Each remaining element is plotted against the first to produce n-1 curves. ›3mListPlot ›0mtakes a number of command line arguments that may be used to control the appearance of the plots. Command line arguments are specified in the form ›3mvariable=value ›0mFor a list of the arguments enter: ListPlot Help=All. ›1mVARIABLES TYPES Boolean ›0m  values accept values such as ›1mtrue›0m, ›1mfalse›0m, ›1myes›0m, ›1mno›0m, ›1mon›0m, ›1moff›0m, ›1m0›0m, and ›1m1 ›0m(ex. PlotColor=yes). ›1mString ›0m   values expect the strings to entered as indicated and is case sensitive (ex. Domain=All). ›1mDbl ›0m      values expect real numbers (ex. AspectRatio=1.0). ›1mInterval ›0m values expect a pair of comma separated reals (ex. Range=-1.0,3.0). ›1mSet ›0m      values expect a list of comma separated elements enclosed in curly braces ({}). (ex. LineStyle={MS,MMS,MSmmS}) ›1mRect ›0m     values expect a list of comma separated numbers representing a diagonal from the lower-left corner to the upper-right corner (ex. ViewPort={0.1,0.3, 0.9,0.6}). The title and label variables accept strings that include the following control sequences: #›1mu›0m: move up to superscript (ended with #›1md ›0m) #›1md›0m: move down to subscript (ended with #›1mu ›0m) 5/15/90 -1- Duke University ListPlot(1) AMIGA Manual ListPlot(1) #›1mb›0m: backspace to allow overprinting ##: the number symbol #+: toggle overline mode #-: toggle underline mode #›1mgx›0m: Greek letter corresponding to Roman letter x ›1mOPTIONS ›0mThe currently available arguments are indicated below. ›1mBold ›0mface arguments indicate that they should be entered exactly as shown. An '*' indicates that an arbitrary string may be given. A string with embedded spaces must be quoted. ›1mAngularUnit›0m=[ ›1mdegrees ›0m| ›1mradians ›0m] ›3mAngularUnit ›0mspecifies the angular unit of measure used for polar plots. For angles in radians use ›1mAngularUnit›0m=›1mradians›0m. ›1mAnnotationScale›0m=[ ›3mdbl ›0m] ›3mAnnotationScale ›0mcontrols the size of the characters used to annotate the axes. ›1mAspectRatio›0m=[ ›3mdbl ›0m| ›1mAutomatic ›0m] ›3mAspectRatio ›0mcontrols the relative lengths of the vertical to horizontal axes. If set this value overrides the value of ›3mViewPort. ›0m›1mBoxed›0m=[ ›3mboolean ›0m| * ] ›3mBoxed ›0madds axes to the edges of the plot. If ›3mBoxed ›0mis given a boolean value then axes are placed on all of the edges. If ›3mBoxed ›0mis given a string consisting of one or more of ›3mt, b, r, l ›0mthen axes are added to top, bottom, right and left edges respectively. ›1mDomain›0m=[ ›3minterval ›0m| ›1mAll ›0m| ›1mAutomatic ›0m] ›3mDomain ›0mmay be used to specify the bounds on the X axis. When set to ›1mAll›0m, all points are plotted. When set to ›1mAutomatic›0m, outlying points may not be plotted. ›1mGridding›0m=[ ›3mboolean ›0m] ›3mGridding ›0mputs a grid on the plot. ›1mHelp›0m=[ ›1mAll ›0m| ›1mall ›0m| * ] ›3mHelp ›0mprovides some descriptive text for the user-settable plotting variables. If the variable ›3mVerbose ›0mis set then an extended description is provided. To set verbose enter ListPlot Verbose=yes Help=[ ›3mvariable ›0m| ›1mAll ›0m]. ›1mLabelScale›0m=[ ›3mdbl ›0m] ›3mLabelScale ›0mspecifies the relative size of the vertical and horizontal axis labels. The typical range is [0.5 - 2.0]. ›1mLineColor›0m=[ ›3mset ›0m] ›3mLineColor ›0mmay be used to specify a list of line 5/15/90 -2- Duke University ListPlot(1) AMIGA Manual ListPlot(1) colors for plots with multiple curves if this feature is supported for a particular output device. ›1mLineStyle›0m=[ ›3mset ›0m] ›3mLineStyle ›0mmay be used to specify a list of line styles for plots with multiple curves. Each linestyle is specified as a sequence of pen down... pen up elements. The elements are encoded using the following characters to indicate element lengths: ›1mm›0m: 250 micron mark ›1mM›0m: 1mm mark (›1mmmmm›0m) ›1ms›0m: 250 micron space ›1mS›0m: 1mm space (›1mssss›0m) For example, a set of line styles might be indicated LineStyle={MS,MMSS,MMSmmS,mmS,mmSmmSMMS} ›1mOrientation›0m=[ ›1mportrait ›0m| ›1mlandscape ›0m] ›3mOrientation ›0mcontrols whether the plot is displayed in landscape or portrait orientation. ›1mOrigin›0m=[ ›3minterval ›0m| ›1mAutomatic ›0m| ›1mMedian ›0m] ›3mOrigin ›0mallows the placement of a set of axes at an arbitrary point. The ›3mMedian ›0mvalue places the axes at the median ›3mX ›0mand the median ›3mY ›0mof the data values. ›1mPlotColor›0m=[ ›3mboolean ›0m] ›3mPlotColor ›0mif ›1mtrue ›0mcauses the plot to generated in color if this feature is supported on a particular output device. ›1mPlotJoined›0m=[ ›3mboolean ›0m] ›3mPlotJoined, ›0mif set, connects each data point with a line in the current line style. ›1mPlotPoints›0m=[ ›3mboolean ›0m] ›3mPlotPoints ›0mif ›1mtrue ›0mcauses symbols to be plotted in the current symbol style at each data point. ›1mPointScale›0m=[ ›3mdbl ›0m] ›3mPointScale ›0mcontrols the relative size of the data point symbols when data point symbols are being plotted. ›1mPointSymbol›0m=[ ›1mAutomatic ›0m| ›3mset ›0m] ›3mPointSymbol ›0mspecifies a list of symbols to be used when plotting data points. The symbols types are encoded as integers. (See the ›1mPLPLOT ›0mlibrary documentation to find the symbols available.) ›1mPlotTitle›0m=[ * ] ›3mPlotTitle ›0mtakes the plot title as an argument. Text control sequences described above may be included. 5/15/90 -3- Duke University ListPlot(1) AMIGA Manual ListPlot(1) ›1mPlotDevice›0m=[›1mamiga›0m| ›1mprinter ›0m| ›1miff ›0m| ›1mhp ›0m| ›1maegis ›0m| ›1mpostscript›0m] ›3mPlotDevice ›0mspecifies output device type. ›1mPlotType›0m=[ ›1mlinlin ›0m| ›1mloglin ›0m| ›1mlinlog ›0m| ›1mloglog ›0m| ›1mpolar ›0m] ›3mPlotType ›0mspecifies the ›3mgraph paper ›0mupon which the plot is drawn. The current implementation plots in linear-linear, log-linear, linear-log, log-log, and polar formats. For the log type plots, the log of the data is computed. For polar plots, see also ›3mAngularUnit ›0mand ›3mPolarVariable. ›0m›1mPolarVariable›0m=[ ›1mangle ›0m| ›1mradius ›0m] ›3mPolarVariable ›0mfor polar plots is used to specify whether the independent variable is angular or radial. ›1mRange›0m=[ ›3minterval ›0m| ›1mAll ›0m| ›1mAutomatic ›0m] ›3mRange ›0mspecifies the y axis bounds. (ex. Range=-1,1 ) When set to ›1mAll›0m, all points are plotted. When set to ›1mAutomatic›0m, outlying points may not be plotted. ›1mSubPages›0m=[ ›3minterval ›0m] ›3mSubPages ›0mspecifies the number of plots on a pages. This is a vestige of PLPLOT and I am not sure this has any use within the context of ›3mListPlot. ›0mIt might be useful for controlling the size of the plots but the ›3mViewPort ›0mmight be a more direct solution. ›1mSupplyAbscissa›0m=[ ›3mboolean ›0m] ›3mSupplyAbscissa ›0mif set causes ›3mListPlot ›0mto supply a value for the independent variable. ›1mTitleScale›0m=[ ›3mdbl ›0m] ›3mTitleScale ›0mcontrols the relative size of the title text. ›1mUseInputFile›0m=[ * ] ›3mUseInputFile ›0mpermits the specification of an input file if you would rather not use stdin. ›1mUseOutputFile›0m=[ * ] ›3mUseOutputFile ›0mpermits the specification of an output file if you would rather not use stdout. ›1mVerbose›0m=[ ›3mboolean ›0m] ›3mVerbose ›0mif set causes extended messaging. ›1mViewPort›0m=[ ›3mrect ›0m] ›3mViewPort ›0mallows control over the size of a plot. Takes a viewing rectangle diagonal as an 5/15/90 -4- Duke University ListPlot(1) AMIGA Manual ListPlot(1) argument. ex. ViewPort={0.1,0.3, 0.9,0.6} ›1mXLabel›0m=[ * ] ›3mXLabel ›0mspecifies X axis label. Text control sequences described above may be included. ›1mYLabel›0m=[ * ] ›3mYLabel ›0mspecifies Y axis label. Text control sequences described above may be included. ›1mXTick›0m=[ ›1mAutomatic ›0m| ›3minterval ›0m] ›3mXTick ›0mcontrols the spacing of major axis ticks and the number of minor subdivisions. (ex. ›3mXTick=0.1,10 ›0mindicates major ticks at units of 0.1 with 10 minor subdivisions.) ›1mYTick›0m=[ ›1mAutomatic ›0m| ›3mInterval ›0m] ›3mYTick ›0mcontrols the spacing of major axis ticks and the number of minor subdivisions. ›1mFILES IDENTIFICATION ›0mAuthors: Frederick R. Bartram and Anthony M. Richardson, Dept. of Electrical Engineering, Duke University, Durham, N.C. 27706. InterNet: frb@dukee.egr.duke.edu,amr@dukee.egr.duke.edu Copyright 1990 by Frederick R. Bartram and Anthony M. Richardson. Amiga port by Anthony M. Richardson ›1mBUGS ›0mPlease report any bugs or unusual ›3mfeatures ›0mto the authors. 5/15/90 -5- Duke University