.\" Copyright (c) 1987, 1988 Entropic Speech, Inc. All rights reserved..mc |.\" @(#)scatplot.1	3.13  03 Apr 1997  ESI.TH SCATPLOT 1-ESPS 03 Apr 1997.mc.ds ]W "\fI\s+4\ze\h'0.05'e\s-4\v'-0.4m'\fP\(*p\v'0.4m'\ Entropic Speech, Inc..SH NAMEscatplot - make a scatter plot.SH SYNOPSIS.B scatplot[.BI \-e " range"] [.BI \-r " range"] [.BI \-s " symbols"] [.BI \-t " text"] [.BI \-x " debug_level"].br[.BI \-H " text"] [.mc |.BI \-T " device] [.mc.BI \-V " text"] [.BI \-X " range"] [.BI \-Y " range"] [.BI \-W " generic window system options"] .I file1[.I file2] . . ..SH DESCRIPTION.PP.I Scatplotmakes a scatter plot of pairs of elements from multiple ESPS files.I file1, file2, . . . .When used as a file name, ``\-'' denotes standard input..PP.mc |By default,the output is in Unix GPS (``Graphics Primitive String'') formatand is displayed on the Masscomp or Sun display, but with the.B \-Toption, this may be sent to the standard output,obtained in Tektronix format rather than GPS,or plotted on a hardcopy device..mc.PP.mc |On a Sun workstation, this program must be run from within the\fISuntools\fR window system.  The plot will appear in a new window,which can be moved, resized, closed (reduced to an icon), and removed byusing the functions on the \fISuntools\fR menu.   To get this menu, movethe mouse cursor to the title bar of the plot window and press the rightmouse button..mc.PP.mc *.mcIf the \fB\-r\fP option is omitted, then the entire contentsof all files are plotted..PPThe \fB\-e\fP option specifies which elements to plot.  An evennumber of elements must always be given since there are no defaultelements to plot.  The first pair of elements is associated with the firstfile, the second pair with the second file, and soon up to the last file or until no other pair of elements remains, inwhich case the last pair of elements is associated with the remainingfiles.  The first element in the pair is plotted as the abscissaand the second element as the ordinate.  Default symbols are usedto distinguish between multiple files, but they can be overridden bythe \fB\-s\fP option.  .PP.I Scatplotfinds the maximum and minimum of the.I xvalues and the.I yvalues in the specified ranges of the input filesand computes appropriate scalesThis automatic scaling can be overridden by the.B \-Xand.B \-Yoptions..mc |.PPOn Masscomp systems the color and line style of output to ``gps'' or ``mcd'' depend on theenvironment variable BUNDLE.  The default is GPS bundle number 20, whichgives solid lines on monochrome displays..mc.SH OPTIONS.PPThe following options are supported:.TP.BI \-e " elements"Determine which elements within a record to plot.The elements may be separated by commas, or, more generally,any construct acceptable to.IR grange_switch (3-ESPSu)may be used, as long as the number of elements specified is even.The first pair of elements is associated with the firstfile, the second pair with the second file, and soon up to the last file or until no other pair of elements remains,in which case the last pair of elements is associated with the remainingfiles.The first element in the pair is plotted as the abscissaand the second element as the ordinate..TP.BI \-r " first:last".TP.BI \-r " first:+incrDetermines the range of records to be plotted.  In the first form, apair of unsigned integers gives the first and last records of the range.  If .I firstis omitted, 1 is used.  If .I last is omitted, the last record in the file is used.  The second form isequivalent to the first with .I "last = first + incr"..mc |.PP.mcThis option may be repeated.The first.B \-roption applies to the first input file, the second.B \-roption to the second input file, and so on.If there are more files than.B \-roptions, then the last option applies to all remaining files..TP.BI \-s " symbols \fR[\fPxo*abcdefghijklmnpqrstuvwyz\fR]\fP"Plot the scatter plot using the symbols specified.The first symbol is used for the first file,the second symbol for the second file,and so on up to the last file.There must be at least as many symbols as files.The default symbols are given in brackets.  .mc |.PP.mcThe positions of the symbols.I `x'and.I `o'have been modified so that the plotting point falls very close tothe "center" of the character.  Other characters will not have theircenters exactly at the plotting points..TP.BI \-t " text"Print a line of text above the graph..TP.BI \-x " level"If.I levelis nonzero, debugging information is written to the standard error output.Default is 0 (no debugging output)..TP.BI \-H " text"Print a line of text below the graph..TP.mc |.BI \-T " device".I Devicemay be.BR gps ,.BR mcd ,.BR tek ,.BR suntools ,.BR hp ,or.BR hardcopy .The default is.BR \-Tmcd,which displays the output on the workstation graphics screen by piping it through.IR mcd (1)or.IR xmcd (1\-ESPS).The program \fImcd\fR is supplied by Masscomp for their systems, and byESI for other workstations.Specifying.B \-Tgpssends output to the standard output in Masscomp Unix GPS format.Specifying.B \-Ttekcauses output to be sent to the standard output in Tektronix 4000-seriesformat.If.B \-Tsuntoolsis used, then the display will be forced to use \fIsuntools\fR windowsystem (on Suns and Solbournes only), even if ESPS has been configuredto use the X window system.   If ESPS is built for X, then it uses X forplotting by default.If.B \-Tmcdis used on a Masscomp and ESPS has been configured to use X windows,then the old SP-40 \fImcd\fR is used instead of X windows.Specifying.B \-Thardcopyplots it on a hardcopy device, if one was set up in the installationscript.  Note that the word \fIimagen\fR was used for this option inprevious versions.   It is still accepted, but \fIhardcopy\fR is meantto be more general..B \-Thpproduces output for an HP LaserJet printer.   Note that the output isproduced on standard out and it is not spooled to the printer by thiscommand.   Use of this option will result in about 750K bytes of outputper page.   If the link to your LaserJet is slow, it might takeseveral minutes to send it to the printer.    In a later version, this will be merged with the\fIhardcopy\fR option above for direct spooling..TP.mc.BI \-V " text"Print a line of text along the left side of the graph going upwards..TP.BI \-X " low:high"Specifies lower and upper limits for the x-axis, disablesautomatic computation of limits..TP.BI \-Y " low:high"Specifies lower and upper limits for the y-axis, disablesautomatic computation of limits..TP.BI \-WThis option is followed by a character.mc |string consisting of the generic window system options.   These options arepassed onto \fImcd\fR or \fIxmcd\fR.   This option is used to pass along generic X windowarguments to \fIxmcd\fR or Suntool arguments to \fImcd\fR on Suns.  Thisoption might not have an effect on all systems.   For example, on a.mcsystem running X windows, to cause the plot to appear at a particularscreen location the following command could be used: .mc *.mc.br\fIscatplot -W "=300x250+50+200" file\fR..mc |.brSee \fImcd(1\-ESPS)\fR and \fIxmcd(1\-ESPS)\fR for details..mc.PP.mc |For Sun systems, this program will plot under either X windows, orSuntools.   By default, if the \fB-T\fR option is not used, it will expect X windows.   To plot under Suntools you can use the \fB-Tsuntools\fRoption.    If you always use Suntools, you can avoid using the \fB-T\fRoption by defining the environment variable \fBEPLOTDEV\fR to be\fIsuntools\fR.  This will make the Suntools window system the default.This variable is ignored if the machine type is not Sun4, SUN3, orSUN386i..mc.SH EXAMPLES.TP\fBscatplot \-r\fI1:500\fP \-s\fIxo \fB\-e\fI5,6,15,19 file1 file2\fRmakes a scatter plot (using the letter \fIx\fP for file1 and theletter \fIo\fP for file2) of element 5 versus element6 in \fIfile1\fP and of element 15 versus element 19in \fIfile2\fP across the record range 1 to 500. The plot isdisplayed on the graphics terminal..mc |.TP.BI "scatplot \-Tgps " "<options> <files>"sends the plot to standard output in Masscomp Unix GPS(``Graphic Primitive String'') format..TP.BI "scatplot \-Thardcopy " "<options> <files>"plots on the hardcopy plotter..TP.BI "scatplot \-Ttek " "<options> <files>"sends the plot to standard output in Tektronix format and may be used toplot on a Tektronix terminal..mc.SH "ESPS PARAMETERS".PP.I Scatplotdoes not read an ESPS parameter file..SH "ESPS COMMON".PP.I Scatplotdoes not read or write the ESPS common file..SH "ESPS HEADERS".PP.I Scatplotreads the following fields from the ESPS file headers:.I common.ndrec,.I common.tag..SH DIAGNOSTICS.PP.nfscatplot: please give only one \-e option.scatplot: \-e option: even number of elements required.scatplot: please specify an element range with the \-e option.scatplot: data is not tagged in \fIfile\fP, cannot plot element 0.scatplot: please specify \fIn_symbols\fP symbols with the \-s option.scatplot: start point after end point.scatplot: only \fIn_points\fP in \fIfile\fP.scatplot: only \fIn_records\fP records read in \fIfile\fP.scatplot: calloc: could not allocate memory for \fIarray\fP.scatplot: d_mat_alloc: could not allocat memory \fImatrix\fP.scatplot: command line too long: truncating string..fi.SH EXPECTED CHANGES.PPAllow range specifications of the form.IB "<field name>" [ "<range>" ]with FEA files..SH SEE ALSOmlplot(1\-ESPS), genplot(1\-ESPS), fea_element(1\-ESPS),grange_switch(3\-ESPS)..SH AUTHOR.PP.nfAjaipal S. VirdyGeneralized by Rodney Johnson to allow independent ranges in the inputfiles..fi