cat

speech signal process tools

     ----zzzz    Specifies that /fIrefcof/fP operate silently,  without
          issuing various warnings.

     ----xxxx _d_e_b_u_g__l_e_v_e_l [0]
          A positive value specifies  that  debugging  output  be
          printed  on  the  standard error output.  Larger values
          result in more output.  The default is 0, for  no  out-
          put.

EEEESSSSPPPPSSSS PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     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:

     _s_t_a_r_t - _i_n_t_e_g_e_r

          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 ----pppp  option  is  not
          used.   If it is not in the parameter (or Common) file,
          the default value of 1 is used.

     _n_a_n - _i_n_t_e_g_e_r



        Copyright Entropic Research Laboratory, Inc. 5G5        5






REFCOF(1-ESPS)                              ENTROPIC RESEARCH LAB



          The total number of data points to process.  If _n_a_n  is
          0, the whole file is processed. _N_a_n is read only if the
          ----pppp option is not used.  (See the discussion under ----llll).

     _f_r_a_m_e__l_e_n - _i_n_t_e_g_e_r

          The number of points in each frame.  This parameter  is
          not  read  if the ----llll option is specified.  A value of 0
          indicates that a single frame of  length  _n_a_n  is  pro-
          cessed;   this  is  also  the  default  value  in  case
          _f_r_a_m_e__l_e_n is specified neither with the ----llll  option  nor
          in the parameter file.

     _s_t_e_p - _i_n_t_e_g_e_r
          Initial points of consecutive  frames  differ  by  this
          number of samples.  This parameter is not read if the ----
          SSSS option is specified.  If the option is omitted and no
          value  is  found in the parameter file, a default equal
          to _f_r_a_m_e__l_e_n is  used  (resulting  in  exactly  abutted
          frames).

     _w_i_n_d_o_w__t_y_p_e - _s_t_r_i_n_g
          The data window to apply to the data.   This  parameter
          is not read if the command-line option ----wwww 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  window(3-ESPSsp)  manual
          page for the complete list.

     _o_r_d_e_r - _i_n_t_e_g_e_r

          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 ----oooo is used.

     _m_e_t_h_o_d - _s_t_r_i_n_g

          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 _m_e_t_h_o_d is not read from the
          parameter file if the command line option ----mmmm is used.

     _p_r_e_e_m_p_h_a_s_i_s - _f_l_o_a_t




        Copyright Entropic Research Laboratory, Inc. 6G6        6






REFCOF(1-ESPS)                              ENTROPIC RESEARCH LAB



          The preemphasis factor to be applied to input signal.

     _s_t_r_c_o_v__t_e_s_t - _f_l_o_a_t

          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  ----cccc  is
          used.

     _s_t_r_c_o_v__m_a_x_i_t_e_r - _i_n_t

          If STRCOV is used, this is the maximum number of itera-
          tions allowed before the estimator terminates.  This is
          not read if ----iiii 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.

EEEESSSSPPPPSSSS CCCCOOOOMMMMMMMMOOOONNNN
     ESPS Common is  read  provided  that  Common  processing  is
     enabled  and  that  the  _f_i_l_e_n_a_m_e  entry  in  Common matches
     _f_i_l_e._s_d, 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 _r_a_n_g_e (1-ESPS) is used to select a segment  from
     _f_i_l_e._s_d. Common is not read if _f_i_l_e._s_d is standard input. If
     _f_i_l_e._r_c is not standard output and _f_i_l_e._s_d is  not  standard
     input,  the  Common parameters _f_i_l_e_n_a_m_e (= file.sd), _p_r_o_g (=
     refcof), _s_t_a_r_t, and _n_a_n 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.

EEEESSSSPPPPSSSS HHHHEEEEAAAADDDDEEEERRRR
     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 _f_i_l_e._s_d is set as the reference
     header for tags.

     The program writes the usual values into the common part  of
     the  output  header. _R_e_f_c_o_f writes the following values into
     the specified generic header items  in  the  output  FEA_ANA



        Copyright Entropic Research Laboratory, Inc. 7G7        7






REFCOF(1-ESPS)                              ENTROPIC RESEARCH LAB



     file:

     _o_r_d_e_r__v_c_d = 0
     _o_r_d_e_r__u_n_v_c_d = order
     _m_a_x_p_u_l_s_e_s = 1
     _m_a_x_r_a_w = 1
     _m_a_x_l_p_c = 1
     _s_p_e_c__r_e_p = RC
     _s_t_a_r_t = start
     _n_a_n = nan;
     _f_r_m_l_e_n = frame_len;
     _s_r_c__s_f = sample frequency of file.sd

     In addition, the following generic header items are  created
     and  filled with values used by _r_e_f_c_o_f: _m_e_t_h_o_d, _w_i_n_d_o_w__t_y_p_e,
     _D_C__r_e_m_o_v_e_d, _s_t_e_p.  All of these are CODED types, except  for
     _s_t_e_p,  which  is  LONG.  If a non-zero preemphasis factor is
     used, then the header item _p_r_e_e_m_p_h_a_s_i_s of FLOAT type is also
     written.

     The generic header item _s_t_a_r_t__t_i_m_e (type DOUBLE) is  written
     in the output file.  The value written is computed by taking
     the _s_t_a_r_t__t_i_m_e 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 _f_r_a_m_e__l_e_n (thus,
     _s_t_a_r_t__t_i_m_e is middle of the first frame, which is  appropri-
     ate  since  the  output  data  represent  the  entire frame;
     without this adjustment for _f_r_a_m_e__l_e_n, _w_a_v_e_s+ displays would
     not line up properly.

     The generic header item _r_e_c_o_r_d__f_r_e_q (type DOUBLE) is written
     in  the  output  file.   The  value  is the number of output
     records per second of input data.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     _g_e_t__r_e_s_i_d (1-ESPS), _m_a_s_k (1-ESPS), _g_e_t__f_0 (1-ESPS),
     _p_s__a_n_a (1-ESPS), _t_r_a_n_s_p_e_c (1-ESPS), _s_p_e_c_t_r_a_n_s (1-ESPS),
     _m_e__s_p_e_c (1-ESPS), _p_l_o_t_s_p_e_c (1- ESPS),  _e_x_p_r_o_m_p_t  (1 - ESPS),
     _e_x_p_r_o_m_p_t_r_u_n (1-ESPS), _f_f_t (1-ESPS), _c_o_m_p_u_t_e__r_c (3-ESPSsp),
     FEA_ANA (5-ESPS), FEA (5-ESPS), FEA_SD (5-ESPS),


BBBBUUUUGGGGSSSS
     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.

FFFFUUUUTTTTUUUURRRREEEE CCCCHHHHAAAANNNNGGGGEEEESSSS
     The program will be expanded to include  other  methods  for
     calculating  the autocorrelation function and the reflection



        Copyright Entropic Research Laboratory, Inc. 8G8        8






REFCOF(1-ESPS)                              ENTROPIC RESEARCH LAB



     coefficients than those currently employed.

RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
     [1]  L. R. Rabiner and R. W. Schafer, _D_i_g_i_t_a_l _P_r_o_c_e_s_s_i_n_g  _o_f
          _S_p_e_e_c_h _S_i_g_n_a_l_s, Prentice Hall, NJ. 1978.

     [2]  J.P.Burg, D.G.Luenberger,  D.L.Wenger,  "Estimation  of
          Structured  Covariance  Matrices"  _P_r_o_c_e_e_d_i_n_g_s  _o_f  _t_h_e
          _I_E_E_E, Vol. 70, No. 9 September 1982

     [3]  Shankar Narayan and J.P. Burg, "Spectral Estimation  of
          Quasi-Periodic  Data",  _P_r_o_c_e_e_d_i_n_g_s _I_C_A_S_S_P _8_7, pp. 944-
          947.


AAAAUUUUTTTTHHHHOOOORRRR
     Original program by Brian Sublett.

     Modified extensively by John Shore.




































        Copyright Entropic Research Laboratory, Inc. 9G9        9