cat

speech signal process tools

PLOT3D(1-ESPS)                              ENTROPIC RESEARCH LAB



NNNNAAAAMMMMEEEE
     plot3d - interactive 3-d plots (perspective plots with  hid-
     den lines removed) of data from FEA files.

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     ppppllllooootttt3333dddd [ ----dddd _d_e_p_t_h ] [ ----ffff """"_f_i_e_l_d[[[[_r_a_n_g_e]]]]"""" ] [ ----oooo _o_r_i_e_n_t_a_t_i_o_n ]
     [ ----rrrr _r_a_n_g_e ] [ ----xxxx _d_e_b_u_g__l_e_v_e_l ] [ ----BBBB _l_e_n_g_t_h,,,,_w_i_d_t_h,,,,_h_e_i_g_h_t ] [
      ---- IIII  {aaaaAAAAbbbbBBBBccccCCCCppppPPPP} . . .   ]  [   ---- PPPP   _p_a_r_a_m   ]   [     ----  RRRR
     _b_e_a_r_i_n_g,,,,_e_l_e_v_a_t_i_o_n,,,,_r_o_t_a_t_i_o_n ] [ ----SSSS _h__s_k_e_w::::_v__s_k_e_w ] [ ----wwww ] [ ----
     MMMM ] _f_i_l_e

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _p_l_o_t_3_d reads data from a specified field of an ESPS FEA file
     and  constructs  a three-dimensional plot of the data versus
     two  independent  variables.   A  plot  of  data  from   the
     _r_e__s_p_e_c__v_a_l  field  of  a  FEA_SPEC file, for example, could
     show time along one axis, frequency along another axis,  and
     spectral  power  density  (or its log) along the third axis.
     In general, the _x-axis corresponds to the order  of  records
     in the file, the _y-axis corresponds to the order of elements
     in the field, and the _z-axis  represents  the  data  values.
     The  three-dimensional  plot  is rendered in a window on the
     screen as a perspective drawing.

     The user has complete control over the scaling, orientation,
     depth  of perspective, and angle of view of the plot.  These
     plotting  parameters  are  set  initially  by   command-line
     options or values in an ESPS parameter file, but they can be
     adjusted interactively with mouse-operated sliders and other
     controls  in a control-panel window, or with mouse movements
     in the plot window.  Operating the controls causes  a  wire-
     frame  drawing  of  the bounding box of the plot to move and
     change size accordingly, and clicking on  a  button  in  the
     control-panel  window causes the plot to be redrawn with the
     new parameters.  The current set of parameters can be  saved
     to  a  file  so that other plots may later be drawn with the
     same viewpoint.  Saved parameter sets may be loaded  from  a
     file at any time.

     Data may be loaded from a file interactively; the file name,
     range  of records to be read, field name, and range of items
     in the field may all be respecified.

     A moving cursor, controlled by the mouse, allows the coordi-
     nates of points of the graph to be read off numerically.

     In addition to the display on the user's  screen;  the  plot
     image  may  be saved in a file, so that it can be printed or
     imported into a word processing system.  The plot image  can
     be  saved  as either PostScript or PCL.   It can be directly
     sent to a printer, if there is no need  to  save  the  image
     file.



        Copyright Entropic Research Laboratory, Inc. 1G1        1






PLOT3D(1-ESPS)                              ENTROPIC RESEARCH LAB



OOOOPPPPTTTTIIIIOOOONNNNSSSS
     The following options are supported.  Values in brackets are
     defaults.

     ----dddd _d_e_p_t_h [50]
          Depth of perspective.  A value of 0 corresponds to pro-
          jection   of   the   3-dimensional  plot  onto  the  2-
          dimensional   plotting   surface   from   an   infinite
          distancei.e.   parallel projection.  Positive values of
          _d_e_p_t_h correspond to projection from  inversely  propor-
          tional finite distances with the result that foreground
          features are shown at  a  somewhat  larger  scale  than
          features farther from the viewer.  The default value of
          50 is reasonable for normal viewing  distances.   Large
          values produce highly exaggerated perspective effects.

     ----ffff """"_f_i_e_l_d[[[[_r_a_n_g_e]]]]"""" ["re_spec_val[0:<_l_a_s_t>]"]

     ----ffff _f_i_e_l_d
          Name of a field in an ESPS FEA file and range  of  ele-
          ments in field to be plotted.  (Numbering of field ele-
          ments starts with 0.)  The quotes are  needed  only  to
          suppress  the  shell's  usual special interpretation of
          brackets.  The bracketed _r_a_n_g_e, if  present,  may  have
          any of the forms acceptable to _r_a_n_g_e__s_w_i_t_c_h(3-ESPSu).

          _e_l_e_m_e_n_t
               A single integer specifies a single field  element
               (not at present useful with _p_l_o_t_3_d).

          _f_i_r_s_t::::_l_a_s_t
               A pair of integers specifies an inclusive range of
               elements.

          _f_i_r_s_t::::++++_i_n_c_r
               The form with  the  plus  sign  is  equivalent  to
               _f_i_r_s_t::::_l_a_s_t with _l_a_s_t = _f_i_r_s_t + _i_n_c_r.

          If the specified range contains elements not present in
          the field, the range is reduced as necessary.

     ----oooo _o_r_i_e_n_t_a_t_i_o_n [L]
          Left-handed coordinate  system  ("L")  or  right-handed
          ("R")?   When  the  axes  are  in their default initial
          position, record number increases  with  distance  from
          the  viewer,  element  number  increases  from  left to
          right, and data values increase in  the  upward  direc-
          tion.   For some possible positions, a mirror-reflected
          orientation  may  seem  more  natural.   Specifying   _R
          instead  of _L effectively reverses the direction of the
          _y (element number) axis.




        Copyright Entropic Research Laboratory, Inc. 2G2        2






PLOT3D(1-ESPS)                              ENTROPIC RESEARCH LAB



     ----rrrr _r_a_n_g_e [1:<_e_n_d _o_f _f_i_l_e>]
          Range of records in the file to  be  read  and  plotted
          (counting  the first as number 1.)  The allowable forms
          for _r_a_n_g_e are those for _r_a_n_g_e__s_w_i_t_c_h(3-ESPSu); see  the
          discussion  of   ---- ffff  above  or the _r_a_n_g_e__s_w_i_t_c_h manual
          entry.

     ----xxxx _d_e_b_u_g__l_e_v_e_l [0]
          Values greater than 0 cause various debugging  messages
          to  be printed as the program runs.  Larger values call
          out more messages.  The default level of  0  suppresses
          all debugging messages.

     ----BBBB _l_e_n_g_t_h,,,,_w_i_d_t_h,,,,_h_e_i_g_h_t [400,250,150]
          Dimensions, in pixels, of a rectangular box that bounds
          the 3-d plot (except for axis labels and the like).

     ----IIII {aaaaAAAAbbbbBBBBccccCCCCppppPPPP} . . . [abcp]
          Initial actions, taken when the plot  window  is  first
          brought  up.   Draw  axes (a, A), draw bounding box (b,
          B), bring up control panel (c, C), or plot data (p, P).
          A  lower-case  letters (a, b, c, p) invokes the action,
          and upper-case (A, B, C, P) suppresses it.

     ----PPPP _p_a_r_a_m__f_i_l_e [params]
          Name of parameter file to be read initially.

     ----RRRR _b_e_a_r_i_n_g,,,,_e_l_e_v_a_t_i_o_n,,,,_r_o_t_a_t_i_o_n [45.00,35.26,0.00]
          Three angles of rotation  (measured  in  degrees)  that
          describe  the  relative  positions of the 3-dimensional
          plot and the 2-dimensional plotting window.  The  _b_e_a_r_-
          _i_n_g  and _e_l_e_v_a_t_i_o_n determine the direction, relative to
          the 3-d coordinate system, of the line  normal  to  the
          window  at  its  center.  Changing the bearing lets you
          look at the plot from various sides, and increasing the
          elevation  lets you look at it from the top.  The third
          degree of freedom, ``_r_o_t_a_t_i_o_n,'' corresponds to a rota-
          tion  about the line normal to the window at its center
          and for most purposes is probably best set equal to 0.

     ----SSSS _h__s_k_e_w::::_v__s_k_e_w [0,0]
          Changing _h__s_k_e_w moves the front parts of the  plot  one
          way  horizontally  and  the  back parts of the plot the
          opposite way, in proportion to the distance forward  or
          back with respect to the plane of the plot window.  The
          effect is somewhat similar to adjusting  _b_e_a_r_i_n_g  ( ---- RRRR
          above)  in  that  both  adjustments let you see more or
          less of the left or right side of the  plot.   However,
          adjusting  _h__s_k_e_w  does not produce a rotation:  planes
          parallel to the plane of the  plot  window  remain  so.
          Similarly, changing _v__s_k_e_w moves the front parts of the
          plot one way vertically and the back part of  the  plot



        Copyright Entropic Research Laboratory, Inc. 3G3        3






PLOT3D(1-ESPS)                              ENTROPIC RESEARCH LAB



          the  opposite  way.   The effect is somewhat similar to
          adjusting _e_l_e_v_a_t_i_o_n in that both  adjustments  let  you
          see  more  or  less  of  the top of the plot.  However,
          adjusting _v__s_k_e_w does not produce a rotation of  planes
          parallel to the plot window.

     ----wwww    This option causes _p_l_o_t_3_d to attempt to connect to  an
          _x_w_a_v_e_s+(1 - ESPS) running with its server mode enabled.
          If this connection is made, then _p_l_o_t_3_d will send  cur-
          sor  movement  commands  to  _x_w_a_v_e_s+ to maintain cursor
          time alignment between the view in _p_l_o_t_3_d and the  view
          in _x_w_a_v_e_s+.   Note that _p_l_o_t_3_d has no way of knowing if
          the files  being  viewed  in  _p_l_o_t_3_d  and  _x_w_a_v_e_s+  are
          related  and if the time alignment makes sense.  A side
          effect of invoking this mode is to put  the  axis  into
          time  and  frequency display mode.   If the information
          in the displayed file cannot support this mode then the
          ----wwww  option  is ignored.   For example, if the displayed
          file has no _r_e_c_o_r_d__f_r_e_q generic  then  then  it  cannot
          send time cursor movements to _x_w_a_v_e_s+. If the displayed
          file, is not a FEA_SPEC file, then it cannot send  fre-
          quency cursor movements to _x_w_a_v_e_s+.

          When this option  is  used,  the  environment  variable
          WWWWAAAAVVVVEEEESSSS____HHHHOOOOSSSSTTTT  is  read  to determine the name of the host
          that is running the _x_w_a_v_e_s server.   If  WWWWAAAAVVVVEEEESSSS____HHHHOOOOSSSSTTTT  is
          undefined,  then  the  connection  is  attempted  to an
          _x_w_a_v_e_s+ on the same host as _p_l_o_t_3_d is running on.   The
          default socket port number of the attempt is determined
          by a ESPS wide default which is compiled in.    If  the
          environment  variable  WWWWAAAAVVVVEEEESSSS____PPPPOOOORRRRTTTT  is defined, then its
          value is used instead as the socket port. This  program
          uses  the  facility  of  _s_e_n_d__x_w_a_v_e_s(3 -ESPS).  See its
          manual page for details.

     ----MMMM    This option forces _p_l_o_t_3_d to paint everything in black
          and  white (monochrome), useful if you're doing screen-
          dumps.



EEEESSSSPPPPSSSS PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     The parameter file is not required to be present,  as  there
     are  default values for all parameters.  If the file exists,
     the parameters below may be read.  These provide an alterna-
     tive  way  of  specifying quantities that can also be deter-
     mined by command-line options.  The general rule is that  if
     a  command-line option is specified, it takes precedence; if
     the command-line option is not specified, then the parameter
     file  is consulted; and if a quantity is not given either on
     the command line or in the parameter file, then a default is
     used.   Eventually  this program will support parameter-file



        Copyright Entropic Research Laboratory, Inc. 4G4        4






PLOT3D(1-ESPS)                              ENTROPIC RESEARCH LAB



     entries corresponding to all command-line options except ---- xxxx
     and ----PPPP.  These parameters may also be adjusted interactively
     from the control panel.  Current values may be  saved  to  a
     file,  and new values may be read from a file interactively.
     (See the discussion of the _l_o_a_d _p_a_r_a_m_s and _s_a_v_e _p_a_r_a_m_s items
     on  the  _f_i_l_e_s  button  menu under "Control Panel and Menus"
     below.

     _b_o_x__l_e_n_g_t_h - _i_n_t_e_g_e_r

     _b_o_x__w_i_d_t_h - _i_n_t_e_g_e_r

     _b_o_x__h_e_i_g_h_t - _i_n_t_e_g_e_r
          These correspond to the arguments  _l_e_n_g_t_h,  _w_i_d_t_h,  and
          _h_e_i_g_h_t of the ----BBBB option.

     _d_e_p_t_h - _f_l_o_a_t
          This corresponds to the argument of the ----dddd option.

     _h_o_r_i_z_o_n_t_a_l__s_k_e_w - _f_l_o_a_t

     _v_e_r_t_i_c_a_l__s_k_e_w - _f_l_o_a_t
          These correspond to the arguments _h__s_k_e_w and _v__s_k_e_w  of
          the ----SSSS option.

     _o_r_i_e_n_t_a_t_i_o_n - _s_t_r_i_n_g
          This corresponds to the argument of the ----oooo option.