crecord.1t

来自「speech signal process tools」· 1T 代码 · 共 162 行

.\" Copyright (c) 1987 Entropic Speech, Inc.; All rights reserved
.\" %W% %G% ESI
.TH MCRECORD  1\-ESPS %G%
.ds ]W "Entropic Speech, Inc.
.SH NAME
crecord  - digitize data using the \s-1CONVEX\s+1 analog-to-digital (A/D) converter.
.PP
record  - digitize data using an analog-to-digital (A/D) converter.
.SH SYNOPSIS
.B crecord
[
.BI \-x " debug level"
] [
.BI \-{psf} " range"
] [
.BI \-r " sampling rate"
] [
.BI \-g " gain"
] [
.BI \-w " width"
] [
.BI \-c " A/D channel"
] [
.BI \-k " clock#"
]
.BI \-t " comment text"
]
.BI \-d " A/D device type"
]
.BI \-C " clock device"
]
.BI \-D " A/D device"
]
.I file
.SH DESCRIPTION
.PP
.I Record
digitizes the input at the specified sampling rate and stores the data in 
.I file
(an ESPS sampled data (SD) file).
A range of data may be specified in one of three ways:
the number of samples, seconds of data, or number of frames at the specified width.
Furthermore, a gain factor
, an alternate A/D channel, and an alternate clock may be specified.
.PP
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 \-p " range"
Select the recording length, in number of points.
.TP
.BI \-s " range"
Select the recording length, in seconds.
.TP
.BI \-f " range"
Select the recording length, in frames. By default, a frame is
100 points, but this may be changed. See 
.I width
below.
.TP
.BI \-r " sampling rate"
Select the sampling rate (default is 8000 samples/second).
.TP
.BI \-w " width"
This switch defines the frame width. The width is ignored unless the
.B \-f
switch is also specified. (The default is 100 points.)
.TP
.BI \-c " A/D channel"
Specifies the channel of the A/D to use.  The default channel number is
zero.  The range of legal values, depends on the particular A/D
being used.
.TP
.BI \-k " clock#"
Specifies the clock used to drive the analog to digital conversion. 
The default is clock 1.   The range of legal values, depends on the
particular A/D being used.
.TP
.BI \-t " comment text"
The argument following this option is added to the comment field of the
output ESPS SD file.  If the text is more than one word, it must be
enclosed in quotes.
.TP
.BI \-d "A/D device type"
This overrides the A/D device type compiled into the program.  Normally
the device type is compiled into the program as specified by the ESPS
install script.   This device type does not affect processing; it is
only used to save the device type in the \fIequip\fR of the ESPS data
file header.
.TP
.I \ file
The file to store the sampled speech data into.  By convention this
file ends with \fI.sd\fR, although it is not enforced.
.PP
.I Record
tells the user when all the setups are finished and the A/D conversion process is ready to begin.
The data conversion starts when the user hits a carriage return.
.SH ESPS HEADER
.SH ESPS PARAMETERS
The ESPS parameter file is not referenced.
.SH ESPS COMMON
.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 overidden 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.
.PP
The following items are written into the ESPS Common file if it is
enabled:
.IP
.I "start - integer"
.IP
This is always 1.
.sp
.I "nan - integer"
.IP
The number of points in the output file.
.sp
.I "prog - string"
.IP
This is the name of the program (\fIrecord\fP in this case).
.sp
.I "filename - string"
.IP
The name of the output file.
.SH "ESPS HEADERS"
.PP
Items in the SD header of output file are set as follows:
.IP
.nf
.IR sf " = sampling frequency"
.IR dcrem " = 0"
.IR nchan " = 1"
.IR equip " = default A/D type or -d argument if given"
.IR scale " = 0"
.IR max_value " = ADMAX (from ESPS install script)"
.IR start " = 1"
.IR nan " = number of samples taken" 
.SH DIAGNOSTICS
.PP
.I Record
prints "Event Wait Timeout" if the the program quits before all the data is captured.
This can happen if the designated clock is not physically connected to the A/D converter, or if the
system load is too heavy to support the conversion.
.SH BUGS
.SH EXPECTED CHANGES
This version of the program only operates the A/D converter in
differential, bipolar mode.   The next version will have options to
change these modes.
.SH AUTHOR
.PP
David Burton, Alan Parker, Jay Virdy
Modified for CONVEX by Dale Lancaster