.\" Copyright (c) 1987 Entropic Speech, Inc. All rights reserved..mc |.\" @(#)aplot.1	3.11	4/5/90 ESI.TH APLOT 1\-ESPS 4/5/90.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 NAMEaplot \- Plot an array of data in ASCII format..SH SYNOPSIS.B aplot[.BI \-d] [.BI \-l] [.B \-z] [.mc |.BI \-T " device"] [.mc.BI \-W " generic window system options"] [.I data_file].SH DESCRIPTION.I aplotplots an array of ordered pairs <x, y>, stored in ASCII format.If.I data_fileis ``\-'' or omitted, the standard input is read..mc |By default,the output is in Unix GPS (``Graphics Primitive String'') formatand is displayed on the workstation graphics displaybut 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.SH "DATA FORMAT".PPThe.I data_fileis expected to contain the following parameters, eachseparated by a blank..RI < No_of_Samples >.RI < No_of_plots >.RI < x_axis_min >.RI < x_axis_max >.RI < x_axis_step >.RI < y_axis_min >.RI < y_axis_max >.RI < y_axis_step >followed by plot data (x and y values separated by blank)..PPAny.I Textfollowing the data (after a blank line) is reproduced as plotter output..PPIn the case of multiple plots, the line thickness is varied to distinguishbetween different plots..mc |.PPOn a Sun workstation (not running X windows), 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.SH OPTIONS.PPNormally, a coninuous plot is generated.  However, the followingoptions can be used, in the case of single plots:.TP.B \-dIf this option is specified, there will be a dot for each <x, y>pair. However, there will be no continuous plot..TP.B \-lIf this option is specified, there will be a vertical line from <x,y_axis_min> to <x, y> for each <x, y> pair; the points themselves will not be connected to each other.  .TP.B \-zIf this option is specified,the vertical and horizontal grid lines are suppressed \- only tickmarks are made on 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 graphics screen by piping it through.IR mcdor.IR xmcd (for X window system).The program \fImcd\fR is supplied by Masscomp for their systems and byESI for other systems and those running X windows.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 \-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\fIaplot -W "=300x250+50+200" file\fR..mc |.brSee \fImcd(1\-ESPS)\fR and \fIxmcd(1\-ESPS)\fR for details..PPFor 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 "ESPS PARAMETERS"No ESPS parameter file is read..SH "ESPS COMMON"The ESPS common file is not read or written..SH "ESPS HEADERS"No ESPS headers are processed, since the input and output are not ESPSfiles..SH DIAGNOSTICS.nfaplot: unknown option \-\fIletter\fP.mc |Usage: aplot [\-d] [\-l] [\-z] [\-T] [input_file].mcaplot: Cannot specify both \-d and \-l flagsaplot: can't open \fIfilename\fP: \fIreason\fPaplot: EOF encountered.SH "SEE ALSO".mc |plotsd(1\-ESPS), plotspec(1\-ESPS), scatplot(1\-ESPS), mcd(1G)(Masscomp),mcd(1\-ESPS), xmcd(1\-ESPS).mc.SH AUTHOR.PP.nf.mc |Shankar Narayan, Entropic Speech, Inc.Modified for \-T option by Rodney Johnson.\fB\-z\fR option added by David Burton..mc.fi.mc *.mc