relnote3.2.m

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

.lo
.ce 2
.b
ESPS 3.2 Release Notes
.sp
11/8/88 1.4
.sh 1 "Introduction"
.lp
This document provides notes relevant to release 3.2 of ESPS.  Please
read this document and the Installation Instructions completely before
installing this release of ESPS.
.sh 1 "Contents of this Kit"
.lp
The ESPS 3.2 installation kit contains magnetic media of the ESPS 3.2
distribution.  This is a complete distribution; it is not an update to 3.1.
For Masscomp systems the magnetic media is either a set of diskettes or one
9 track tape.  For Sun systems the media is either a cartridge tape or one
9 track tape.  In any of these cases, the media contains the source
distribution in Unix \fItar(1)\fR format.
.lp
If you do not already have ESPS the the kit also contains a User's Manual,
containing documents describing the use of the system and manual pages for
all programs, library functions and file types.  If you do have ESPS, then
the kit contains update pages for your User's Manual.  The documents
provided are important, and should be read by all users of the system.
They provide essential information about using and programming with ESPS.
.sh 1 "A Comment About Masscomp Universes"
.lp
Masscomp provides a dual universe environment on their systems.  By
using the \fIuniverse\fR command, a user can set his compilation
environment to be either ATT System V, or Berkeley 4.2.   ESPS is to be
installed under the UCB universe (command: \fIuniverse ucb\fR).  In most
cases, since the library is created under ucb, user programs must also
be compiled and linked under ucb.    You will notice one exception, our
scripts and makefiles use the \fIlint\fR under att.  This is because lint has
some problems under ucb.
.sh 1 "Differences Between 3.1 and 3.2"
.lp
Please duplicate this section and make it available to all users of
ESPS.  This information is needed by others than just the ESPS
installer.
.sh 2 "New Programs"
.lp
There are thirteen new programs in 3.2 and two replacement programs.  Please
refer to the manual pages for details.
.np
\fIaddfea\fR - adds data (in ASCII) to an existing feature file or creates a
new file.
.np
\fIaddfeahd\fR - adds an ESPS header to a user supplied non-ESPS file.
Used to import files into ESPS.
.np
\fIaddgen\fR - adds a generic header item to an existing ESPS feature
file.
.np
\fIEspsenv\fR - prints the value of Unix environment variables used by
ESPS.
.np
\fIhditem\fR - prints the value of a header item.  Useful for use inside
backquotes in a shell command.
.np
\fIiir_filt\fR - design recursive (IIR) filter.
.np
\fIimage\fR - provides a grey-scale display of a feature file (e.g., for 
spectrograms).
.np
\fIme_spec\fR - \fIfanaspec\fP renamed with new capabilities (will
produce maximum entropy power spectrum from vector of parameters in 
any FEA file; used to require FEA_ANA file).  
.np
\fItranspec\fP - this is similar to \fIspectrans\fR.
The main difference is (like the change from \fIfanaspec\fP to 
\fIme_spec\fP, \fItranspec\fP does not require a FEA_ANA file.  It 
permits the transformation of one spectral representation to another 
for a vector of parameters in any FEA field.  
.np
\fItoep_solv\fR - solves real symmetric Toeplitz systems of linear
equations.
.np 
\fIframe\fR - creates FEA records containing windowed sampled data
frames.
.np
\fIsetrange\fR - convert SD sample range (seconds) to samples and leave
in ESPS Common (useful for specifying range in seconds).  
.np
\fIpwr\fR - computes power of sampled data in FEA files.
.np
\fIwindow\fR - windows sampled data in FEA files.
.np
\fIzcross\fR - computes the average zero crossing rate for sampled data in 
FEA files.
.lp
The programs \fIframe\fP, \fIpwr\fP, \fIwindow\fP, \fIzcross\fP together
demonstrate a processing scheme under consideration as a general
practice for ESPS Version 4.0 programs that process a series of
constant-length sampled-data frames.  The program \fIframe\fP accepts
an ESPS SD file and produces a FEA file with one field per record, the
field containing the the sampled-data for one frame.  \fIFrame\fP
supports overlapping frames and windowing.  The idea is to use
\fIframe\fP as a general preprocessor for any program that works on
frames of sampled data, so that the code for framing and windowing
doesn't have to appear in every such program.  \fIPwr\fP is an 
example of such a program; it processes FEA records containing 
sampled-data vectors and adds a field giving the power in the vector.  
Another program is \fIzcross\fP; it processes FEA records containing
sampled-data vectors and computes the average zero-crossing rate for
each frame.
A command line like:
.sp
	%frame -l 100 -S 10 -w hamming test.sd | pwr - - | zcross - foo
.sp
would leave in foo a FEA file containing records with three fields per
frame:  the sampled data vector for that frame, the power, and the average
zero-crossing rate.  Because windowing sometimes is required after certain
other processing, the program \fIwindow\fP needs to work on sampled data
vector fields of arbitrary FEA files.
.lp
.sh 2 "Other Major Changes"
.lp
For details on the following changes, please refer to the appropriate
manual page.
.np
New version of \fIplotspec\fP.  The new version has an option -D that
forces plotting in dB whether the values in the file are in dB or not.
Spectrum types ST_PWR, ST_REAL, and ST_CPLX are converted to dB before
plotting.
.np
Updated \fImcd\fP on Sun, so that it uses retained image mode
except when resizing (yields much faster graphics when icons are
opened or windows uncovered).
.np
Added -s option to \fIbtosps\fP to specify a number of bytes to skip
at the beginning of the file.
.np
Updated \fIrefcof\fP and \fIfft\fP:  For both of these the following were
added:  overlapping frames (including gaps between frames), and windowing
of sampled data before analysis.
.np
Plot scripts (\fIplotsd, plotspec, aplot, genplot, mlplot\fP) take "hardcopy"
as a device type for the -T option.  Was "imagen" before.  The
"hardcopy" option sends the output in Tektronix format to the program
identified in the install script.
.np
Added -f option to \fIpplain\fP to allow naming of FEA fields.  
.np 
\fIMcrecord\fP (Masscomp only) outputs data file to standard out when
filename given is "-".
.np
\fIFea_stats\fP changed to add the number of vector samples as a field, 
to correct problems in proper record keeping with embedded headers, 
and to fix a memory allocation bug.  
.np
\fIFilter\fP has been modified to allow output data type specification on
the command line.  In addition, checks have been added to detect when too
large a value is stuffed into a smaller data type.
Also sampled frequency in filt file is checked against SD in data file.
.np
Changed \fImcplay\fP to save/get gain and shift from Common.
.np
Removed Fortran \fImatinv\fP routines, and added new matinv.c.
No Fortran at all in ESPS now.
.np
Modified \fIselect\fP so that eval with -e option doesn't put out
record number labels, etc.   Useful when you desire to feed the output
of a \fIselect\fP -e directly to another program, such as \fIaddfea\fP.
.np
Changed \fIselect\fP to create new output file as segment labeled if
the input files are tagged.
.np
Added field_order option to headers.c and feasupport.c in the library.
This causes feature files to be written in field order, that is, the order
of the data record fields in the disk file is the order in which fields
were defined in the feature header, rather than ordered by data type.
See FEA(5\-ESPS) for details.  This change was needed for the new program
\fIaddfeahd\fP.  Added a check to gensupport.c to print a message and exit
if it is called on a field_order file.
.np
Added hostname to current path field (headers.c).
.np
Modified plot scripts, install script, and makefile to support
the ability to specify the name of the \fImcd\fP program (needed for
integral graphics on Masscomp with mcdigh).
.np
Changed \fIfea_element\f to add -n option to suppress column headings
(useful when output is to be used by \fIaddfeahd\fP).  
.np
Added new library functions addstr to library (and man page).
.np