relbin33.me

speech signal process tools

.lo
.ce 2
.b
ESPS 3.3 Release Notes (Binary Release)
.sp
1/26/89 1.1
.sh 1 "Introduction"
.lp
This document provides notes relevant to release 3.3 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.3 installation kit contains magnetic media of the ESPS 3.3
distribution.  This is a complete distribution; it is not an update to 3.2.
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 a binary ESPS
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.2 and 3.3"
.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 1 "Previous 3.2 Versions"
.lp
There was a 3.2b and 3.2c distribution.  You may have initially received
one of these.   Here are the changes from 3.2 to 3.2c:
.sh 2 "New Programs"
.lp
There are several new programs.
.np
A new library function \fIlsqsolv\fR had been added.  See the manual
page updated for details.
.np
Scripts to produce speech spectrograms have been added, \fIsgram\fR and
\fIplotsgram\fR.  See the manual pages for details.
.np
\fIsfconvert\fR is a new program for converting the sample rate of
sampled data files.
.np
\fIme_sgram\fR added. This program produces a maximum-entropy based SPEC
file suitable for display as a spectrogram.
.sh 2 "Other Changes"
.lp
For details on the following changes, please refer to the appropriate
manual page.
.np
Changed \fIfea_edit\fR so that records are numbered from 1.
.np
Added the -h option to \fIbhd\fR, to remove the data and leave the
header.
.np
Added support for external reference files in the data file header.  A
pointer in the header can now refer to an ESPS or ASCII file external to
the file itself.   See the History memo and \fIadd_genhd\fR(3-ESPS) for
details.
.np
Modified \fIpsps\fR and \fIaddgen\fR for the external reference file
support (EFILE and AFILE).
.np
Bug fixes in \fInotch_filt\fR and \fIfind_ep\fR.
.np
Bug fix in \fIplotsd\fR, relating to plotting a file that contains all
records with a single value.
.np
Changed Sun \fImcd\fR and plot programs to accept standard Sunview
options.
The manual page for \fImcd\fR doesn't show that it accepts the Sun
Sunview options, but it does.   See the Sunview Programmer's manual for
a list of these options.
.sh 1 "Changes in 3.3 since 3.2c"
.np
Version 3.3 supports ESPS on Hewlett Packard series 300 and 800
computers.  
.np
A major change in 3.3 is that SPEC (spectral) files have been
reimplemented as a subtype of feature files (the same will happen to
SD and FILT files in future releases).  The new file type is
called FEA_SPEC.  A support module has been added to the library to
handle this file type.  Most programs that deal with old SPEC files
have been changed to use new FEA_SPEC files.  A set of conversion
programs are available to convert from SPEC to FEA_SPEC files and
back; (\fIspectofea\fR and \fIfeatospec\fR).  SPEC files still work;
that is they are still supported in the library and old SPEC files can
be used by some programs.  To use an old SPEC file with a program that
no longer handles old SPEC files, just use \fIspectofea\fR to convert.
If you have your own programs that use SPEC files, you should convert
them to FEA_SPEC files.  The following programs have been modified to
handle FEA_SPEC files: \fIme_spec, filtspec, fftinv, fft, plotsgram,
sgram, plotspec\fR and \fIme_sgram\fR.  The only programs that do not
support FEA_SPEC files directly are \fIimage\fP and \fIdistort\fP;
use \fIfeatospec\fP as appropriate (these two programs will change to
FEA_SPEC in the next release).  
.np
Another major change in ESPS for this release is that 3.3 supports
\fIwaves\fP+, our optional interactive graphics interface for ESPS on
Sun workstations.  Many programs were modified to maintain the generic
header items \fIstart_time\fR and \fIrecord_freq\fR.  These are needed
pin data files to allow \fIwaves\fP+ to time align data files when they
are displayed.  A new library function,
\fIupdate_waves_gen(3\-ESPS)\fR has been added to maintain these
generics.  If you write a program that processes sample data, or a
feature file, you should use this library function.  The following
programs have been modified to maintain these header items: \fIaddsd,
fea_deriv, lpcana, find_ep, me_spec, sf_convert, me_sgram, vq,
filtspec, fftinv, frame, zcross, pwr, window, distort, refcof, filter,
copysps, transpec, setrange, copysd, cross_cor, classify,\fR and
\fIauto\fR.
.np
The following new user-level programs are available:
.ip "\ \ \ \fIdither\fP"
This program adds a digital halftone bit-map field to a FEA files.  
It was developed for an intermediate version of other ESPS programs.  
Version 3.3 ESPS does not require \fIdither\fP, but it is provided in
case users want to get their hands on a dithered representation of 
spectrograms or other images.  
.ip "\ \ \ \fItofspec\fP"
This program converts a FEA file to a FEA_SPEC file.  It is needed
primarily by \fIwaves\fP+ users who wish to display arbitrary
FEA data in spectrogram form.  
.ip "\ \ \ \fIspectofea\fP
Converts old-style SPEC files to FEA_SPEC.
.ip "\ \ \ \fIfeatospec\fP"
Converts FEA_SPEC files to old-style SPEC.  
.np
The program \fIsgram\fR has been replaced.  The older version was a
shell script.  It is now a C program (i.e., faster, and also supports
standard I/O).  Some options have changed.  If you use this, please
check the man page.
.np
The library routine \fIwindow\fP (3\-\s-1ESPS\s+1) was changed to
support additional window types HANNING and COS4.  Several user-level
programs were changed to exploit this.  
.np
A new library routine \fIprint_feaspec_rec\fP has been added to
support FEA_SPEC programming.  
.np
The semantics of \fIadd_genhd\fP (3\-\s-1ESPS\s+1) has changed so 
that it is no longer an error to call on an existing header item.  
If such a call is made, the old value is replaced with the new one.  
.np
A new library routine \fIget_genhd_val\fP has been added \- this 
returns any item as a double and furthermore returns a default value 
(a parameter) if the item is undefined.  
.np
A new library routine \fIinhibit_hdr_date\fP was added.  This causes 
the next call on \fIwrite_header\fP to not change the date field.  
\fIComment\fP (1\-\s-1ESPS\s+1) and \fIaddgen\fP (1\-\s-1ESPS\s+1)
were changed to use this, so that the date field gives the date when
the file was created.  
.np
The user-level programs \fIzcross\fP, \fIpwr\fP, and \fIwindow\fP were
changed to copy all generics to the output file.  
.np