/**MAN





























































SFS                     Last change: UCL                        1






ES(SFS1)          MISC. REFERENCE MANUAL PAGES           ES(SFS1)



NAME
     Es - interactive device-independent data display

SYNOPSIS
     Es (-i item) (-a item) (-s start) (-e end) (-f item  lo  hi)
     (-l labelname) (-12|-0) (-g spectitem) (-t) (-m) file

DESCRIPTION
     Es is a program to display portions of data sets in  a  file
     using device-independent graphics.  Mouse interaction allows
     selective expansion of regions of the display, and replay of
     speech  items.  Options allow for the selection of items and
     the initial display  of  part  of  the  timescale.   Default
     operation  is  to display all items in file.  Es may also be
     used to add/edit annotations using the '-l' option.

     Options and their meanings are:

     -I         Identify program and exit.

     -iitem     Select first item matching item specification.

     -atype     Select all items matching item specification.

     -gspitem   Select a speech item for display as a spectrogram
                using on-line FFT.

     -t         Start up with file processing  tree  display  for
                item selection.

     -sstart    Specify a start time (in seconds) other than 0.0.

     -eend      Specify an end time (in seconds) other  than  the
                length  of the first speech item in the file.  If
                no speech item  found,  default  timescale  is  1
                second.

     -fitem lo hi
                Fix all displays of a given type to  the  y-range
                lo..hi.

     -llabelname
                Select  labelling  mode:  an  annotation  editing
                facility.  The  annotations  to be edited must be
                given a name (labelname) that is  stored  in  the
                history  for  the  annotation  data  set.  If any
                existing annotation items in the  file  have  the
                same name (i.e. with "type=<name>" in the history
                field), the last is used as the initial  contents
                of the annotation data set.

     -12        Specify that all SP  items  otherwise  'unmarked'



SFS                     Last change: UCL                        1






ES(SFS1)          MISC. REFERENCE MANUAL PAGES           ES(SFS1)



                will  be  treated  as 12-bits (-2048..2047).  The
                marking is shown by a parameter  field  entry  of
                "bits=12"  or  "bits=16".   Default: all unmarked
                items are treated as containing 16-bit data.

     -m         Select  measurement  mode.   Cursor  position  is
                displayed  in time and frequency in area normally
                used for bottom timescale.

     -0         Disable replay.

MOUSE COMMANDS
  LEFT
     Set "start" marker.  For accurate placement, use '<' and '>'
     keys in combination with mouse.

  RIGHT
     Set "stop" marker.

  MIDDLE
     Replay selected segment.   Appropriate  speech  item  chosen
     automatically.  In labelling mode, the region to be replayed
     depends on the mouse location; normally the  region  between
     cursors  is  replayed  wherever the mouse is positioned.  SY
     items  are  replayed  through  hardware  synthesizer  or  by
     software  emulation of the SRU synthesizer (see hwsynth(3)).
     To move an annotation in labelling mode,  click  the  middle
     button over the annotation in the annotation edit window and
     then the annotation will jump to the position  indicated  by
     the  next  click  of the left or right buttons (or on hit of
     RETURN key).  To deselect, click the middle  button  outside
     the annotation edit window.

MAIN MENU
  QUIT
     (Any button, 'q', 'x', ESCAPE) Quit program.

  FILE
     (Any button, 'f') Display file sub-menu.

  PLAY
     (Any button, 'p') Play region of signal between cursors.  Or
     'o'  plays  region to left cursor, and '[' plays region from
     right cursor.  The speech item selected for  replay  is  the
     one  under  the  last  known mouse position - note that this
     means that the 'play'  button  cannot  be  selected  by  the
     mouse!

  MOVE
     (Left button, 'l') Scroll left. "stop" marker sets new right
     margin  if  present.   (Right  button,  'r')  Scroll  right.
     "start" marker sets new left  margin  if  present.   (Middle



SFS                     Last change: UCL                        2






ES(SFS1)          MISC. REFERENCE MANUAL PAGES           ES(SFS1)



     button, 'u') Undo previous "zoom".  ('t') Go to top level of
     zoom.

  ZOOM
     (Any button, 'z') Zoom in to selected  region.   Or  'g'  to
     goto  a  particular  time  in  the file; you are prompted to
     enter the time.

  ANNO
     (Any button, 'a'.  Labelling mode only) Add an annotation at
     the  current  position of the left cursor.  Type the name of
     the annotation and press [RETURN].  To replace  an  existing
     annotation,  position  the cursor on top of it, key 'a', the
     new annotation label and [RETURN].  To  delete  an  existing
     annotation,  position  the  cursor on top of it, key 'a' and
     type [RETURN] only.  Or 'b' to input an  annotation  at  the
     right cursor.

FILE MENU
  MAIN
     (Any button, 'q', 'x', 'm', ESCAPE or RETURN) Return to Main
     menu.

  HARD
     (Any button, 'h' or 'p') Print screen ("Hardcopy").

  TREE
     (Any button, 't') Display  file  history  tree  to  reselect
     items for display.

  COPY
     (Any button, 'c') Copy displayed section of displayed  items
     to  a  new  file.   (Currently  only some items types may be
     copied).

  LINK
     (Any button, 'l') Link displayed section of displayed  items
     to  a  new  file.   (Currently  only some items types may be
     linked).

TREE MENU
  OK
     (Any button, 'q', 'x', 'o', ESCAPE,  RETURN)  Accept  selec-
     tions and return to Es display.

  HARD
     (Any button, 'p', 'h') Print hard copy of file history tree.
     Not yet implemented.

  ALL
     (Any button, 'a') Select all items.




SFS                     Last change: UCL                        3






ES(SFS1)          MISC. REFERENCE MANUAL PAGES           ES(SFS1)



  ZERO
     (Any button, 'z') Clear selection of items.

INPUT ITEMS
     1.xx       Any speech item.  Displayed as waveform with '-a'
                or   '-i'  switches,  as  spectrogram  with  '-g'
                switch.

     2.xx       Any excitation item.  Displayed as waveform.

     3.xx       Any period data item.  Displayed at period  mark-
                ers.

     4.xx       Any fundamental frequency item.  Displayed as  fx
                trace on linear scale.

     5.xx       Any annotation item.  Displayed as markers.

     7.xx       Any synthesizer control data item.  Displayed  in
                graphical form.

     9.xx       Fixed  frame  Display   data   in   SFS   format.
                Displayed as grey scale.

     10.xx      Voice/Unvoiced markers. Voicing displayed as  "V"
                annotations.

     11.xx      Any coefficient data item.  Displayed as spectra.

     12.xx      Any raw formant  estimates  item.   Displayed  as
                numbered points.

     16.xx      Any parameter track item.  Displayed as trace.

     Other items are merely noted in the display.

OUTPUT ITEMS
     5          Edited annotations.

ENVIRONMENT
     The terminal type is determined from the  environment  vari-
     able GTERM if present, which is used to configure the graph-
     ics using the information in $SFSBASE/data/digmap.  If GTERM
     is  not  set,  then  the TERM variable is used.  The default
     printer is selected from the  environment  variable  GPRINT,
     which  is  used  to  configure  the  printed  graphics using
     $SFSBASE/data/digmap.  If GPRINT is not set, it  is  assumed
     to  have  the  value  'printer'.   The replay device type is
     determined from the environment variable DAC, which is  used
     to configure the replay according to a table built in to the
     software (sfsdac.c).  If DAC is not set, no replay is avail-
     able.



SFS                     Last change: UCL                        4






ES(SFS1)          MISC. REFERENCE MANUAL PAGES           ES(SFS1)



VERSION/AUTHOR
     3.3 - Mark Huckvale

SEE ALSO
     Ds(SFS1) dig(SFS3) dig(SFS1) */

SOURCE
     /users/mark/sfs/man/../util/es.c















































SFS                     Last change: UCL                        5



