man.diff

来自「speech signal process tools」· DIFF 代码 · 共 104 行

.\" Copyright (c) 1991 Entropic Research Laboratory, Inc.; All rights reserved
.\" @(#)cnvlab.1	1.3 4/2/97 ERL
.ds ]W (c) 1991 Entropic Research Laboratory, Inc.
.TH  CNVLAB 1\-ESPS 4/2/97
.SH NAME

.nf
cnvlab \- convert NIST/SPHERE (e.g., TIMIT) label file to waves+ label file
.fi
.SH SYNOPSIS
.B
cnvlab
[
.BI \-s " sampling_rate"
] [
.B \-b 
] 
nist_file waves_file

.SH DESCRIPTION
.PP
\fIcnvlab\fP reads the time-marked labels in a NIST 
label file \fInist_file\fP, and writes an equivalent \fIwaves\fP+ 
label file \fIwaves_file\fP.  The input file contains one label 
per line with three fields: (1) the starting sample number; (2) 
the ending sample number; and (3) the label text (which may include 
blanks).  
.PP
.PP
The output file \fIwaves_file\fP contains one label per line (after 
an initial line with "#"), with three fields: (1) the time (in
seconds) of the label; (2) the color of the label (RGB); (3) the 
label text.  Note that labels do not have a start and end time.  By 
convention, the time of a waves+ label is the ending time.  
.PP
The sampling rate to be assumed by \fIcnvlab\fP when interpreting
sample numbers is given by the \fB-s\fP option.
.PP
In the default mode (no \fB-b\fP option), \fIcnvlab\fP produces one
\fIwaves\fP+ label per input label, with the time corresponding to the
ending sample number of the input label.  If the first input label
does not begin with sample 0, \fIcnvlab\fP issues a warning and
generates a special label (with text "UNL", for "unlabelled") to mark
the actual starting point of the first label.  If the ending time of
one label is not the same as the starting point of the next label (a
relatively rare case in the NIST databases), \fIcnvlab\fP issues a
warning.  If the ending time of one label exceeds the starting time of
the next label, \fIcnvlab\fP issues a warning and also inserts a
special label (again, with text "UNL") to mark the starting time of
the that next label.
.PP
If the \fB-b\fP option is used, \fIcnvlab\fP produces two \fIwaves\fP+
labels per input label \- one each for the starting point and the
ending point.  The text for the former is the input label text with
"_S" appended, and the text for the latter is the input label text
with "_E" appended.
.PP
In the default mode, the color of the \fIwaves\fP+ labels is set to
green, with the color of the special "UNL" labels set to blue.  If
\fB-m\fP is used, the \fIwaves\fP+ endpoint labels have color green,
and the starting point labels have the color blue.
.SH OPTIONS
.PP
The following options are supported:
.TP
.BI \-s " sampling_rate \fR[8000]\fP"
Sets the sampling rate used to compute the times associate with the 
sample numbers in \fInist_file\fP.   
.TP
.BI \-b 
Specifies that both the start and end points of the input label each
be turned into a \fIwaves\fP+ label.  This results in two output
labels for each input label.  See the DESCRIPTION about for details. 
.SH ESPS PARAMETERS
.PP
An ESPS parameter file not used.  
.SH ESPS COMMON
.PP
ESPS Common is not read or written.  
.SH ESPS HEADERS
.PP
No ESPS headers are read or written.  
.SH FUTURE CHANGES
.PP
.SH EXAMPLES
.PP
.SH ERRORS AND DIAGNOSTICS
.PP
.SH BUGS
.PP
None known.
.SH REFERENCES
.PP
.SH "SEE ALSO"
.PP
\fIconvertlab\fP (3\-\s-1ESPS\s+1sp), \fIxlabel\fP (1\-\s-1ESPS\s+1)
.SH AUTHOR
.PP
John Shore (with help from David Talkin).