man.diff

speech signal process tools

.I nan,
as discussed above for
.B \-p.
.TP
.BI \-w " window_len" "\fR [(see \fB\-m\fR)]"
The duration of data in milliseconds over which the the power spectrum
is computed for each column of the spectrogram. The analysis bandwidth
is inversely proportional to this value.  If this option is not
specified, the parameter file is consulted, and if no value is found
there, the default implied by
.I method
(see
.BR \-m )
is used.
.TP
.BI \-x " debug_level"
A positive value
causes debugging output to be printed on the standard error output.
Larger values give more output.
The default is 0, for no output.
.TP
.BI \-E " pre_emphasis" "\fR [(see \fB\-m\fR)]"
The coefficient
.I A
in the preemphasis filter
.RI "1 \- " A/z.
This filter is applied to the sampled data before computing the power
spectrum.  A value of 1.0 provides a 6 dB/octave boost to the high
frequencies; a value of 0.0 provides no boost.  If this option is not
specified, the parameter
.I pre_emphasis
is read from the parameter file, and if no value is found there,
the default value implied by
.I method
(see
.BR \-m)
is used.
.TP
.BI \-P " param_file"
Use the parameter file
.I param_file
rather than the default, which is
.I params.
.TP
.BI \-S " step_size" "\fR [(see \fB\-m\fR)]"
The time step in milliseconds between columns in the spectrogram.  The
time resolution and horizontal magnification are affected by this
parameter.  If this option is not specified, the parameter file file
is consulted, and if no value is found there, the default value
implied by
.I method
(see
.BR \-m)
is used.
.SH "ESPS PARAMETERS"
.PP
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:
.TP
.I "method \- string"
The spectrogram method to use.  This parameter is not read if the
.B \-m
option is used.  If the parameter is present and is read, it
determines the values for all other parameters as discussed under the
.B \-m
option.  The other parameters are not read subsequently
(i.e., their values are fully determined by \fImethod\fP) unless
\fImethod\fP is "other".  In this special case, defaults for the other
parameters are those of the "wb" method, but they can be superceded by
the values of other parameters in the file.  The purpose of this
exception is to provide the following behavior when \fIdspsgram\fP is
called with the system default parameter file by means of \fIeparam\fP
(1\-\s-1ESPS\s+1): The user is prompted for \fImethod\fP.  If either 
"wb" or "nb" is specified, processing proceeds with the named method.  If 
"other" is specified, the user is prompted for all of the needed
parameters.  
.TP
.I "data_window \- string"
The data window to apply to the data.  This parameter is not read if
the
.B \-d
option is specified or if \fImethod\fP is in the 
parameter file and does not have the value "other". 
Acceptable values include "RECT" for a rectangular window,
"HAMMING", for Hamming, and "TRIANG", for triangular;
see the
.IR window (3-ESPSsp)
manual page for the complete list.
.TP
.I "fft_order \- integer"
.IP
The order of the FFT \- the transform length is 2 to the power
.I fft_order,
or possibly a large power, as discussed for the
.B \-o
option.
This parameter is not read if
.B \-o
is specified or if
\fImethod\fP is in the file and does not have the value "other".
.TP
.I "start \- integer"
.IP
The first point in the input sampled data file that is processed.
A value of 1 denotes the first sample in the file.
This parameter is not read if the
.B \-p
or
.B \-s
option is specified.
If it is not in the parameter file, and neither option is specified,
a default value of 1 is used.
.TP
.I "nan \- integer"
.IP
The total number of data points to process.
If
.I nan
is 0, processing continues through the end of the file.
This parameter is not read if the
.B \-p
or
.B \-s
option is specified.
If it is not in the parameter file, and neither option is specified,
a default value of 0 is used.
.TP
.I "window_len \- float"
.IP
The duration in milliseconds of each frame.  
This parameter not read if the
.B \-w
option is specified of if
\fImethod\fP is in the file and does not have the value "other".
.TP
.I "pre_emphasis \- float"
The coefficient in the preemphasis filter (see
.B \-E
in the Options section).  
This parameter not read if the
.B \-E
option is specified of if
\fImethod\fP is in the file and does not have the value "other".
.TP
.I "step_size \- float"
Initial points of consecutive frames differ by this number of
milliseconds.  
This parameter not read if the
.B \-S
option is specified of if
\fImethod\fP is in the file and does not have the value "other".
.PP
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.
.SH ESPS COMMON
.PP
ESPS Common is read provided that Common processing is enabled and 
that the 
.I filename
entry in Common matches 
.I input.sd.
In that case
parameters present in Common override values from the parameter file
and may in turn be overridden by command line options.
That is, in the sections on ESPS Parameters and Options,
parameters described as being found in the parameter file
may instead be found in the Common file if Common processing is enabled.
Common processing is useful when \fIrange\fP (1\-\s-1ESPS\s+1) 
or similar programs has been used to select a segment from \fIsdfile\fP.  
.PP
If Common processing is enabled and if
.I output.fspec
is not standard output, the Common parameters 
.I filename, prog, start,
and
.I nan
are written to Common, where 
.I filename
is set equal to
.I input.sd.
.PP
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 overridden by setting
the environment variable ESPSCOM to the desired path.  User feedback from
Common processing is determined by the environment variable ESPS_VERBOSE,
with 0 causing no feedback and increasing levels causing increasingly
detailed feedback.  If ESPS_VERBOSE is not defined, a default value of 3 is
assumed.
.SH ESPS HEADERS
.PP
.I Dspsgram
reads the value of 
.I common.type
and the generic header item
.I start_time
from the input file.
.PP
Relevant fields in the type-dependent portion of the 
output file header are filled appropriately.
The standard generic header items required for FEA_SPEC files
are filled in (see FEA_SPEC(5-ESPS) for details).
The generic header item \fIfft_order\fP is set to the 
order of the FFT, the item 
.I "fft_length"
is set to the length of the FFT,
the item
.I "step"
is set to the step size
(but measured in samples rather than milliseconds (see \fB\-S\fP), 
and the item \fIsgram_method\fP is set to the spectrogram method.  
The value "other" is used for \fIsgram_method\fP if there are any
changes from the two standard methods "wb" and "nb".  
The CODED generic header item
.I window_type
is set according to to the window type.
.PP
The generic header item \fIstart_time\fP (type DOUBLE) is written in
the output file.  The value written is computed by taking the
\fIstart_time\fP 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.
.PP
The generic header item \fIrecord_freq\fP (type DOUBLE)
is written in the output
file.  The value is the number of output records per second of input
data.
.PP
The preemphasis filter coefficient is recorded in a header item
.I pre_emphasis.
.SH "SEE ALSO"
.PP
\fIsgram\fP(1\-\s-1ESPS\s+1),
\fIplotsgram\fP(1\-\s-1ESPS\s+1), \fIfft\fP(1\-\s-1ESPS\s+1),
\fIme_sgram\fP(1\-\s-1ESPS\s+1), \fIimage\fP(1\-\s-1ESPS\s+1),
\fIdither\fP(1\-\s-1ESPS\s+1), \fIrefcof\fP(1\-\s-1ESPS\s+1),
\fIme_spec\fP(1\-\s-1ESPS\s+1), \fIfilter\fP(1\-\s-1ESPS\s+1),
\fIwindow\fP(3\-\s-1ESPS\s+1), \fIwplay\fP (1\-\s-1ESPS\s+1), 
\fIwrecord\fP (1\-\s-1ESPS\s+1), FEA_SPEC(5\-\s-1ESPS\s+1),
FEA_SD (5\-\s-1ESPS\s+1)
.SH "FUTURE CHANGES"
.PP
Allow a variable number of retries before giving up on the DSP32
board. 
.SH "BUGS"
.PP
.PP
If \fIdspsgram\fP terminates abnormally (e.g., ^C, system crash, bad bug,
etc.), the DSP32 lock file can be left on /tmp (see "USING THE THE
OPTIONAL DSP32 BOARD").  The lock file will interfere with \fIwaves\fP+,
\fIdspgram\fP, \fIwplay\fP, and \fIwrecord\fP until it is removed. 
.SH "AUTHOR"
.PP
Rod Johnson, ESI.
Based in part on
.IR sgram (1-ESPS)
(D. Burton, R. Johnson)
and in part on spectrogram code in the
.I waves
program (David Talkin and others at AT&T).