cbkdsp.1

speech signal process tools

.\" @(#)cbkdsp.1	1.1 10/17/86 EPI
.TH CBKDSP 1\-SPS 10/17/86
.ds ]W "\fI\s+4\ze\h'0.05'e\s-4\v'-0.4m'\fP\(*p\v'0.4m'\ Entropic Processing, Inc.
.SH NAME
cbkdsp \- codebook file to dsp code
.SH SYNOPSIS
.B cbkdsp
[
.BI \-x " debug_level"
] [
.BI \-t " {rc|p1|pd|r0|pwr}"
] [
.BI \-n " name of table"
]
.I " file"
.SH DESCRIPTION
.PP
.I Cbkdsp
converts an SPS SCBK file into a form suitable for editing into a
Rosetta DSP code module.  
Some editing by a human is required.
The table is output to stdout.
.SH OPTIONS
.PP
The following options are supported:
.TP
.BI \-x " debug level"
There is no debug output from this version.
.TP
.BI \-t " {rc|p1|pd|r0|pwr}"
This option is used to select the type of DSP code table to produce.
The supported versions are: \fIrc\fR for reflection coefficients,
\fIp1\fR for the first pitch pulse, \fIpd\fR for pulse differences,
\fIr0\fR for the first power, and \fIpwr\fR for power ratios.   
If the \-t option is not given, table type \fIrc\fR is assumed.
.TP
.BI \-n " name of table"
This option is used to name the DSP table.   The form of the name is
\fIname\fR_enc_tab and \fIname\fR_dec_tab for table of type rc, p1, pd,
and r0.    Tables of type pwr are named \fIname\fR_l_enc_tab and
\fIname\fR_g_enc_tab for the encode tables and \fIname\fR_l_dec_tab and
\fIname\fR_g_dec_tab for the decode tables.   
If the \fI\-n\fR option is not used, then the table type (e.g. rc) is
used in place of the name.
.SH SPS PARAMETERS
The SPS parameter file is not referenced.
.SH BUGS AND RESTRICTIONS
.PP
The pwr tables are split
into two forms due to DSP number restrictions.  This is dependent on the
quantization method used and might not be valid for all.
.SH DIAGNOSTICS
.PP
A message is printed and the program exits if the input file cannot be
opened for reading, or if it is not an SPS SCBK file.
.PP
This program has been testing by producing tables for the \fIros1\fR
quantization method and comparing them with the tables produced by hand
for the alpha-test dsp implementation.   A formal specification of the
dsp tables is not available yet.   Instead, the existing dsp code file,
\fIenctables.asm\fR was used as a model.     The output should be
carefully checked. 
.SH AUTHOR
.PP
Alan Parker