fanaspec.1

speech signal process tools

.\" @(#)fanaspec.1	1.1	6/11/87	ESI
.\" Copyright (c) 1987 Entropic Speech, Inc.; all rights reserved
.TH FANASPEC 1\-ESPS 6/11/87
.ds ]W "\fI\s+4\ze\h'0.05'e\s-4\v'-0.4m'\fP\(*p\v'0.4m'\ Entropic Speech, Inc.
.SH NAME
fanaspec \- Generate spectral record file for records in a FEA_ANA file.
.SH SYNOPSIS
.B fanaspec
[
.BI \-x " debug_level"
]
[
.BI \-f " range"
]
[
.BI \-n " num_freqs"
]
.I input.ana
.I output.spec
.SH DESCRIPTION
.I Fanaspec
reads reflection coefficients and other information from the FEA_ANA file
and generates a corresponding spectral record file containing
logarithmically scaled (in db) maximum-entropy spectral power densities.
The spectral values are computed for the specified number of frequencies,
which must be one greater than a power of 2.
The frequencies are equispaced from 0 to half the sampling frequency.
One output record is written for each input record in the specified range.
If ``\-'' is given for the input file, the standard input is read.
If ``\-'' is given for the output file, the standard output is written to.
The output file can be plotted using the
.I plotspec
command.
.PP
If the spectrum representation of the input file is not RC, the
program exits.	    
.SH ESPS PARAMETERS
The ESPS parameter file is not referred to.
.SH ESPS HEADERS
The values 
.I common.type,
.I common.ndrec,
.I variable.refer,
and
.I hd.fea->fea_type
are read from the header of the FEA_ANA file.  The following 
generic header items are also read:
.I spec_rep
.I order_unvcd,
.I order_vcd,
.I src_sf,
.I frmlen,
.I start,
and
.I nan.
If they exist, then the following generic items are also read: 
.I win_type,
and
.I dcrem. 
.br
The following parameters are written to the header of the SPEC file:
.br
.I common.tag,
.I common.prog,
.I common.vers,
.I common.progdate,
.I common.ndrec,
.I variable.refer,
.I hd.spec\->start,
.I hd.spec\->nan,
.I hd.spec\-frmlen,
.I hd.spec\->order_vcd,
.I hd.spec\->order_unvcd,
.I hd.spec\->win_type,
.I hd.spec\->sf,
.I hd.spec\->dcrem,
.I hd.spec\->voicing,
.I hd.spec\->freq_format,
.I hd.spec\->spec_type,
.I hd.spec\->num_freqs,
and the fields usually written by
.I write_header
in the common part of the header.
In addition, the input file is added as the source of the output file 
and the command line is added as a comment.  
.SH OPTIONS
The following options are supported.  Values in brackets are defaults.
.TP
.BI \-x " debug_level
If
.I debug_level
is non-zero,
.I fanaspec
prints debugging messages and other information on the standard error output.
.TP
.BI \-f " first" : "last" "\fR [(first in file):(last in file)]"
.TP
.BI \-f " first" :+ "incr"
In the first form, a pair of unsigned integers specifies the range
of records to be processed.
Either
.I first
or
.I last
may be omitted; then the default value is used.
If
.IR last " = " first " + " incr,
the second form (with the plus sign) specifies the same range as the first.
If the specified range contains records not in the file,
.I fanaspec
complains and quits.
.TP
.BI \-n " num_freqs" "\fR [513]"
Compute spectral values for this number of frequencies, equispaced from 0
to half the sampling frequency.  Must equal
2\v'-.35'\s-3\fIn\fR\s+3\v'.35' + 1 for some positive integer \fIn\fR.
.SH SEE ALSO
refcof(1\-ESPS), plotspec(1\-ESPS), SPEC(5\-ESPS), ESPS(5\-ESPS)
.SH DIAGNOSTICS
.PP
fanaspec: unknown option: 
.RI \- letter
.br
Usage: fanaspec [-x debug_level][-f range][-P param_file][-n num_freqs] ana_file spec_file
.br
fanaspec: number of frequencies
.I n
is not 1 plus a power of 2.
.br
fanaspec: number of frequencies
.I n
exceeds 16385.
.br
fanaspec: can't open
.I filename: reason
.br
fanaspec: 
.I filename
is not an ESPS file
.br
fanaspec: input file
.I filename
is not a FEA_ANA analysis file.
.br
fanaspec: must have RC spec_rep.
.br
fanaspec: bad range:
.I n
records in
.I filename
.br
fanaspec: EOF encountered.
.PP
When
.IR debug_level !=0,
the reflection coefficients, average raw power, location tag,
and inverse filter coefficients
are listed for each record.
.SH BUGS
.PP
The values of
.IR start " and " nan
in the output header are only approximate if pitch-synchronous analysis
was used.
The
.I frame_len
field in each analysis record, defined as ``number of samples to synthesize
from frame,'' is copied to the
.I frame_len
field in a spectral record, defined as ``number of samples in analysis
window.''
This is invalid if the analysis file was produced by a program for which
the two are different.
.PP
The number of frequencies in an output record cannot exceed 16385.
The order of every analysis record must be less than
.RI 2( num_freqs \-1).
.SH FUTURE CHANGES
.PP
Add option to smooth spectrum by sinc-function weighting of the
autocorrelation function.
.SH AUTHOR
S. Shankar Narayan.
Made SDS compatible by Joe Buck.
Originally called
.I pltspc.
Modified for ESPS and number of frequencies made variable
by Rod Johnson, Entropic Processing, Inc.  Modified for FEA_ANA files
by John Shore.