rel4.1.me

来自「speech signal process tools」· ME 代码 · 共 808 行 · 第 1/3 页

.lo
.de SM          \"macro to shrink left margin
.br
.nr $i \\n($i+\\$1i
..
.de RM          \"macro to restore original left margin
.br
.nr $i 0
..
.he 'ESPS Version 4.1 Release Notes''page %'
.ce 3
.b
ESPS Version 4.1 Release Notes
.sp
Document version: 1.14 11/21/91
.sh 1 "INTRODUCTION"
.lp
This document provides notes for release 4.1 of ESPS.  These release
notes document changes to ESPS since the revision 4.0c.  This document
can be viewed conveniently using \fIeinfo\fP (1\-\s-1ESPS\s+1) or
\fIeversion\fP (1\-\s-1ESPS\s+1).
.sh 1 "SUMMARY OF MAJOR CHANGES"
.lp
Perhaps the most important change in this release is the introduction
of powerful X Interface Generation (XIG) capabilities.  XIG refers to
the combined facilities of various programs and libraries; included
are \fIfbuttons\fP, \fImbuttons\fP, \fIexprompt\fP, \fIexpromptrun\fP,
\fIxeparam\fP, \fIxtext\fP, and \fIxwaves\fP+ (see the \fIxwaves\fP+
release notes for a summary of \fIxwaves\fP+, and \fIlibxv\fP.  For an
overview, see the new ESPS applications note "X Interface Generation
in ESPS and \fIxwaves\fP+".  For a detailed example, look at the
directory structure and files that comprise the new demos
($ESPS_BASE/newdemos).  The sources for one of these are provided in
$ESPS_BASE/src_examples/xig/testsignal.
.lp
Other major changes include the following:
.ip \ \ \ \(bu
Over 25 new user_level signal processing and utility programs, including
.SM .75i
.ip *
programs for dynamic time warping, fft cepstrum, and VQ-based
classification
.ip *
cover-program for computing acoustic classification parameters
.ip *
programs for Nth-order differences and for clipping
.ip *
interactive program for pole-zero filter design
.ip *
conversion programs for MATLAB files
.RM
.ip \ \ \ \(bu
Over 35 new signal processing and utility library functions, including
.SM .75i
.ip *
signal processing library functions for dynamic time warping, bilinear
transform, FFT cepstrum, structured covariance, etc.
.ip *
utility functions for skip headers, free headers, fork programs, 
generate temp files, communicate with an \fIxwaves\fP+ display server,
etc. 
.RM
.ip \ \ \ \(bu
new utility library to support XView programs
.ip \ \ \ \(bu
ESPS programs now read files with NIST (Sphere) headers
.ip \ \ \ \(bu
Improved support for reading headerless files and files with 
foreign headers
.ip \ \ \ \(bu
All filter-related programs modified to use a feature file format (FEA_FILT).
.ip \ \ \ \(bu
Structured covariance (and fast structured covariance) methods for
computing autocorrelations (and autoregressive spectra) have been
added to the library, as well as to \fIrefcof\fP, \fIlpcana\fP, and
\fIauto\fP.  These methods are particularly good on short data
sequences (such as those that produce "classic" line splitting from
the modified Burg method).
.ip \ \ \ \(bu
\fIfeafunc\fP has many more arithmetic functions and can also 
be used for FEA field name or type changes
.ip \ \ \ \(bu
\fIplot3d\fP can now drive synchronized \fIxwaves\fP+ cursors
.ip \ \ \ \(bu
filters are now represented by feature files (FEA_FILT)
.ip \ \ \ \(bu
\fIsplay\fP includes approximate (fast) down-sampling code (for 
signals not sampled at 8000 Hz.) 
.ip \ \ \ \(bu
"position-independent" installation (no longer /usr/esps)
.ip \ \ \ \(bu
new program for on-line documentation (\fIeinfo\fP)
.sh 1 "CHANGES TO USER-LEVEL ESPS PROGRAMS"
.sh 2 "Position independence; Environment Variables" 
.lp
ESPS and \fI(x)waves\fP+ have been made "position independent".  
In practice, this means that the system (or a link) no longer 
has to be at /usr/esps.  Thus, root access is no longer required, and 
it is easy to switch between different versions (e.g., between old
and new release). 
.lp
To support position independence, and to support customization of 
ESPS/\fI(x)waves\fP+ packages, various environment variables 
have been defined.  The main ones are these: 
.ip ESPS_BASE
This should be set to the root of the ESPS (and \fIwaves\fP+) install
tree.  If not defined, programs all use /usr/esps as a default. 
.ip ESPS_TEMP_PATH
This can be set to the directory that you want programs to use for
temporary files.  Not all programs currently pay attention to
ESPS_TEMP_PATH, but over time they will be modified to do so.  The 
plot programs have been modified to support ESPS_TEMP_PATH.  
.ip ESPS_MENU_PATH
This is the path used by \fImbuttons\fP (1\-\s-1ESPS\s+1) and
\fIfbuttons\fP (1\-\s-1ESPS\s+1) to find \fIolwm\fP-format menu
files.   If ESPS_MENU_PATH is not defined, the default path used is
".:$ESPS_BASE/lib/menus".
.ip ESPS_PARAMS_PATH
This is the path used to find ESPS parameter files specified by the
standard ESPS \fB-P\fP option.  If ESPS_PARAMS_PATH is not defined,
the default path used is ".:$ESPS_BASE/lib/params".
.ip DEF_HEADER
If defined when \fIread_header\fP() encounters
a headerless file, DEF_HEADER specifies a default header to be used.  
.ip DSP_NO_LOCK
If set, disables locking of the DSP by \fIwaves\fP+, \fIxwaves\fP+,
and the record and play programs.
.sh 2 "LICENSE MANAGER CHANGES"
.lp
Unlike the previous version, the environment variable \fBELM_HOST\fR
must now always be defined.  It must always contain the hostname of the
host running the Entropic License Manager (\fIelmd\fR).  It is best to
have all users define this in their \fI.cshrc\fR (or equivalent).
One other environment variable affects the license manager system:
.ip ELM_TIMEOUT
controls the length of time \fIxwaves\fP+ and ESPS programs wait while
trying to contact the license server.   The default is 10 seconds.  Some
adjustment may be required depending upon the nature of your network.
.sh 2 "NIST (Sphere) HEADERS"
.lp
ESPS sampled data programs now read NIST (Sphere) format sampled data
files.  This is also the case for all ESPS programs that process
sampled data.  Thus, (x)waves+ and ESPS can now be used directly on
the following NIST databases: TIMIT, Air Travel Information System
(ATIS), Extended Resource Management, TIDIGITS, and Resource
Management.  Note that files produced by ESPS continue to be in ESPS
format.
.sh 2 "READING HEADERLESS FILES"
.lp
ESPS also has improved support for dealing with headerless files. 
In particular, if any ESPS program does not recognize an input file (to
be precise, it's \fIread_header\fP (3\-\s-1ESPS\s+1) that's doing
this), the file is assumed to be "headerless".  If in this case the
\fIunix\fP environment variable DEF_HEADER is defined and points to a
file with a valid ESPS header (whether or not there is data in that
file is irrelevant), the header of that file is used as a "virtual"
header for the headerless file.  Thus, the data description in the
DEF_HEADER should be valid for the input data.  The ESPS conversion
programs \fIbtosps\fP and \fIaddfeahd\fP are useful in creating such
headers.  Here's an example that creates a 12 Khz FEA_SD header 
and uses it to filter a headerless data file sg1.a1:
.nf

	%btosps -f 12000 -c "header for sg1" /dev/null k12.hd
	%setenv DEF_HEADER `pwd`/k12.hd
	. . . 
	%filter -F data/sg1.filt  data/sg1.a1 sg1.a1.filt.sd
	%send_xwaves make file sg1.a1.filt.sd

.fi
The last command sends an \fIxwaves\fP+ display server a command to
display the filtered file.  Note that the output files are ESPS files
(i.e., they have ESPS headers).  Note also that this approach is not
limited to sampled data.  DEF_HEADER can point to any FEA header, and
it will "do the right thing" with any FEA-eating program, provided
that the header properly describes the data.
.sh 2 "FILES WITH FOREIGN HEADERS" 
.lp
If data files have foreign headers, it can be convenient to leave them
in place during ESPS processing, so that they are left when a final
ESPS \fIbhd\fP is run.  To support this, \fIbtosps\fP, \fIaddfeahd\fP,
and \fIbhd\fP have options to leave skipped data (the foreign header)
in place, for example:
.nf

  btosps -S 512 -F for.sd - | filter -F esps.filt - - | bhd -F - for.filt.sd

.fi
The \fB-F\fP option on \fIbtosps\fP causes the 512 skipped bytes to be
kept in place between the ESPS header and the data.  Actually, it is
kept there by means of new generic header items in the ESPS header, so
that it will be carried along by later programs (like \fIfilter\fP,
above).  The \fB-F\fP option on \fIbhd\fP causes the foreign header to
be left in place after the ESPS header is removed.  The result, in the
above case, is a pipe that starts and ends with a file in the foreign
format.
.lp
Foreign headers are kept in the ESPS header in the following 
manner:  The generic header item \fIforeign_hd_length\fP 
contains the size (in bytes) of the foreign header.  If this
item is present (and non-zero), \fIread_header\fP() will 
read this many additional bytes of data, put it into the 
header, and set an additional generic header item 
\fIforeign_hd_ptr\fP to point to it.  From that point on, 
the foreign header is just part of the ESPS header.  Note that
one can use \fIaddgen\fP (1\-\s-1ESPS\s+1) to modify 
\fIforeign_hd_length\fP in the header specified by DEF_HEADER
before calling an ESPS program. 
.lp
With this mechanism, it is possible to write programs that 
use the ESPS header and record I/O functions while still having
access to the foreign header.  The procedure is simple: use 
\fIread_header\fP() to read the ESPS header, and \fIget_genhd\fP() 
to get the pointer to the foreign header.  
.sh 2 "New License Manager Release"
.lp
A new license manager accompanies this release. 
A \fIunix\fP environment variable
ELM_TIMEOUT is available to control the length of time programs
waits while trying to contact the license server.
.sh 2 "New Programs"
.np
\fIfbuttons\fP - new program that pops up a panel of screen buttons
for invoking one of a given set of programs on one of a given set of
files.  By default, fbuttons is configured to either play the contents
or view the header of files in the current directory with suffixes
".sd" or ".d", but arbitrary program and file sets can be specified.
.np
\fImbuttons\fP - new pops up a panel of screen buttons for invoking
arbitrary ESPS program calls (e.g., creating certain test signals,
sending display commands to \fIxwaves\fP+, whatever).  Standard OLWM (same
as Sunview) format menu files can be used to specify the button names
and associated commands.
.np
\fIexpromptrun\fP \- new program that provides an extended version of
\fIexprompt\fP.  It prompts for parameters in an X window (like
\fIexprompt\fP) and then runs the associated ESPS program on the
resulting parameter file.  \fIexpromptrun\fP terminates after the ESPS
program terminates.  For example:
.nf

   %expromptrun -h sgram -P PWsgram sgram -r1:2000 speech.sd speech.fspec

.fi
puts up a an interactive form based on the parameter file (PWsgram is
a new paramfile in lib/params that prompts for all but \fIstart\fP and
\fInan\fP; note that \fIread_params\fP now uses a search path that by
default includes . and $ESPS_BASE/lib/params), and then uses the
resulting parameters to compute a spectrogram on the first 2000 points
of speech.sd.  \fIxromptrun\fP is well suited for shell scripts and
particularly for \fIxwaves\fP menu commands.  For example:
.nf

      add_espsf name "custom spectrogram" menu wave command \\
		expromptrun -h sgram -P PWsgram sgram 

.fi
adds a custom spectrogram (with parameter prompting) to the
\fIxwaves\fP waveform menu.  (You can add this to the menu via the
menus->"menu changes"->"add waveform buttons" buttons provided in the
default startup environment.)
.np
\fIxeparam\fP \- new program that runs \fIexpromptrun\fP in the 
manner of \fIeparam\fP; i.e., you just give it the ESPS command 
line for a program, and it prompts for the needed parameters.  
.np
\fIacf\fP - new program that computes a selection of acoustic
recognition features (includes mel-warped cepstrum).
.np
\fIxacf\fP \- new program that provides an interactive (X-Windows)