foo

speech signal process tools

     standard  output,  the  program writes the Common parameters
     <EM>prog</EM>, <EM>filename</EM>, <EM>start</EM>, and <EM>nan</EM> 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  <EM>off</EM>. The default
     ESPS Common file is <EM>espscom</EM> 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 HEADERS</H2><PRE>
     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.


     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 (<EM>r</EM>-1)/<EM>f</EM>
     where  <EM>r</EM> is the starting record number in the input file and
     <EM>f</EM> is the  sampling  frequency  given  by  the  "record_freq"
     header  item.   The   <STRONG>-</STRONG> <STRONG>J</STRONG> 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.


</PRE>
<H2>EXAMPLES</H2><PRE>
     Multiplex data from three input files to produce  an  output
     file  <EM>xxx</EM>.  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.

          <EM>mux</EM> <EM>aaa</EM> <EM>bbb</EM> <EM>ccc</EM> <EM>xxx</EM>

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

          <EM>mux</EM> -<EM>s0</EM>.<EM>5</EM>:<EM>1</EM>.<EM>0</EM> <EM>aaa</EM> <EM>bbb</EM> <EM>ccc</EM> <EM>xxx</EM>

     Start at time 0.5 in file <EM>aaa</EM> 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
     <EM>aaa</EM> and <EM>ccc</EM> and 0.0 for data from file <EM>bbb</EM>.)

          <EM>mux</EM> -<EM>s0</EM>.<EM>5</EM>: -<EM>p1</EM>: <EM>aaa</EM> <EM>bbb</EM> <EM>ccc</EM> <EM>xxx</EM>

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

          <EM>testsd</EM> - | <EM>mux</EM> <EM>aaa</EM> - - | <EM>more</EM>_<EM>processing</EM> -

     If <EM>aaa</EM> has two channels of real data, this will  convert  it
     to a single-channel file <EM>zzz</EM> of complex data.
          <EM>mux</EM> -<EM>J</EM> <EM>aaa</EM> <EM>zzz</EM>

     If <EM>aaa</EM> and <EM>bbb</EM> are single-channel files of real  data,  this
     will join them into a single-channel file of complex data.

          <EM>mux</EM> -<EM>J</EM> <EM>aaa</EM> <EM>bbb</EM> <EM>zzz</EM>

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

          <EM>mux</EM> -<EM>p1001</EM>:<EM>2000</EM> -<EM>p2501</EM>: <EM>aaa</EM> <EM>aaa</EM> <EM>xxx</EM>


</PRE>
<H2>SEE ALSO</H2><PRE>
     <STRONG><A HREF="../man1.html/demux.1.html">demux(1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/copysps.1.html">copysps(1-ESPS)</A></STRONG>, <STRONG><A HREF="../man1.html/addgen.1.html">addgen(1-ESPS)</A></STRONG>,
     <STRONG><A HREF="../man5.html/FEA_SD.5.html">FEA_SD(5-ESPS)</A></STRONG>, <STRONG><A HREF="../man5.html/FEA.5.html">FEA(5-ESPS)</A></STRONG>


</PRE>
<H2>DIAGNOSTICS</H2><PRE>
     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 <STRONG>-p</STRONG>, <STRONG>-r</STRONG>, and  <STRONG>-</STRONG> <STRONG>s</STRONG>
     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 <STRONG>-J</STRONG> option is specified with input files of  a  complex
     data type.
       The <STRONG>-J</STRONG> option is specified, and the total number of  input
     channels is odd.
       A starting record specified with a <STRONG>-p</STRONG>, <STRONG>-r</STRONG>, or  <STRONG>-</STRONG> <STRONG>s</STRONG>  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 <STRONG>-p</STRONG>, <STRONG>-r</STRONG>, or <STRONG>-s</STRONG> option is not reached, and the
     option argument (see  the  Options  section)  ends  with  an
     explicit <EM>last</EM>, <EM>end</EM>, or <STRONG>+</STRONG><EM>incr</EM>.  (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 <STRONG>-p</STRONG>, <STRONG>-r</STRONG>, or <STRONG>-s</STRONG> option causes an ear-
     lier stop.

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



</PRE>
<H2>BUGS</H2><PRE>
     The <STRONG>-s</STRONG> option is not implemented in this version of the pro-
     gram.


</PRE>
<H2>AUTHOR</H2><PRE>
     Manual page by Rodney Johnson.  Program by Alan Parker.














































</PRE>
</BODY>
</HTML>