readme.1

4.8kcelp语音压缩编码程序

Note*******
For this PC release, no provision has been made, other than changing file
names to fit within DOS filename constraints, to run on a DOS system.  This
code was written to run on a Sun Workstation, and can be easily made to run
on any UNIX based system.  A small amount of work is needed to make the
code runable on a PC system.


	CELP Version 3.2 code

Beware, the speech generated by version 3.2 C code and 3.2 FORTRAN
code does not match exactly.  However, this slight mismatch appears
to be within the arithmetic precision difference expected between 
compiled FORTRAN and C.


EXECUTION
---------
                       CELP COMMAND
NAME:
     celp - execute the CELP coder

     The celp command generates a code-excited-linear-prediction
     processed output file from an input file.

SYNOPSIS:
     celp [-i ifile] [-o ofile] [-p pfile] [-q qfile] [-m mfile] [-l lfile]
       or
     celp [-c chan] [-o ofile]

ARGUMENTS:
     -i      Input file short data format (16-bit signed samples).
             For defaults, see celp.c data statements.
 
     -o      Speech output file (.spd) short data format
             (16-bit signed samples) and bit stream channel file (.chan).
             For defaults, see celp.c data statements.

     -p      Parameter file specifying celp characteristics.
             For defaults, see celp.c data statements.
             Parameters are stored in a ascii text file in the order below
             with one number per line, i.e.,

               512       [ncsize = Code book size]
               60        [l      = Code word length]
               240       [ll     = LPC analysis frame size]
               10        [no     = LPC filter order]
               60        [lp     = Pitch analysis frame size]
               1         [np     = Pitch order]
               0.8       [gamma  = Noise weighting factor]
               1.0       [scale  = Input speech scaling factor]
	       1.0       [descale = Output speech scaling factor]
               0.0       [ber    = % bit error rate]
	       1	 [mxsw    = modified excitation logical switch]
	       0.0       [prewt   = prefilter logical switch]
	       hier      [pstype  = type of fractional pitch search]

     -q      Quantization characteristics file.
             For defaults, see celp.c data statements.
             The file has 3 sections: cbgain, pitch, and spectrum.
             Each section type is followed by a quantization type,
             which can be one of the following:  "max", "uniform", "vq",
             "log", "opt", or "none".  If the quantization type is not 
             "none", then the next line is the bit allocation, e.g.,

             cbgain
             none                      [unquantized cbgain]
             pitch
             max                       [Max quantization]
             8 6 5             [8 bit delay, 6 bit delta delay, 5 bit gain]
             spectrum
             kang                      [Kang's quantization]
             3 4 4 4 4 3 3 3 3 3       [lsp1=3,...,lsp10=3]

     -m      Mask file specifying bit protection when introducing bit
             errors to the unpermuted bit stream.  (Note, this protection
             is separate from the Hamming FEC.)  Each line of the mfile
             corresponds to a bit (i.e., 144 lines) where each line is a
             1 (protected) or 0 (not protected).
             See description in biterror.c.  

     -l      Log file output containing run time information.
             Defaults to appending to a file called "celp.log".
             If the file name "none" is specified, no log file
             is generated.

     -c      Input channel file (.chan) hexadecimal format.  Channel
	     files generated from previous analysis runs are used as
	     imputs to a "synthesis only" run.  During this mode, the
	     -i switch is invalid.

EXAMPLES:

     celp
             This causes celp to process ifile.spd into ofile.spd (and a
             nonpostfiltered output in ofilenpf.spd) using the defaults 
             specified by the FORTRAN data statements in celp.c,
             writes the bit stream file ofile.chan and generates a log
             appended to the file "celp.log".  (If SUNGRAPH is enabled,
             a set of files, with .sg_data extension, as defined in
             sungraph_open.com is generated.)

     celp -i speech/dam27 -o dam27.48 -p celp48.p -q celp48.q -l log

             celp processes speech/dam27.spd into the normal, highpassed
	     and nonpostfiltered output, dam27.48.spd, dam27_48hpf.spd
	     and dam27_48npf.spd, respectively, writes the bit stream
	     file dam27_48.chan and appends log information to a file
	     called log.  The celp parameters specified by celp48.p and  
	     quantization characteristics of celp48.q are used.  (If  
	     SUNGRAPH is enabled, a set of files, with .sg_data extension, 
             as defined in sungraph_open.com is generated.)

     celp -c speech/512_dam27.chan -o 512_dam27b

	     celp synthesizes speech/512_dam27.chan channel file into 
	     the normal, highpassed and nonpostfiltered output, 
	     512_dam27b.spd, 512_dam27bhpf.spd and 512_dam27bnpf.spd,
	     respectively.


 SEE ALSO
        cli.c


EXECUTION OF SEPARATE SYNTHESIZER
---------------------------------

       In order to run the synthesizer only, compile celp without
       the -DANALY option in the makefile.  (Separate analysis is not
       provided since the combined analyzer and synthesizer generates a  
       bit stream channel file.)  The celp command syntax for synthesis  
       only is:

       celp [-c chan] [-o ofile]


       where: chan is input.chan ascii hex bit stream channel file.
              ofile is ofile.spd speech file (postfiltered).

 SEE ALSO 
	makefile