foo

speech signal process tools

          printed  on  the  standard error output.  Larger values
          result in more output.  The default is 0, for  no  out-
          put.


</PRE>
<H2>ESPS PARAMETERS</H2><PRE>
     The parameter file is not required to be present,  as  there
     are  default  parameter values that apply.  If the parameter
     file does exist, the following parameters are read:

     <EM>start</EM> - <EM>integer</EM>

          The first point in the input sampled data file that  is
          processed.   A  value  of 1 denotes the first sample in
          the file.  This is only read if the <STRONG>-p</STRONG>  option  is  not
          used.   If it is not in the parameter (or Common) file,
          the default value of 1 is used.

     <EM>nan</EM> - <EM>integer</EM>



        Copyright Entropic Research Laboratory, Inc. 5G5        5

     <EM>frame</EM>_<EM>len</EM> - <EM>integer</EM>

          The number of points in each frame.  This parameter  is
          not  read  if the <STRONG>-l</STRONG> option is specified.  A value of 0
          indicates that a single frame of  length  <EM>nan</EM>  is  pro-
          cessed;   this  is  also  the  default  value  in  case
          <EM>frame</EM>_<EM>len</EM> is specified neither with the <STRONG>-l</STRONG>  option  nor
          in the parameter file.

     <EM>step</EM> - <EM>integer</EM>
          Initial points of consecutive  frames  differ  by  this
          number of samples.  This parameter is not read if the <STRONG>-</STRONG>
          <STRONG>S</STRONG> option is specified.  If the option is omitted and no
          value  is  found in the parameter file, a default equal
          to <EM>frame</EM>_<EM>len</EM> is  used  (resulting  in  exactly  abutted
          frames).

     <EM>window</EM>_<EM>type</EM> - <EM>string</EM>
          The data window to apply to the data.   This  parameter
          is not read if the command-line option <STRONG>-w</STRONG> is specified.
          If the option is omitted and if no value  is  found  in
          the  parameter  file, the default used is "RECT", for a
          rectangular window with amplitude one.   Other  accept-
          able  values  include "HAMMING", for Hamming, and "TRI-
          ANG", for triangular; see the  <STRONG><A HREF="../man3.html/window.3.html">window(3-ESPSsp)</A></STRONG>  manual
          page for the complete list.

     <EM>order</EM> - <EM>integer</EM>

          The number of reflection coefficients computed for each
          frame of input data.  If no value is given in the file,
          a default value of 15 is used.  This value is not  read
          if the command line option <STRONG>-o</STRONG> is used.

     <EM>method</EM> - <EM>string</EM>

          The spectrum analysis method  to  use.   The  available
          methods   are   autocorrelation   ("auto"),  covariance
          ("covar"), Burg ("burg"), modified Burg ("mburg"), fast
          modified  Burg  method  ("fburg"), stuctured covariance
          ("strcov" and "strcov1"), and vector Burg  ("vburg",  a
          fast  approximation  to  structured  covariance.  If no
          value is given in the file, the autocorrelation  method
          is  used  by  default.  The <EM>method</EM> is not read from the
          parameter file if the command line option <STRONG>-m</STRONG> is used.

     <EM>preemphasis</EM> - <EM>float</EM>




        Copyright Entropic Research Laboratory, Inc. 6G6        6
          If STRCOV is used, this is the convergence  test  value
          (the lower the value, the smaller the change per itera-
          tion before termination). This is not  read  if  <STRONG>-c</STRONG>  is
          used.

     <EM>strcov</EM>_<EM>maxiter</EM> - <EM>int</EM>

          If STRCOV is used, this is the maximum number of itera-
          tions allowed before the estimator terminates.  This is
          not read if <STRONG>-i</STRONG> is used.

     The values of parameters obtained from  the  parameter  file
     are printed if the environment variable ESPS_VERBOSE is 3 or
     greater.  The default value is 3.


</PRE>
<H2>ESPS COMMON</H2><PRE>
     ESPS Common is  read  provided  that  Common  processing  is
     enabled  and  that  the  <EM>filename</EM>  entry  in  Common matches
     <EM>file</EM>.<EM>sd</EM>, in which case parameters present in Common override
     values from the parameter file, which in turn may be overri-
     den by command line options  (see  the  discussion  in  ESPS
     PARAMETERS  and  under  each option).   Common processing is
     useful when <STRONG><A HREF="../man1.html/range.1.html">range (1-ESPS)</A></STRONG> is used to select a segment  from
     <EM>file</EM>.<EM>sd</EM>. Common is not read if <EM>file</EM>.<EM>sd</EM> is standard input. If
     <EM>file</EM>.<EM>rc</EM> is not standard output and <EM>file</EM>.<EM>sd</EM> is  not  standard
     input,  the  Common parameters <EM>filename</EM> (= file.sd), <EM>prog</EM> (=
     refcof), <EM>start</EM>, and <EM>nan</EM> are written to ESPS Common.

     ESPS Common  processing  may  be  disabled  by  setting  the
     environment  variable USE_ESPS_COMMON to "off".  The default
     ESPS Common file is .espscom in the user's  home  directory.
     This  may  be  overidden by setting the environment variable
     ESPSCOM to the desired path.  User feedback of  Common  pro-
     cessing   is   determined   by   the   environment  variable
     ESPS_VERBOSE, with 0 causing no feedback and increasing lev-
     els causing increasingly detailed feedback.  If ESPS_VERBOSE
     is not defined, a default value of 3 is assumed.


</PRE>
<H2>ESPS HEADER</H2><PRE>
     A new file header is created for the FEA_ANA file.  The sam-
     pled  data header from the input header is added as a source
     in the output file header, and the command line is added  as
     a  comment.   The input file <EM>file</EM>.<EM>sd</EM> is set as the reference
     header for tags.

     The program writes the usual values into the common part  of
     the  output  header. <EM>Refcof</EM> writes the following values into
     the specified generic header items  in  the  output  FEA_ANA



        Copyright Entropic Research Laboratory, Inc. 7G7        7

     <EM>maxpulses</EM> = 1
     <EM>maxraw</EM> = 1
     <EM>maxlpc</EM> = 1
     <EM>spec</EM>_<EM>rep</EM> = RC
     <EM>start</EM> = start
     <EM>nan</EM> = nan;
     <EM>frmlen</EM> = frame_len;
     <EM>src</EM>_<EM>sf</EM> = sample frequency of file.sd

     In addition, the following generic header items are  created
     and  filled with values used by <EM>refcof</EM>: <EM>method</EM>, <EM>window</EM>_<EM>type</EM>,
     <EM>DC</EM>_<EM>removed</EM>, <EM>step</EM>.  All of these are CODED types, except  for
     <EM>step</EM>,  which  is  LONG.  If a non-zero preemphasis factor is
     used, then the header item <EM>preemphasis</EM> of FLOAT type is also
     written.

     The generic header item <EM>start</EM>_<EM>time</EM> (type DOUBLE) is  written
     in the output file.  The value written is computed by taking
     the <EM>start</EM>_<EM>time</EM> value from the header of the input  file  (or
     zero,  if such a header item doesn't exist) and adding to it
     the offset time (from the beginning of the  input  file)  of
     the  first point processed plus one half of <EM>frame</EM>_<EM>len</EM> (thus,
     <EM>start</EM>_<EM>time</EM> is middle of the first frame, which is  appropri-
     ate  since  the  output  data  represent  the  entire frame;
     without this adjustment for <EM>frame</EM>_<EM>len</EM>, <EM>waves</EM>+ displays would
     not line up properly.

     The generic header item <EM>record</EM>_<EM>freq</EM> (type DOUBLE) is written
     in  the  output  file.   The  value  is the number of output
     records per second of input data.


</PRE>
<H2>SEE ALSO</H2><PRE>
     <STRONG><A HREF="../man1.html/get_resid.1.html">get_resid (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/mask.1.html">mask (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/get_f0.1.html">get_f0 (1-ESPS)</A></STRONG>,
     <STRONG><A HREF="../man1.html/ps_ana.1.html">ps_ana (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/transpec.1.html">transpec (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/spectrans.1.html">spectrans (1-ESPS)</A></STRONG>,
     <STRONG><A HREF="../man1.html/me_spec.1.html">me_spec (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/plotspec.1.html">plotspec (1- ESPS)</A></STRONG>,  <STRONG><A HREF="../man1.html/exprompt.1.html">exprompt  (1 - ESPS)</A></STRONG>,
     <STRONG><A HREF="../man1.html/expromptrun.1.html">expromptrun (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/fft.1.html">fft (1-ESPS)</A></STRONG>, <STRONG><A HREF="../man3.html/compute_rc.3.html">compute_rc (3-ESPSsp)</A></STRONG>,
     <STRONG><A HREF="../man5.html/FEA_ANA.5.html">FEA_ANA (5-ESPS)</A></STRONG>, <STRONG><A HREF="../man5.html/FEA.5.html">FEA (5-ESPS)</A></STRONG>, <STRONG><A HREF="../man5.html/FEA_SD.5.html">FEA_SD (5-ESPS)</A></STRONG>,



</PRE>
<H2>BUGS</H2><PRE>
     The program will not yet compute reflection coefficients  of
     complex  signals;  if  presented with complex input data, it
     will silently discard the imaginary part and compute reflec-
     tion coefficients of the real part of the input.


</PRE>
<H2>FUTURE CHANGES</H2><PRE>
     The program will be expanded to include  other  methods  for
     calculating  the autocorrelation function and the reflection



        Copyright Entropic Research Laboratory, Inc. 8G8        8
          <EM>Speech</EM> <EM>Signals</EM>, Prentice Hall, NJ. 1978.

     [2]  J.P.Burg, D.G.Luenberger,  D.L.Wenger,  "Estimation  of
          Structured  Covariance  Matrices"  <EM>Proceedings</EM>  <EM>of</EM>  <EM>the</EM>
          <EM>IEEE</EM>, Vol. 70, No. 9 September 1982

     [3]  Shankar Narayan and J.P. Burg, "Spectral Estimation  of
          Quasi-Periodic  Data",  <EM>Proceedings</EM> <EM>ICASSP</EM> <EM>87</EM>, pp. 944-
          947.



</PRE>
<H2>AUTHOR</H2><PRE>
     Original program by Brian Sublett.

     Modified extensively by John Shore.




































        Copyright Entropic Research Laboratory, Inc. 9G9        9
</PRE>
</BODY>
</HTML>