barkspec.1

speech signal process tools

specified in the parameter file.
It should not be used if
.B \-H
is specified.
.TP
.BI \-H " band_low" : "band_high" "\fR [0:(Nyquist)]\fP"
.TP
.BI \-H " band_low" :+ "width"
The range of frequencies (in hertz) to be covered.
The first form specifies the range by giving the upper and lower limits
as a pair of real numbers.
The second form (with the plus sign)
specifies the range by its lower limit and width.
Thus, if
.IR band_high " = " band_low " + " width,
the two forms specify the same range.
The default is to attempt to cover
the entire range of frequencies in the input file.
A specified value of 0 for
.I band_high
implies use of the default value\*-the Nyquist rate.
This option overrides any value of
.I bark_low,
.I band_low,
.I bark_high,
or
.I band_high
specified in the parameter file.
The specified range is transformed into a range on the Bark scale,
and the uniform interval between Bark values
is computed as described for option
.B \-B
above.  See
.B \-B
for more information.
This option should not be used if
.B \-B
is specified.
.TP
.BI \-P " param_file" "\fR [params]\fP"
The name of the ESPS parameter file.
.TP
.BI \-S " spec_type" "\fR [DB]\fP"
Allowed values for the argument are DB and PWR (case-insensitive).
These result in an output file with a
.I spec_type
(see
.IR FEA_SPEC (5\-ESPS))
of DB or PWR, respectively.
If DB, the default, is selected, each computed Bark-spectral power
.I S
is replaced with a logarithmic value
.I "10 * log10(S)"
before being written out.
This transformation takes place before any additive or multiplicative
transformation implied by options
.B \-a
and
.B \-m
or the corresponding parameter-file entries.
This option overrides any value for
.I spec_type
specified in the parameter file.
.TP
.B \-X
This option causes the program to write a frequency table
on the standard error output.
The table lists
the filter peak frequencies and \-3 dB points in barks and in hertz.
This output is also included in the debug output produced by option
.B \-x
with a
.I debug_level
of 2 or higher.
.SH ESPS PARAMETERS
.PP
The following parameters may be read, if present, from the parameter file.
.TP
.I "add_const \- float"
.IP
Constant to be added to Bark-spectral powers
before they are written out.
See option
.BR \-a .
(See also option
.B \-m
and parameter
.IR mult_const. )
This parameter is not read if
.B \-a
is specified.
.TP
.I "band_high \- float"
.IP
High limit of the range of frequencies (in hertz) to be covered.
See option
.BR \-H .
(See also option
.B \-B
and parameters
.IR band_low,
.IR bark_high,
and
.IR bark_low. )
This parameter is not read if option
.B \-B
or
.B \-H
is specified or if parameter
.I bark_high
is also specified.
A value of 0 implies use of the default value\*-see
.BR \-H .
.TP
.I "band_low \- float"
.IP
Low limit of the range of frequencies (in hertz) to be covered.
See option
.BR \-H .
(See also option
.B \-B
and parameters
.IR band_high,
.IR bark_high,
and
.IR bark_low. )
This parameter is not read if option
.B \-B
or
.B \-H
is specified or if parameter
.I bark_low
is also specified.
.TP
.I "bark_high \- float"
.IP
High limit of the range of Bark-scale values to be covered.
See option
.BR \-B .
(See also option
.B \-H
and parameters
.IR bark_low,
.IR band_high,
and
.IR band_low. )
This parameter is not read if
.B \-B
or
.B \-H
is specified.
It takes precedence if parameter
.I band_high
is also specified.
A value of 0 implies use of the default value\*-see
.BR \-B .
.TP
.I "bark_low \- float"
.IP
Low limit of the range of Bark-scale values to be covered.
See option
.BR \-B .
(See also option
.B \-H
and parameters
.IR bark_high,
.IR band_low,
and
.IR band_high. )
This parameter is not read if option
.B \-B
or
.B \-H
is specified.
It takes precedence if parameter
.I band_low
is also specified.
.TP
.I "mult_const \- float"
.IP
Constant by which Bark-spectral powers are to be multiplied
before being written out.
See option
.BR \-m .
(See also option
.BR \-a
and parameter
.IR add_const. )
This parameter is not read if
.B \-m
is specified.
.TP
.I "nan \- int"
.IP
The number of records to process.
See option
.BR \-r .
(See also parameter
.IR start. )
A value of 0 implies processing all records from
.I start
to the end of the file; this is the default.
This parameter is not read if
.B \-r
is specified.
.TP
.I "num_freqs \- int"
.IP
The number of Bark values at which spectral values will be computed.
See option
.BR \-n .
A value of 0 implies use of the default value (see
.BR \-n ).
This parameter is not read if the option is specified.
.TP
.I "spec_type \- string"
.IP
Allowed values are "DB" and "PWR" (case-insensitive).
These indicate whether to output Bark-spectral powers
directly ("PWR") or convert them to dB ("DB").
See option
.BR \-S .
This parameter is not read if the option is specified.
.TP
.I "start \- int"
.IP
The number of the first input record to process.
See option
.BR \-r .
(See also parameter
.IR nan. )
This parameter is not read if
.B \-r
is specified.
.SH ESPS COMMON
.PP
The ESPS common file is not accessed.
.SH ESPS HEADERS
.PP
The output file header is an ESPS FEA_SPEC header (see
.IR FEA_SPEC (5\-ESPS),
.IR init_feaspec_hd (3\-ESPS)).
A copy of the input header is included in the output file
as a source header.
The output file is tagged if and only if the input file is tagged.
If the files are tagged, the
.I refer
file name in the output header is copied from the input header,
and the generic header item
.I src_sf
is copied from the input header if present;
otherwise the value of
.I sf
is used.
Output generic header items
.I start_time
and
.I record_freq
are determined by the corresponding input header items, if present,
and by the
.I start
record number.
.PP
Generic header items
.I add_const,
.I band_high,
.I band_low,
.I bark_high,
.I bark_low,
.I mult_const,
.I nan,
and
.I start
are added to the output file header to record the values
specified with the corresponding parameters and options.
The data types of the header items are DOUBLE for
.I float
parameters and LONG for
.I int
parameters.
The usual FEA_SPEC generic header item
.I spec_type
(see
.IR FEA_SPEC (5\-ESPS))
takes the CODED value SPTYP_DB or SPTYP_PWR,
as determined by the parameter
.I spec_type
or the argument of
.BR \-S ,
and the usual FEA_SPEC generic header item
.I num_freqs
takes the value of
.I num_freqs.
.PP
A special generic header item
.I bark_freqs
of type FLOAT
is added to record the selected set of uniformly spaced Bark values
.I b
for which Bark-spectral values are computed.
The equivalent linear frequencies (nonuniformly spaced)
are recorded in the usual FEA_SPEC generic header item
.I freqs
(see
.IR FEA_SPEC (5\-ESPS)).
.SH FUTURE CHANGES
.PP
None contemplated.
.SH EXAMPLES
.PP
.SH ERRORS AND DIAGNOSTICS
.PP
The program prints a synopsis of command-line usage and exits
if an unknown option is specified
or if the number of file names is wrong.
It exits with an error message
if
.I input.spec
and
.I output.spec
are the same (but not ``\-'');
if
.I input.spec
does not exist or is not an ESPS FEA_SPEC file;
if
.I freq_format
in the input file is not SYM_EDGE;
if the range of record numbers (see
.BR \-r )
is empty or starts before the beginning of the file;
if the Bark-scale range to be covered (see
.B \-B
and
.BR \-H )
is less than 1 bark in width, extends below \-0.59 bark,
or extends more than 0.41 bark
above the value corresponding to the Nyquist rate;
if
.B \-B
and
.B \-H
are both specified;
if
.I num_freqs
(see
.BR \-n )
is less than 1;
if
.I num_freqs
is 2 or more, but the uniform interval between Bark values
(see
.BR \-B )
is 0 or less;
or if an unsupported
.I spec_type
(see
.BR \-S )
is specified.
.SH BUGS
.PP
None known.
.SH REFERENCES
.HP
[1] S. Wang, A. Sekey, and A. Gersho,
``An objective measure for predicting subjective quality of speech coders,''
.I "IEEE Journal on Selected Areas in Communications,"
.BR SAC-10
(5), 819\-829 (June 1992)
.HP
[2] A. Sekey and B. A. Hanson,
``Improved 1-Bark bandwidth auditory filter,''
.I "Journal of the Acoustical Society of America"
.B 75
(6), 1902\-1904 (June 1984)
.HP
[3] H. Hermansky,
``Perceptual linear predictive (PLP) analysis of speech,''
.I "Journal of the Acoustical Society of America"
.B 87
(4), 1738\-1752 (April 1990)
.SH "SEE ALSO"
.IR fft (1\-ESPS),
.IR melspec (1\-ESPS),
.IR me_spec (1\-ESPS),
.br
.IR bs_dist (1\-ESPS),
.IR init_feaspec_hd (3\-ESPS),
.IR FEA_SPEC (5\-ESPS)
.SH AUTHOR
Rodney Johnson