rel40.me

speech signal process tools

RTU 5.0.  An ICCCM complient window manager should be used with
XView programs and some of the Open Look fonts are necessary.  In
particular, these programs run well under Sun's OpenLook window
manager (\fIolwm\fP).  On HP systems they run under the VUE window
manager or the HP Motif window manager.  On Masscomp systems, they run
fine under Masscomp's Motif window manager.  
XView programs will also run using a
"vanilla" server built from the R4 MIT tape and the \fItwm\fR
window manager.  On all systems other than Suns running
OpenWindows, some of the Open Look fonts have to be installed.  We
provide them under \fI/usr/esps/xview\fR \- see the README file there. We
also provide a copy of \fIolwm\fP.
.lp
In a number of cases we have tried, acceptable
performance with non-ICCCM complient window managers results from
adding this resource to the .Xdefaults file:
.nf

	XView.ICCCMCompliant: False


.fi
.lp
For complete details about running with you system, consult the README
file in \fI/usr/esps/xview\fR.  This contains the latest information we
have about running these programs with different window managers and
servers.
.sh 2 "X Window Support for Parameter Prompting" 
.lp
The ESPS parameter file mechanism includes features for prompting the
user for needed values.  A new program \fIxprompt\fP (1\-\s-1ESPS\s+1)
supplies a similar service, but by means of interactive pop-up
windows.  \fIxprompt\fP reads a parameter file, pops up a window with
prompts for all parameters with indefinite parameter assignments
(i.e., parameters for which the "?=" operator is used in the parameter
file), and then writes a new parameter file based on the results.
(The output parameter file can then be read by the relevant ESPS
program.)  \fIXprompt\fP exploits the new parameter choices and limits
syntax that is supported in ESPS parameter files (see the discussion
of \fIsymchoices\fP (3\-\s-1ESPS\s+1), etc., below).
.sh 2 "X Window Support for 3D Plots" 
.lp
\fIPlot3d\fP is new program that produces 3D (hidden-line) plots of
FEA files.  Like \fIxprompt\fP (1\-\s-1ESPS\s+1), \fIplot3d\fP is
based on the XView toolkit.  The various OS level and window manager
issues discussed in the previous Section apply to \fIplot3d\fP as well
as to \fIxprompt\fP.  
.lp
\fIPlot3d\fP has numerous features that support the interactive study
of the input FEA data.  Users can change the viewpoint using sliders
in the control panel or mouse movements in the display window, load
and save viewpoints, plot in point mode or hidden-line mode, and control
axes labeling and units.  A mouse-driven 3D-cursor drives digital
readouts.  For more information, see the manual page.  
.sh 2 "HP LaserJet Support" 
.lp
All of the ESPS plot programs (including \fIimage\fP) now include
support for the HP LaserJet.
.sh 2 "Revised Source and Library Structure"
.lp
Multiple libraries are now supported by the ESPS source hierarchy and
compilation support programs (\fIemake\fP, \fIecc\fP, etc.)  The ESPS
library has been split into separate signal processing and utility
libraries.  As the name implies, the signal processing library
contains computational functions for signal processing.  The utility
library contains the functions that implement the ESPS file system
(header routines, record I/O routines, record keeping routines, etc.).
In most cases, the utility library is distributed in binary form only.
So called "Basic ESPS Source".  (Had we called it ESPS Basic Source,
someone might think we wrote it in BASIC!)
.sh 2 "Example Source Programs"
.lp
A directory of source examples (src_examples) is now shipped with all
binary releases (programming is possible with the binary releases
since the libraries are shipped).  Included are the source to
\fIsgram\fP (1\-\s-1ESPS\s+1), as an example of a user-level program
that uses a pre-defined FEA subtype (FEA_SPEC), and source to
\fIcross_cor\fP (1\-\s-1ESPS\s+1), as an example of a program that
uses "bare" FEA files.  Also included is the library module that
implements FEA_SPEC.
.sh 2 "Floating License Servers" 
.lp
With ESPS Version 4.0 and \fIwaves\fP+ Version 2.0 right-to-use
licenses can be "checked-out" temporarily for use as needed by
individuals on a local area network.  Many customers have asked for a
license policy that would permit them to purchase licenses based on
expected usage patterns rather than based on the number of machines
that happen to be on their network.  The so-called floating-license
technology provides this flexibility.
.lp
Our previous license policy restricted the use of licensed software to
pre-specified CPUs or servers, making it difficult for a substantial
number of occasional users to share a few licenses.  With floating
licenses, licenses are no longer restricted to specific hardware, but
are assigned dynamically as needed by users throughout the network.
.lp
A right-to-use license is required for each node in simultaneous use
on a network.  (A network node is any compute-engine with a unique
host name and network address.)  Right-to-use licenses can be assigned
automatically ("checked out") by a software license manager until the
supply of available licenses is exhausted.  Alternatively, if dynamic
assignment isn't appropriate, the available licenses can be
pre-allocated.  An ESPS license checked out (or pre-allocated) to a
particular node may be shared by any number of simultaneous ESPS
users.
.lp
The programs \fIecheckout\fP (1\-\s-1ESPS\s+1) and \fIefree\fP
(1\-\s-1ESPS\s+1) are used to checkout and return an ESPS license.  
If a license is checkout out on any given CPU, any user can run 
any number of ESPS programs on that CPU.  
.lp
The new floating-license technology requires that a license server
(\fIelmd\fP) daemon be run somewhere on the network.  More information
about this (and about the administration of licenses) is contained in
the installation instructions.
.sh 2 "Documentation Additions"
.lp
The following new documents are included in this release:
.nf
.ta .5i

	"FEA_SD Files \- Feature Files for Sampled Data in ESPS"
	"Calling FORTRAN Subroutines from ESPS Programs"
 	"Applications Note: Converting to and From ESPS Files" 	
	"Machine-Independent File I/O in ESPS"

.fi
.sh 1 "CHANGES TO USER-LEVEL ESPS PROGRAMS"
.sh 2 "New Programs or Major Revisions" 
.lp
New programs include \fIxprompt\fP and \fIplot3d\fP, discussed
earlier.  
.sh 3 "New Program for Formatted Printing of FEA Records" 
.lp
Courtesy of Richard Goldhor (Sensimetrics, Inc.), we are including 
a program that prints selected elements from selected FEA records 
using print formats that are defined by the user.  The new program, 
\fIfea_print\fP (1\-\s-1ESPS\s+1), is modeled after \fIfea_deriv\fP.  
An ASCII input file names the elements to be printed from each record
and provides a corresponding (C program) format specification.  A
common use of \fIfea_print\fP is to print one FEA record per line with
selected field elements appearing in different columns. 
.sh 3 "New Program for Conversion from FEA to FEA_SD"
.lp
A new program \fItofeasd\fP accepts an arbitrary FEA file and produces
a sampled data (FEA_SD) output file with the "samples" data being
taken from a specified field in the input file.  The sampling rate is
derived from that of the input file, but can also be set directly.
See also \fImake_sd\fP (1\-\s-1ESPS\s+1).  
.sh 3 "Enhanced \fIimage\fP and \fIplotsgram\fP" 
.lp
The general image display program \fIimage\fP has
been enhanced to support Postscript output.  Also, \fIimage\fP now
chooses the default gray-scale algorithm at run-time according to
whether the system has one or several planes.  An option (\fB-C\fP) was
added to read colormaps.  An option (\fB-L\fP) was added to choose
whether to label the axis in points, records, or seconds
(independently of whether \fB-p\fP, \fB-r\fP, or \fB-s\fP was used to
specify the range).  An option (\fB-M\fP) was added to control a
magnification factor for output on Imagen, Postscript, and Hewlett
Packard printers (thereby permitting lower-resolution but faster
output).  An option (\fB-D\fP) was added to disable linear
interpolation and cause a uniformly colored rectangle to be displayed
for each data point.  A new \fB-f\fP option (ESPS convention for field
name) has been added as a synonym for \fB-e\fP).
.lp
The spectrogram display script \fIplotsgram\fP now has a \fB-x\fP
option that can be used for debugging.  \fIPlotsgram\fP has
been modified to exploit the new version of \fIimage\fP.  (Thus, for
example, a dithered spectrogram display is the default only for
systems with single-plane graphics.)  All of the new \fIimage\fP
options can be given to \fIplotsgram\fP for passing on to 
\fIimage\fP.  For example, \fB-D\fP can be
given to disable linear interpolation.  A useful side effect of the
new options is that it is now easier to obtain hard copies of
\fIwaves\fP+ spectrograms.  Since \fIplotsgram\fP can be used with a
\fB-r\fP to specify the range, one can set up waves (via the new
add_espsn command) to call \fIplotsgram\fP on a marked portion of any
displayed spectrogram.	   
.sh 3 "Enchanced \fItestsd\fP"
.lp
The \fItestsd\fP program generates test sampled data.  In revising it
to produce FEA_SD files, the following enhancements were made:
.np
New signal types were added for constant (DC) data, square waves,
sawtooth waves, triangle waves, and uniform noise.  (The old types of
sine waves, Gaussian noise, pulses, and arbitrary input ASCII data are
still supported.)
.np
The type of the output data can now by any supported data type,
including all of the complex types.  The new options \fB-t\fP and
\fB-c\fP support type selection (the \fB-i\fP is still supported).
For the SINE type, complex output is a complex exponential.  For the
noise types, independent noise is generated for the real and imaginary
parts.  For the other signal types, the real and imaginary parts are
identical.
.np
All periodic signal types (SINE, SQUARE, TRIANGLE, SAWTOOTH, PULSES) 
can be specified with an initial phase (\fB-A\fP option).  
.np
All periodic signal types can have a linear frequency sweep ("linear
chirp"), supported by the new \fB-C\fP option.  
.np
For all signal types but ASCII, a decaying exponential input can be 
imposed by means of the new \fB-d\fP option.  
.np
Data output is now buffered so that \fItestsd\fP works efficiently as
the initial program on a pipe.  
.np
Parameter file processing was modified to support all of these changes
(e.g., when \fItestsd\fP is called via \fIeparam\fP).  
.sh 3 "Multiplication of Sampled Data"
.lp
The program \fImultsd\fP supports multiplication of sampled data
(e.g., for modulation).  Both \fIaddsd\fP and \fImultsd\fP will work
with complex data.  (Actually, \fIaddsd\fP and \fImultsd\fP are links
to the same binary, which performs addition or multiplication
depending on the name used to invoke the program.)  Note that if you
want to compute expressions more elaborate than possible with
\fIaddsd/multsd\fP, you can can do so by using a combination of
\fImergefea\fP and \fIselect\fP (see Section 7). 
.sh 3 "Program to Facilitate use of ESPS Parameter Files from Shell Scripts"
.lp
The program \fIgetparam\fP processes an ESPS parameter file, obtains
the value of a named parameter, and prints that value in ASCII on
standard output.  All of the standard parameter file processing
features are supported, included ESPS Common processing and
interactive prompting.  The main purpose of \fIgetparam\fP is to
facilitate writing shell scripts that process ESPS parameter files.
In particular, \fIgetparam\fP makes it much easier to write ESPS shell
scripts and C programs with exactly the same user interface.  
.sh 3 "Program for Computing Mandelbrot Sets"  
.lp
The Mandelbrot has become a marketing favorite to show off graphics,
so of course we ended up having to write one too.  The result is
\fImbrot\fP (1\-\s-1ESPS\s+1), which we now include in the
distribution.  The results can be displayed using \fIimage\fP and (via
\fItofspec\fP) \fIwaves\fP+,
.sh 3 "Program for mu-law Encoding"
.lp 
\fIesps2mu\fP converts an ESPS FEA_SD file to a headerless binary file
containing mu-encoded data. The format of the data is appropriate for
use with the SPARCstation 1 codec chip.  (Note that the SPARCstation
expects data that was sampled at 8000 samples/second data.)
.sh 3 "Programs for SPARCstation Codec"
.lp
The new program \fIsplay\fP provides speech output on the SPARCstation
I.
.sh 3 "Program to Display Sun Raster Files"
.lp
The program \fIshowras\fP reads a file contain data in Sun rasterfile
format, creates a window, and displays the image in the window.  
The program runs only on Sun systems under SunView.  It can be useful,
for example, if images are generated remotely using the \fB-T\fPras
option on \fIimage\fP but are to be displayed locally under SunView.  
.sh 3 "Program for Current ESPS Version"
.lp
The new program \fIeversion\fP prints out the current ESPS version
number.  The \fB-u\fP option displays an on-line copy of these release
notes \- this is a good way to inform users about changes in the
current version.
.sh 2 "Changes to Support FEA_SD" 
.lp
All of the programs that accept or produce sampled data files (SD
files in previous releases) have been changed to accept FEA_SD or 
(for compatibility) SD files, and to produce FEA_SD files.  The new
programs \fIsdtofea\fP and \fIfeatosd\fP provide conversions between
the old and new file types.  
.lp
All programs that process sampled data (FEA_SD) files have been
modified to accept \fB-r\fP as a synonym for the range option
\fB-p\fP.  Thus, it should now be the case that \fB-r\fP (range in
records) can be used with any ESPS program that accepts a range
option.  An associated change in \fIplay\fP, \fIwplay\fP, and
\fIsdcomp\fP is that the existing \fB-r\fP (repeat) option was changed
to \fB-R\fP.  Also, an associated change in \fIwaves\fP+ is that all
external calls to ESPS programs now use \fB-r\fP to specify the marked
ranged.
.sh 2 "Programs that Handle Complex Data"
.lp
The following FEA_SD programs have been modified to handle (single
channel) complex sampled data (in the sense that appropriate
processing is done): \fItestsd, addsd, multsd, copysd, fft fftinv\fP.
The following general FEA programs have been modified to handle
complex data: \fIatosps, spstoa, addfea, addfeahd copysps,
fea_element, mergefea, pplain, psps, ereverse, feafunc\fP.  Other
programs either "do their thing" on the real part or refuse to run on
files with complex data.  Additional programs will be modified to
handle complex data in future releases.
.lp
Note that \fIcopysps\fP requires that both input and update file 
be either EDR or NATIVE.  
.sh 2 "Other Significant Changes to User-Level Programs"