cat

speech signal process tools

     standard  output,  the  program writes the Common parameters
     _p_r_o_g, _f_i_l_e_n_a_m_e, _s_t_a_r_t, and _n_a_n to record the program's name,
     the  name  of the output file, the starting record number of
     the output file (always 1), and the number of points in  the
     output file.

     ESPS Common  processing  may  be  disabled  by  setting  the
     environment  variable  USE_ESPS_COMMON  to  _o_f_f. The default
     ESPS Common file is _e_s_p_s_c_o_m 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 HHHHEEEEAAAADDDDEEEERRRRSSSS
     The  output  header  is  a  new  FEA_SD  file  header,  with
     appropriate items copied from the input headers.

     The generic header item "record_freq", which must  have  the
     same  value  in  all  input files, is copied into the output
     header.





        Copyright Entropic Research Laboratory, Inc. 4G4        4






MUX(1-ESPS)                                 ENTROPIC RESEARCH LAB



     The generic header item "start_time"  records  the  starting
     time  for each output channel.  It is a single number if all
     output channels have the same starting time; otherwise it is
     a  vector  with  one element per channel.  The starting time
     for a channel is its starting time in the input file plus an
     offset  in  case  the  data taken from the input file do not
     start with the first record.  The offset is given by (_r-1)/_f
     where  _r is the starting record number in the input file and
     _f is the  sampling  frequency  given  by  the  "record_freq"
     header  item.   The   ---- JJJJ option can create complex channels
     whose real and imaginary parts  have  inconsistent  starting
     times.  When that happens, a warning message is printed, and
     the starting time for the  real  part  is  recorded  in  the
     "start_time" header item.

     If every input file has a "max_value" header item, then  the
     output  file  has  a  "max_value" header item containing the
     same information.

EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     Multiplex data from three input files to produce  an  output
     file  _x_x_x.  Processing  begins  with the sampled data in the
     first record in each input file.  The output  file  has  the
     same length as the shortest input file.

          _m_u_x _a_a_a _b_b_b _c_c_c _x_x_x

     Start at time 0.5 in each input file and process 0.5 seconds
     of  data from each.  (Suppose the sampling frequency is 8000
     Hz, and the start times in the three input  files  are  0.0,
     0.0,  and  0.5.   Then the starting record numbers are 4001,
     4001, and 1, respectively.  The start  time  in  the  output
     file is 0.5 for all channels.)

          _m_u_x -_s_0._5:_1._0 _a_a_a _b_b_b _c_c_c _x_x_x

     Start at time 0.5 in file _a_a_a and with the first  record  in
     the  other  two  input  files.  (With the assumptions of the
     previous example, the starting record numbers in  the  three
     input  files  are  4001,  1, and 1, respectively.  The start
     times in the output file header are 0.5 for data from  files
     _a_a_a and _c_c_c and 0.0 for data from file _b_b_b.)

          _m_u_x -_s_0._5: -_p_1: _a_a_a _b_b_b _c_c_c _x_x_x

     Juxtapose data from an input file with  a  test  signal  and
     pass the result to another program.

          _t_e_s_t_s_d - | _m_u_x _a_a_a - - | _m_o_r_e__p_r_o_c_e_s_s_i_n_g -

     If _a_a_a has two channels of real data, this will  convert  it
     to a single-channel file _z_z_z of complex data.



        Copyright Entropic Research Laboratory, Inc. 5G5        5






MUX(1-ESPS)                                 ENTROPIC RESEARCH LAB



          _m_u_x -_J _a_a_a _z_z_z

     If _a_a_a and _b_b_b are single-channel files of real  data,  this
     will join them into a single-channel file of complex data.

          _m_u_x -_J _a_a_a _b_b_b _z_z_z

     Multiplex a portion of a file with a later  portion  of  the
     same file.

          _m_u_x -_p_1_0_0_1:_2_0_0_0 -_p_2_5_0_1: _a_a_a _a_a_a _x_x_x

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     demux(1-ESPS), copysps(1-ESPS), addgen(1-ESPS),
     FEA_SD(5-ESPS), FEA(5-ESPS)

DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
     The program exits with an error message if any of  the  fol-
     lowing occur.
       The command line cannot be parsed.
       Fewer than two file names are specified (one in, one out).
       Fewer input file names are specified than ----pppp, ----rrrr, and  ---- ssss
     options.
       More than one input file name is ``-''.
       An input file cannot be opened or is not an ESPS  sampled-
     data file.
       The input files do not all have  the  same  sampling  fre-
     quency.
       The input files do not all have the same data type.
       The ----JJJJ option is specified with input files of  a  complex
     data type.
       The ----JJJJ option is specified, and the total number of  input
     channels is odd.
       A starting record specified with a ----pppp, ----rrrr, or  ---- ssss  option
     does not exist in all the files that the option applies to.

     The program issues a warning message if the end of  a  range
     specified  by a ----pppp, ----rrrr, or ----ssss option is not reached, and the
     option argument (see  the  Options  section)  ends  with  an
     explicit _l_a_s_t, _e_n_d, or ++++_i_n_c_r.  (This doesn't apply to option
     arguments that default to end-of-file by omitting what  fol-
     lows  the  colon.)   The  end  of  the  range may fail to be
     reached either because the end of an input file  is  reached
     first or because another ----pppp, ----rrrr, or ----ssss option causes an ear-
     lier stop.

     The program issues a warning message if processing for the ----
     JJJJ  option  joins  two  channels  that are not properly time-
     aligned (so that they would require conflicting  entries  in
     the output "start_time" header item).





        Copyright Entropic Research Laboratory, Inc. 6G6        6






MUX(1-ESPS)                                 ENTROPIC RESEARCH LAB



BBBBUUUUGGGGSSSS
     The ----ssss option is not implemented in this version of the pro-
     gram.

AAAAUUUUTTTTHHHHOOOORRRR
     Manual page by Rodney Johnson.  Program by Alan Parker.

















































        Copyright Entropic Research Laboratory, Inc. 7G7        7