cat

speech signal process tools

PLOTFIELD(1-ESPS)                           ENTROPIC RESEARCH LAB



NNNNAAAAMMMMEEEE
     plotfield - plot arbitrary named field from a FEA file

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     pppplllloooottttffffiiiieeeelllldddd ----ffff _f_i_e_l_d [ ----rrrr _r_a_n_g_e ] [ ----tttt _t_e_x_t ] [ ----xxxx _d_e_b_u_g__l_e_v_e_l
     ] [ ----yyyy _r_a_n_g_e ] [ ----TTTT _d_e_v_i_c_e ] [ ----YYYY _r_a_n_g_e ] _f_i_l_e._f_e_a

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _p_l_o_t_f_i_e_l_d plots a named field from  an  ESPS  FEA  _f_i_l_e._f_e_a.
     Fields  containing  complex  data are not supported yet.  If
     _f_i_l_e._f_e_a is "-", the standard input is  read.   By  default,
     the  output  is  in Unix GPS (``Graphics Primitive String'')
     format and is displayed on the graphics  display,  but  with
     the   ---- TTTT  option,  this may be sent to the standard output,
     obtained in Tektronix format rather than GPS, or plotted  on
     an Imagen laser printer.

     If the ----rrrr option is omitted, then the named _f_i_e_l_d is plotted
     from the first record of _f_i_l_e._f_e_a.

     _P_l_o_t_f_i_e_l_d finds the  maximum  and   minimum  values  of  the
     points to be plotted and computes appropriate scales for the
     _x- and _y-axes.  These automatic values can be  overriden  by
     the ----yyyy or ----YYYY options.

     The color and line style of output  to  ``gps''  or  ``mcd''
     depend  on  the environment variable BUNDLE.  The default is
     GPS bundle number 20, which gives solid lines on  monochrome
     displays.

     The fieldname to plot must be given with the ----ffff flag.   This
     is not optional and there is no default.

OOOOPPPPTTTTIIIIOOOONNNNSSSS
     The following options are supported:

     ----rrrr _r_e_c_o_r_d

     ----rrrr _f_i_r_s_t:_l_a_s_t

     ----rrrr _f_i_r_s_t:+_i_n_c_r
          Determines the records from which the  named  _f_i_e_l_d  is
          plotted.   In  the first form, a single integer identi-
          fies one record from which _f_i_e_l_d is plotted.   The  _x -
          axis  shows  element number within the field and the _y-
          axis shows element value.

          In the second form, a pair of unsigned  integers  gives
          the  first  and  last points of the range.  If _f_i_r_s_t is
          omitted, 1 is used.   If  _l_a_s_t  is  omitted,  the  last
          record  in  _f_i_l_e._f_e_a  is  assumed.   The  third form is
          equivalent to the first with _l_a_s_t = _f_i_r_s_t + _i_n_c_r.  When



        Copyright Entropic Research Laboratory, Inc. 1G1        1






PLOTFIELD(1-ESPS)                           ENTROPIC RESEARCH LAB



          more than one record is plotted, the element values are
          catenated together before plotting  with  the  _x - axis
          showing  the  cumulative element number.  (For example,
          if _f_i_e_l_d has ten elements and two records are  plotted,
          the _x-axis will be labelled 1-20).

     ----tttt _t_e_x_t
          A line of  text  to  be  printed  below  the  plot.  By
          default,  _p_l_o_t_f_i_e_l_d prints a line giving the fieldname,
          record number, and file name.  An additional  line  may
          be printed via the ----tttt option.

     ----xxxx _d_e_b_u_g__l_e_v_e_l
          If _d_e_b_u_g__l_e_v_e_l is  nonzero,  debugging  information  is
          written to the standard error output.  Default is 0 (no
          debugging output).

     ----yyyy _l_o_w:_h_i_g_h
          Specifies approximate lower and upper  limits  for  the
          _y-axis.   The  values  are  adjusted by _p_l_o_t_f_i_e_l_d in an
          attempt to make an  esthetically  pleasing  plot.   See
          also  the ----YYYY option.  If neither ----yyyy or ----YYYY is specified,
          limits are calculated automatically.

     ----TTTT _d_e_v_i_c_e
          _D_e_v_i_c_e may be ggggppppssss, mmmmccccdddd, tttteeeekkkk, or iiiimmmmaaaaggggeeeennnn.  The default is
          ----TTTTmmmmccccdddd,,,, which displays the output on the graphics screen
          by piping it through _m_c_d(1G).  Specifying ---- TTTTggggppppssss  sends
          output to the standard output in Masscomp Unix GPS for-
          mat.  Specifying ----TTTTtttteeeekkkk causes output to be sent to  the
          standard  output in Tektronix 4000-series format, and ----
          TTTTiiiimmmmaaaaggggeeeennnn plots it on an Imagen  laser  printer  in  Tek-
          tronix 4014 emulation mode.

     ----YYYY _l_o_w:_h_i_g_h
          Specifies exact lower and upper limits for the _y-axis.

EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     pppplllloooottttffffiiiieeeelllldddd ----ffff ssssppppeeeecccc____ppppaaaarrrraaaammmm ----rrrr5555 speech.fana

     plots the _s_p_e_c__p_a_r_a_m field from record 5 of speech.fana.

          pppplllloooottttffffiiiieeeelllldddd <_o_p_t_i_o_n_s> <_f_i_l_e_n_a_m_e>

     is equivalent to

          pppplllloooottttffffiiiieeeelllldddd ----TTTTggggppppssss <_o_p_t_i_o_n_s> <_f_i_l_e_n_a_m_e> |||| mmmmccccdddd

     The second form may be used if nondefault  options  for  _m_c_d
     are desired.





        Copyright Entropic Research Laboratory, Inc. 2G2        2






PLOTFIELD(1-ESPS)                           ENTROPIC RESEARCH LAB



EEEESSSSPPPPSSSS PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     No ESPS parameter file is read.

EEEESSSSPPPPSSSS CCCCOOOOMMMMMMMMOOOONNNN
     ESPS Common processing is disabled.

DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
     _P_l_o_t_f_i_e_l_d complains and exits if _f_i_l_e._f_e_a does not exist  or
     is  not  a FEA file.  It also exits if the nemaed field con-
     tains complex data.

IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN NNNNOOOOTTTTEEEE
     The current version of _f_i_e_l_d_p_l_o_t is implemented as  a  shell
     script  that  pipes  the  output  of _p_p_l_a_i_n (1-ESPS) through
     _t_e_s_t_s_d (1-ESPS) and _p_l_o_t_s_d (1-ESPS).  This is an example  of
     how  ESPS  programs  can  be  combined  with the "Unix tools
     approach" - see the simplified example on  the  _p_p_l_a_i_n  (1 -
     ESPS) man page.

EEEEXXXXPPPPEEEECCCCTTTTEEEEDDDD CCCCHHHHAAAANNNNGGGGEEEESSSS
     Many more options may be added.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     plotsd(1-ESPS) plotspec(1-ESPS), mlplot(1-ESPS),
     genplot(1-ESPS)

AAAAUUUUTTTTHHHHOOOORRRR
     Manual page by John Shore
     Program by Alan Parker


























        Copyright Entropic Research Laboratory, Inc. 3G3        3