copyana.1

speech signal process tools

.sc
.\"  @(#)copyana.1	1.7 1.7
.TH COPYANA \1-SPS 1/9/87
.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
copyana \- copies selected pieces of an ANA file to a new ANA file
.SH SYNOPSIS
.B copyana
[
.BI \-x " debug_level"
] [
.BI \-f
] [
.BI \-n " range"
] [
.B \-{vu} 
] [
.BI \-O " +\- power_level"
] [
.BI \-I " element_#"
] [
.BI \-{PERperSsCc} " +\- level"
]
.I " infile" 
[
.I " outfile "
]
.SH DESCRIPTION
.PP
.I Copyana
copies selected pieces of an ANA file into another ANA file.
If 
.I outfile 
exists,
the selected pieces of
.I infile
are appended to
.I outfile;
if 
.I outfile
doesn't exist,
it is created.
Appending data to 
.I infile
is not allowed.
.SH SPS PARAMETERS
No parameters are read from a 
.I params
file.
.SH SPS HEADER
If the output file is new (i.e. not appending to an existing file) then
the source ANA header structure is copied into the new file header.
.I start
and the number of points
.I nan
are updated, and
the input ANA file name is added to the list of sources.
If the output file already exists and the selected records are to be
appended, then the following header items are invalid and are set as
follows:
.I frmlen:
-1, 
.I p_offset:
-1,
.I piq_method:
NONE,
.I rcq_method:
NONE,
.I pwq_method:
NONE,
.I lpq_method:
NONE,
.I win_type:
NONE,
.I src_sf:
-1,
.I a_method:
NONE,
.I dcrem:
-1,
.I psynch:
-1,
.I matsiz:
-1,
.I rms_fullscale:
-1, and
.I sinc_flg:
NONE.
.SH OPTIONS
The following options are supported:
.TP
.BI \-x " debug_level"
Only debug level 1 is defined in this version;
this causes several messages to be printed.
The default level is zero, which causes no debug output.
.TP
.BI \-f
This option causes a fast copy to be done.  This is done by appending
the selected records onto the end of the destination file, rewinding the
file and writting an updated header (with the record count updated).
Use of this option causes embedded headers not to be included in the
output file.  Also, the command line is not saved as a comment in the
output header (the output header size cannot change).
This option should not be used to produce archival files where the
entire processing history is needed.
.br
.sp
If the header version (\fIcommon.hdvers\fR) is not the same for the
input and output file, then a fast copy is not done.  This is because
the size or the exact format of the header might be different and the
write may fail.   The program checks the versions, and simply turns
the \fB-f\fR flag off if the versions do not match.
.TP
.BI \-n " range"
Select a range of records to be processed.
By default, all records in the file 
are processed. 
As is usual
for SPS programs, however,
a range
is specified as 
follows: 
two numbers separated by a colon (beginning : end),
a single number (a range consisting of one value),
a number followed by a colon (the largest possible value
determines the end of the range),
or a colon followed by an number (the default is to start the range at the
smallest possible value). (See 
.I range_switch(3) 
for full details of range specification.)
.TP
.B \-{vu} 
If 
.B -v
is specified, only voiced records that satisfy the rest of the 
options
{
.B "n, I, P, S, E, R, C, p, s, e, r, c"
or
.B O
}
are copied.
Unvoiced records are handled similarly with the
.B -u
option.
.TP
.BI \-O " \+\- power_level"
If \+,
only those records with total power (sum of the pulse powers) greater than
.I power_level
are copied;
If \-,
only those records with total power less than
.I power_level
are copied.
.TP
.BI \-I " element_#"
The 
.B \-I
option 
selects one 
.I element_# 
in the specified parameter array (
pulse durations (P), reflection coefficients (S or C), lpc error power (E), or raw speech power (R) )
which is checked against the level specifed by one of the
options
{
.B " P, S, E, R,"
or
.B C
}
.
For example,
.IP
.I
copyana -I1 -P80 infile outfile
.IP
copies from
.I infile
to 
.I outfile
all records in which the first pulse duration is greater than 80.
.TP
.BI \-{PERperSsCc} " +\- level"
If \(pl and a 
.B "P, E,"
or 
.B R 
is specified,
copy only those records in which all specifed parameter values are greater than
.I level;
if \(pl and a 
.B "p, e,"
or 
.B "r" 
is specified,
copy only those records in which at least one of the specified parameter
values is greater than
.I level;
if \(mi and a 
.B "P, E,"
or 
.B R 
is specified,
copy only those records in which all specified parameter values are less than
.I level;
and if \(mi and a 
.B "p, e," 
or 
.B r 
is specifed,
copy only those records in which at least one specified parameter value
is less than
.I level.
The
.B S, s, C,
and
.B c
options work differently;
the sign of 
.I level
is not used as part of the flag. 
This allows negative values to be specified.
If 
.B \-S,
copy only those records in which all reflection coefficients are greater than
.I level;
if 
.B \-C,
copy only those records in which all reflection coefficients are less than
.I level;
if 
.B \-s,
copy only those records in which at least one pulse duration is greater than
.I level
; and
if 
.B \-c,
copy only those records in which at least one reflection coefficient is less than
.I level.
.IP
For example,
.IP
.I
copyana -v -R1000. infile outfile
.IP
copies from 
.I infile
to
.I outfile
all voiced records in which all pulse have power greater than  1000.
.SH DIAGNOSTICS
.PP
A fatal error occurs if the input file does not exist, if it is not an SPS
ANA-file, or if a requested range includes
records that do not exist.
.PP
If the versions of the headers do not match when the \fB-f\fR flag is
used, a message is printed and the \fB-f\fR flag is turned off.
.SH SEE ALSO
.PP
anastat(1), copysd(1)
.SH BUGS
.PP
The \fB-I\fR and \fB-{PERperSsCc}\fR options are not implemented yet.
.SH AUTHOR
.PP
David K. Burton and Alan Parker, Entropic Processing, Inc.