.mc |.\" Copyright (c) 1987 Entropic Speech, Inc.; All rights reserved.\" @(#)plotspec.1	3.16  03 Apr 1997  ESI.TH PLOTSPEC 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..if t .ds pi \(*p.if n .ds pi pi.SH NAME.mc |plotspec \- Plot spectral record files (.spec).mc.SH SYNOPSIS.B plotspec[.BI \-d] [.BI \-l] [.BI \-r " range"] [.BI \-t " text"] . . . [.BI \-x " debug_level"] [.BI \-y " range"].br[.BI \-D] [.BI \-F] [.mc |.BI \-T " device"] [.mc.BI \-W " generic window system options"] [.BI \-X " range"] [.BI \-Y " range"] .I file.fspec.SH DESCRIPTION.PP.I plotspecplots records from ESPS spectral-feature-record (FEA_SPEC) files.These files can be created by the.I me_speccommand.More than one record may be plotted, superposed on one set of axes.If the input file is ``\-'', the standard input isread..PPThe default action is to plot the contents of the.I re_spec_valfield of the input records and,if the type is SPTYP_CPLX, the contents of.I im_spec_valas well.However, alternative output formats are available with the.BR \-d ,.BR \-D ,and.BR \-Foptions.When the spectrum type is SPTYP_REAL and a power is required,as with the.BR \-dand.BR \-Doptions,the square of.I re_spec_valis used..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 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.PP.mc |On 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.PPThe following options are supported..TP.BI \-dPlot the power spectrum cumulative distribution function..TP.BI \-lPlot frequencies on a logarithmic scale (labeled in decades).When the vertical scale is in dB, this option results in Bode-plot format..TP.BI \-r " first" : "last".TP.BI \-r " first" :+ "incr".TP.BI \-r " frame"Range of records to be plotted.The default range is the entire file.In the first form, a pair of unsigned integers gives the first and lastrecords of the range.The first frame in the file counts as number 1regardless of any reference file.If.I firstis omitted, 1 is used.If.I lastis omitted, the last record of the file is used.The second form is equivalent to the first with.IR last " = " first " + " incr.The third form is equivalent to.BI \-r " frame" : "frame.".TP.BI \-t " text"A line of text to be printed below the plot.  If this option is specifiedmore than once, the lines are printed in the order given..TP.mc |.BI \-x "debug_level".mcIf.I debug_levelis nonzero, debugging information is written to the standard error output.The higher the level, the more messages are written.Default is 0 (no debugging output)..TP.BI \-y " low" : "high"Data range.  Specifies spectral values for the lower and upper.IR y -axislimits.  If.I lowor.I highis unspecified, the limit is determined from the file contents.The values are adjusted by.I plotspecin an attempt to make an esthetically pleasing plot.To specify exact limits, use.B \-Yinstead..TP.BI \-DPlot the logarithmically scaled power (in dB) regardless of whetherthe spectrum type is SPTYP_DB or not.The arguments of the.B \-yand.B \-Yoptions are interpreted in dB..TP.BI \-FPlot the phase of complex data, rather than the real and imaginary parts.The input file must contain data of type SPTYP_CPLX..mc |The verical axis is scaled in radians, from \-\*(pi to \*(pi,.mcand the.B \-yand.B \-Yoptions are ignored..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 worstation graphics screen by piping it through.IR mcdor.IR xmcd.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..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.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..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 asystem running X windows, to cause the plot to appear at a particularscreen location the following command could be used: .br\fIplotspec -W "=300x250+50+200" file\fR..brSee \fImcd(1\-ESPS)\fR and \fIxmcd(1\-ESPS)\fR for details..mc.TP.BI \-X " low" : "high".TP.BI \-X " limit"Frequency range.  Specifies frequency values for the lower and upper.IR x- axislimits.  If.I lowor.I highis omitted, the limit is determined from the file contents.The second form is equivalent to.BR \-X " 0" : \fIlimit\fPif the header value.I freq_formatis SPFMT_SYM_CTR or SPFMT_SYM_EDGE and to.BI \-X " \-limit" : "limit"otherwise..TP.BI \-Y " range"Specifies exact lower and upper limits for the.IR y- axis..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..SH EXAMPLE.IP.BI "plotspec " "<options> <filename>".PPis equivalent to.IP.BI "plotspec \-Tgps " "<options> <filename> " "| mcd".PPThe second form may be used if nondefault options for.I mcdare desired..mc.SH "ESPS PARAMETERS"The ESPS parameter file is not read..SH "ESPS COMMON"The ESPS common file is not read or written..SH "ESPS HEADERS"The following values are explicitly readfrom the header of the spectral-feature-record file:.I common.type,and the generic header items.I num_freqsand.I freq_format.In addition, the header is examined by the library routines.I allo_feaspec_rec,.I get_feaspec_rec,and.I put_feaspec_rec..SH SUBROUTINES CALLEDplotscale, drawbox, plot2data and printtime..SH SEE ALSOme_spec(1\-ESPS), plotsd(1\-ESPS), FEA_SPEC(5\-ESPS).SH DIAGNOSTICS.PPplotspec: unknown option:.RI \- letter.br.mc |Usage: plotspec [-d] [-r range] [-t text]... [-x debug_level][-y range].mc.br.mc | [-E] [-T device] [-X range] [-Y range] [file.fspec] .mc.brplotspec: Too many \-t options.brplotspec: no input file.brplotspec: more than one input file.brplotspec:.I filenameis not an ESPS file..brplotting records.I n1thru.I n2..brplotspec: can't open temporary file..brplotspec: EOF encountered before start reached..brcan't allocate memory for.I npoints..brplotspec: only freq formatsSPFMT_SYM_EDGE, SPFMT_SYM_CTR, SPFMT_ASYM_EDGE, SPFMT_ASYM_CENsupported so far..br.mc |plotspec: discrete distributions not het supported..mc.brplotspec: \-s option not implemented yet..br.mc |plotspec: \-d and \-F optins incompatible..mc.brplotspec: \-F option requires complex data..brplotspec: can't open temporary file..brplotspec: freq format SPFMT_ARB_VAR not yet supported..brplotspec: freq format SPFMT_ARB_FIXED not yet supported..brplotspec: unrecognized freq format.I n..brfrequency out of range..brdata out of range..brplotspec: no input records.br\-T option requires argument..SH WARNINGS.PPTo overlay FEA_SPEC files from.IR fft (1-ESPS).mc |on FES_SPEC files from.mc.IR me_spec (1-ESPS),the.B \-Goption of.I me_specmust be used..SH BUGS.PPFrequency formats SPFMT_ARB_VAR and SPFMT_ARB_FIXED are not yet supported..mc |.SH FUTURE CHANGESData conversions \-.I e.g.,between log (dB) and linear representations..SH AUTHORS. Shankar Narayan.Made SDS compatible by Joe Buck.Originally called.I pspc.Modified for ESPSby Rod Johnson, Entropic Speech, Inc..br\-d option added by Ajaipal S. Virdy.\-T, \-l, \-D, and \-F added by Rod Johnson.Revised by Rod Johnson for input from FEA_SPEC file..mc