testsd.1

来自「speech signal process tools」· 1 代码 · 共 459 行 · 第 1/2 页

contain 
.I length 
points.   This option is 
not allowed if 
.B \-a 
is specified.  
.TP
.BI \-s " length"
Specifies that 
.I sdfile
contain 
.I length
seconds of sampled data.   This option is 
not allowed if 
.B \-a 
is specified.  
.TP
.BI \-a " asciifile"
Specifies that the sampled data is to be taken from the input ASCII
file 
.I asciifile.  
Numbers in 
.I asciifile
may be integer or real, with numbers separated by white space or 
new lines.  
.TP
.BI \-S " seed \fR[1234567]\fP"
Specifies the starting seed for the random number generator (relevant
if Gaussian noise is being generated).
.TP
.BI \-t " data_type \fR[float]\fP"
Specifies the output data type.  Possible values are all of the
supported FEA types.  In particular, possible values for real types
are DOUBLE, FLOAT, LONG, SHORT, and BYTE, (signed CHAR); possible
values for complex types are DOUBLE_CPLX, FLOAT_CPLX, LONG_CPLX,
SHORT_CPLX, and BYTE_CPLX.  The values can be given in upper or lower
case as arguments to the \fB-t\fP option.  For convenience, a complex
output type can be specified by giving the corresponding real type in
the \fB-t\fP option and at the same time specifying the \fB-c\fP
option.  
.IP
If a complex output type is specified, the handling of the imaginary
part depends on the signal type.  For SINE, complex exponentials are
generated (as described above).  For SQUARE, TRIANGLE, SAWTOOTH,
PULSES, and CONSTANT, the real and imaginary parts are
identical.  For noise types (GAUSS and UNIFORM), independent noise is
generated for the real and imaginary parts.  For ASCII input, it is 
assumed that the real and imaginary parts alternate in the input, with
the first value being real.
.TP 
.BI \-c
Specifies that a complex FEA_SD file is to be generated.  If used
together with the \fB-a\fP option, it is assumed that the real and
imaginary parts alternate in the ASCII input.  If used in conjunction 
with a specified real output type (e.g., \fB-t\fP long), the output 
is set to the corresponding complex type (e.g., long_cplx).  This
option is ignored if a complex type is specified by other means (e.g.,
\fB-t\fP long_cplx).  
.TP
.BI \-i
Specifies that the data type in 
.I sdfile
is a SHORT (or SHORT_CPLX if \fB-c\fP is used).  This option is
provided for compatibility with previous versions (in which FLOAT was
the default type), and should be avoided.  If used, it will override
other type specifications.
.SH "ESPS PARAMETERS"
.PP
The parameter file is not required to be present, as there are default
parameter values that apply.  The defaults are those mentioned under
OPTIONS.  If the parameter file does exist, the following parameters are
read:
.IP
.I "signal_type - char *"
.IP
A string giving the type of test data as discussed under \fB\-T\fP.  This
parameter is not read if the \fB\-T\fP option is used.
.IP
.I "freq - double"
.IP
The \fIfrequency\fP as discussed under \fB\-f\fP.  This parameter is
read only in the case of periodic signals. It is not read if the
\fB\-f\fP option is used.
.IP
.I "phase - double"
.IP
The phase of real sine waves or complex exponentials.  This parameter
is read only in the case of periodic signals.  It is not read if the
\fB\-A\fP option is used.
.IP
.I "samp_rate - int"
.IP
The sampling rate.  This parameter is not read if the \fB\-r\fP option
is used.
.IP
.I "level - double"
.IP
The \fIlevel\fP as discussed under \fB\-l\fP.  This parameter is not
read if the \fB\-l\fP option is used.
.IP
.I "sweep_rate - double"
.IP
The \fIsweep_rate\fP as discussed under \fB-C\fP.  This is read only
for periodic signals.  It is not read if the \fB-C\fP
option is used.
.IP
.I "decay_time - double"
The \fIdecay_time\fP as discussed under \fB-d\fP.  This is read only 
for periodic signals.  It is not read if the \fB-d\fP option is used.  
.IP
.I "length - int"
.IP
The number of points to generate \- the \fIlength\fP as discussed
under \fB\-p\fP.  This parameter is not read if the \fB\-p\fP option
is used.
.IP
.I "seed - int"
.IP
The \fIseed\fP as discussed under \fB\-S\fP.  This parameter is only
read only in the case of noise signals (GAUSS, UNIFORM).  It is not
read if the \fB\-S\fP option is used.
.IP
.I "ascii_file - char *"
.IP
The name of the ASCII file containing input data.  This parameter is 
read only if \fIsignal_type\fP is ASCII and the \fB-a\fP option 
is not used.  
.IP
.I "data_type - char *"
.IP
The name of the desired output data type.  The parameter is not read
if the \fB-t\fP, \fB-c\fP, or \fB-i\fP options are is used.
.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 not read by 
.I testsd. 
If Common processing is enabled and if the output is not to standard
output, then
.I testsd
writes the following values into ESPS Common: 
.RS 5
\fI
.nf
filename = sdfile
prog = \fR"testsd"\fP
start = \fR1\fP
nan = \fR<total number of points generated>\fP
.fi
\fR
.RE
.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 of
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
\fITestsd\fP writes the usual FEA_SD header items.  Unless ASCII data
is being converted, "max_value" is set to a maximum possible value
(e.g., \fIlevel\fP in the case of sine waves), rather than to the
actual maximum (which might be less); note that in the case of complex
data types, the item "max_value" is the complex modulus.  If the type
is ASCII, then the actual maximum value is put into the header.
.PP
If the type is not ASCII, then
.I testsd
writes the 
.I level
to the generic header item "level".  
.I Testsd 
also writes the generic header item "signal_type", which identifies
the type of test data (SINE, GAUSS, PULSES, ASCII, etc. ).  
If the type is GAUSS or UNIFORM, then 
.I testsd
writes the random number seed to the generic header item "seed".  
If the type is SINE, SQUARE, TRIANGLE, SAWTOOTH, or PULSES, then 
.I testsd 
writes the 
.I frequency
to the generic header item "frequency", and the \fIphase\fP to the item
"phase".  If a \fIdecay_time\fP  or \fIsweep_rate\fP is used, the
value is written to a generic header item of the same name.  
.SH "FUTURE CHANGES"
.PP
Additional types of test data will be generated.  
.SH "SEE ALSO"
.nf
ESPS(5\-\s-1ESPS\s+1), FEA_SD(5\-\s-1ESPS\s+1), addsd(1\-\s-1ESPS\s+1),
\fIatoarray\fP(3\-\s-1ESPSu\s+1), \fIfeafunc\fP(1\-\s-1ESPS\s+1) \fIgauss\fP(3\-\s-1ESPSsp\s+1)
.fi
.SH "WARNINGS AND DIAGNOSTICS"
.PP
.I Testsd
will exit with appropriate messages if 
.B \-p
and
.B \-s
are both used, if 
.B \-f
is used with 
.BR \-T gauss,
if 
.B \-a 
is used with 
.B \-T,
and if 
.B \-a 
is used with either 
.B \-p
or
.B \-s.
.SH "BUGS"
.PP
None known.  
.SH "REFERENCES"
.PP
.SH "AUTHOR"
.PP
Program and manual page by John Shore