wrel2.1.me

speech signal process tools

.lo
.he '\fI(x)waves+\fP Version 2.1 Release Notes''page %'
.ce 3
.b
\fI(x)waves\fP+ Version 2.1 Release Notes
.sp
Document version: 1.25 11/7/91
.sh 1 "INTRODUCTION"
.lp
This document provides notes relevant to release 2.1 of \fIwaves\fP+
and \fIxwaves\fP+.  This note documents changes to \fIwaves\fP+ and
\fIxwaves\fP+ since the revision 2.0c.  This document can be viewed
conveniently using \fIwinfo\fP (1\-\s-1ESPS\s+1) or \fIeversion\fP
(1\-\s-1ESPS\s+1).
.lp
Version 2.1 exploits various new items from the .wave_pro file.  
.nf
.b

      It is important that all users delete or move any .wave_pro 
      file from their home directory before using Version 2.1.
      Old .wave_pro files will not enable many of the new features
      now available in (x)waves.

.r
.fi
.lp
Personal preferences from old .wave_pro files should be merged into a
fresh .wave_pro starting from a copy of $ESPS_BASE/lib/waves/.wave_pro
(which is the profile obtained by default if none exists in the home
directory).  This default profile file has comments which provide an
explanation of the semantics of each settable attribute.
.sh 1 "STATUS OF SUNVIEW \fIwaves\fP+"
.lp
This is the last release of Sunview \fIwaves\fP+, and it does not
contain many of the improvements in \fIxwaves\fP+.  In contrast to
\fIxwaves\fP+ this release of \fIwaves\fP+ is not greatly improved
over the previous one. Version 2.1 of \fIxwaves\fP+ is greatly
improved and we encourage users to switch to it.
.sh 1 "SUMMARY OF MAJOR CHANGES"
.lp
The major distinguishing feature of \fIxwaves\fP+ Version 2.1 is the X
Interface Generation (XIG) features for customizing and extending the
user-interface.  By using a variety of simple ASCII configuration
files, it is easy to produce highly-customized \fIxwaves\fP+/ESPS
packages that meet personal or application-specific needs.  

For a
detailed example of this, 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
Here is a brief summary of the major changes that are in the 
release.  
.ip \ \ \ \(bu
\fIxwaves\fP+ menus are fully-reconfigurable on startup, via
command files, and by direct input; menu items can have arbitrary
names, can invoke built-in (i.e., the original) functions, 
can invoke arbitrary \fIwaves\fP+ commands or command scripts, 
and can invoke external programs;
.ip \ \ \ \(bu
A new item (\fIinit_file\fP) in the .wave_pro specifies a command file
to be executed after \fIxwaves+\fP starts up (before loading any files
or executing a command file given on the command line); The default
profile invokes a standard default initialization file that provides a
convenient environment for certain changes to \fIxwaves\fP+ menus and
globals.  
.ip \ \ \ \(bu
an arbitrary number of external ESPS calls (\fIadd_espsX\fP) 
can be added to \fIxwaves\fP+ menus;
.ip \ \ \ \(bu
\fIxwaves\fP+ supports user-defined screen-button panels, with 
buttons that execute arbitrary commands or command files;
.ip \ \ \ \(bu
\fIwaves\fP and \fIxwaves\fP will read NIST (Sphere) format 
sampled-data files (e.g., the TIMIT database), and has improved
support for files with "foreign" headers. 
.ip \ \ \ \(bu
\fIxspectrum\fP improvements: power/magnitude plots, harmonic cursors,
additional high-resolution spectral analysis methods (Burg, Modified
Burg, Fast Modified Burg, Structured Covariance, Fast Structured
Covariance), multiple reference spectra, display of ARB_FIXED FEA_SPEC
files, and more!
.ip \ \ \ \(bu
\fI(x)label\fP improvements: arbitrary fonts, "MOVE" label and
"REPLACE" label modes, invocation of external shell commands with
nearest nearest label and time arguments.
.ip \ \ \ \(bu
\fIxwaves\fP+ uses sockets to function as a "display server" 
for local or remote scripts and programs;
.ip \ \ \ \(bu
\fIxwaves\fP+ spectrogram display improvements: complex spectrograms,
horizontal rescaling (in addition to the vertical rescaling that was
already implemented), interpolation disable (data displayed as
rectangles), bracket markers, zooming, display of spectrograms
with unequally spaced frequencies (ARB_FIXED).  
.ip \ \ \ \(bu
X versions of \fImarks\fP and \fIcmap\fP are included;
.ip \ \ \ \(bu
(\fIx\fP)\fIwaves\fP+ is now sensitive to various \fIunix\fP 
environment variables that allow customized paths for menu files,
command files, etc.  
.ip \ \ \ \(bu
Various new demos and examples are available.  Run "eman demos" to 
get more information. 
.ip \ \ \ \(bu
Sunview and XView versions of \fIwaves\fP+ can be called from 
a uniform cover script. 
.ip \ \ \ \(bu
Source code for an example attachment is included.  
.sh 1 "PROGRAMS IN THE RELEASE"
.lp
This Section lists the various programs that are part of the Version
2.1release.  Naturally, the release includes the \fI(x)waves\fP+ program
itself.
.sh 2 "\fIwaves\fP+ Attachments"
.lp
The following \fIwaves\fP+ attachments are included: 

.nf
.ta 1.0i
  \fI(x)spectrum\fP \-	interactive spectrum analysis
  \fI(x)label\fP \-	interactive labeling 
  \fI(x)marks\fP \-	interactive labeling of pre-defined events
.fi
.sh 2 "(\fIx\fP)\fIwaves\fP+ Auxiliary Programs"
.lp
The "auxiliary programs" comprise a subset of ESPS programs that are
used in conjunction with (\fIx\fP)\fIwaves\fP+.  Included are various
programs that provide documentation, file conversion, user-interface
extension, and limited signal processing functions.  For changes to 
the auxiliary programs and more information about the new ones, 
please see the ESPS release notes.  
.lp
In Version 2.1, the following are new auxiliary programs:
.ip \fIerlsupport\fP
A convenience function that automates filling out and e-mailing a
bug report or support request
.ip send_xwaves
This program is used to send \fIxwaves\fP+ commands
(including @<filename> to a running \fIxwaves\fP+ that is 
operating in display server mode.  
.ip \fIcnvlab\fP
This program converts NIST Sphere (e.g., TIMIT) label files into
\fIwaves\fP+ label files. 
.ip \fImat2fea/fea2mat\fP
These convert between MATLAB .mat files and ESPS FEA files. 
.lp
Here's the full list of Auxiliary programs:
.nf

.ta 1.25i
  \fIaddfea\fP \-	adds a new FEA file field based  on ASCII data
  \fIaddfeahd\fP \-	adds an ESPS feature file header to non-ESPS binary data
  \fIaddgen\fP \-	adds a generic header item to an existing  nor new ESPS file header
  \fIbhd\fP \-	behead an ESPS file
  \fIbtosps\fP \-	convert binary sampled data file to an ESPS FEA_SD file
  \fIcmap\fP \-	generate or edit a \fIwaves\fP+ colormap
  \fIcnvlab\fP \-	 convert NIST label file (e.g., TIMIT) to \fIwaves\fP+ label file
  \fIcomment\fP \-	displays or appends to comment field in ESPS file headers
  \fIerlsupport\fP \-	send a bug report or support request to ERL.
  \fIeman\fP \-	displays or prints ESPS manual pages
  \fIeparam\fP \-	run an ESPS program with parameter prompts
  \fIepsps\fP \-	(synonym for psps -- avoids openwin path problems)
  \fIepsps2mu\fP \-	converts ESPS FEA_SD file to headerless mu-encoded data
  \fIespsenv\fP \-	display relevant UNIX environment variables
  \fIeversion\fP \-	displays current version of ESPS and \fIwaves\fP+
  \fIfea2mat\fP \-	converts FEA to MATLAB .mat 
  \fIfea_element\fP \-	prints binary format table for ESPS FEA files
  \fIfeatosd\fP \-	convert ESPS FEA_SD file to old-style SD file
  \fIformant\fP \-	compute formant frequencies,  formant bandwidths, and voicing
  \fIfind_esps_file\fP \- finds full path to an ESPS or waves+ file
  \fIget_esps_base\fP \- returns the name of the esps base directory
  \fIhditem\fP \-	print an item from an ESPS header
  \fIhdshrink\fP \-	remove embedded headers from an ESPS file
  \fIils_esps\fP \-	convert an ILS sampled data file to an ESPS file
  \fIlwb2esps\fP \-	convert a Laboratory Work Bench data file to ESPS FEA_SD
  \fImat2fea\fP \-	converts from MATLAB .mat to FEA
  \fIpplain\fP \-	print values from ESPS file in "plain format"
  \fImu2esps\fP \-	converts mu-encoded data to ESPS FEA_SD file
  \fIpsps\fP \-	print headers and data from ESPS file in "pretty format"
  \fIpspsdiff\fP \-	differential ESPS file comparator
  \fIsdtofea\fP \-	convert old-style ESPS SD file to FEA_SD
  \fIsend_xwaves\fP \-	open connection to \fIxwaves\fP+ server and send commands
  \fIsgram\fP \-	compute FFT-based narrow- or wide-band spectrogram
  \fIsigtosd\fP \-	convert SIGnal sampled data file to ESPS
  \fIsplay\fP \-	play sampled data using SPARCStation codec
  \fItestsd\fP \-	make test signal (sine wave, square wave, noise, pulses, ASCII input, etc.)
  \fItofeasd\fP \-	converts data from arbitrary FEA field to FEA_SD (sampled data) file
  \fItofspec\fP \-	converts FEA data to FEA_SPEC file (for spectrogram-style displays)
  \fIwcheckout\fP \-	checks out a \fIwaves\fP+ license
  \fIwinfo\fP \-	X-based tool for reading waves+ technical and release notes
  \fIwfree\fP \-	frees a \fIwaves\fP+ license
  \fIwsystem\fP \-	detects window system being run by user
  \fIxcmap\fP \-	generate or edit a \fIwaves\fP+ colormap (X Versions)
  \fIxtext\fP \- 	popup X window containing text file or output of any
			text producing command.
.fi
.sh 2 "DSP Board Programs"
.lp
\fIwaves\fP+ can exploit several DSP boards that provide speech I/O
and fast computation of spectrograms.  DSP Support Kits are now 
available for three boards:
.ip \ \ \ \(bu
AT&T DSP32 VME board (Fab 2 Board)
.ip \ \ \ \(bu
AT&T DSP32C VME board ("Surfboard")
.ip \ \ \ \(bu
Ariel S32C (S Bus Board)
.lp
The support kits all include a UNIX driver (with installation
instructions), as well as standalone programs for 
D/A conversion, A/D conversion, and spectrogram computations. 
.sh 1 "SIGNIFICANT CHANGES TO \fI(x)waves\fP+"
.lp
While we will continue maintenance of \fIwaves\fP+ (i.e., the SunView
version) with bug fixes and a few enhancements, major evolution of the
system is now restricted to the X Version (\fIxwaves\fP+).  Thus,
unless we specifically mention that a change applies to \fIwaves\fP+
in these release notes, it applies only to \fIxwaves\fP+.
.sh 2 "Non-ESPS Headers"
.lp
Both \fIwaves\fP+ and \fIxwaves\fP+ now read all 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 \fIproduced\fP by
(x)\fIwaves\fP+ and ESPS continue to be in ESPS format.
.lp
\fIxwaves\fP+ and ESPS also have improved support for dealing with files
that have foreign headers.  For more information, see the ESPS release
notes and the section "LOADING NON-ESPS FILES" in the \fIxwaves\fP+
man page.  
.sh 2 "Window-System Independent Cover Script"
.lp
The programs \fIwaves\fP, \fIwaves\fP+, \fIxwaves\fP, and
\fIxwaves\fP+ are just links to a new cover script waves.\fIcover\fP
(1\-\s-1ESPS\s+1) that checks the current window system and then
invokes the right Sunview or XView version and puts it into the
background.  The actual binaries are \fIsvwaves\fP (for Sunview) and
\fIxvwaves\fP (for X).  If you choose to invoke \fIxvwaves\fP
directly, you should make sure to put it in the background.  
.lp
Those who use \fIwaves\fP+ as a display server in the "old style" 
(reading a pseudo-tty input rather than exploiting the
\fIsend_xwaves\fP facilities) should make sure to invoke the 
\fIwaves\fP+ binaries directly. 
.sh 2 "Implementation of External Calls"
.lp
In the previous version, external calls (non-DSP spectrogram
computations and calls resulting from \fIadd_espsf\fP or
\fIadd_espst\fP) were implemented by executing \fIsystem\fP(3) and
waiting for completion.  In Version 2.1 of \fIxwaves\fP+, a new
mechanism has been implemented \- \fIxwaves\fP+ forks a process to run
the external program and goes on its merry way.  When the forked
process terminates, \fIxwaves\fP+ is signaled in those cases where a
pending display action was waiting (e.g., the display of a spectrogram
file).  The main advantage is that users can continue to interact with
\fIxwaves\fP+ while the external program or programs are running.
.sh 2 "New Default \fIxwaves\fP+ Menu Items"
.ip "\fIwindow ahead\fP"
.ip "\fIwindow back\fP"
These two operations provide for display movement within a signal by
an amount equal to the current window size.  In contrast, the existing
operations "page ahead" and "page back" provide for movement by an
amount specified by a display-independent global \fIref_step\fP.  The
new operations are particularly convenient for informal scrolling
through signals.  The operations are available for both waveform and
spectrogram menus.
.ip "\fIzoom full out\fP"
This operations causes the entire signal to be displayed in 
the current window.  If the buffer size is too small to 
hold the signal, the full buffer is displayed.  (The buffer 
size is determined by the global \fImax_buff_size\fP.)  
.ip "\fIrepeat previous\fP"
This is a selection that is now available as one of the bindings for
the middle-mouse button on both waveform and spectrogram displays;
when enabled, pressing the middle mouse button repeats the operation
that was most-recently selected from the (right mouse) menu.  Once a
menu operation has been selected in a window, it can thus be repeated
rapidly without bringing up a menu each time.  For example, this
feature provides a convenient means to obtain rapid, sequential
zooming or panning.
.sh 2 "New \fIxwaves\fP+ Commands"
.ip \fIadd_espsX\fP
The add_espsf, add_espst, and add_espsn commands can now each be used
to add multiple items to a menu.  Previously there could be at most
one \fIespsf\fP item, one \fIespst\fP item, and one \fIespsn\fP item
at any one time; after being used once, an "add_" command would
replace the menu item it had added before.  The commands now accept a
new keyword "menu" to add an item selectively to the waveform window
menu or the spectrogram window menu.  Items added by add_espsf can now
produce multiple output files.  The names of the added items can now
be arbitrary strings (previously they couldn't contain blanks).
.ip \fIadd_waves\fP
This is used to add new menu items \- both menu items that 
invoke "built-in" commands (the functions on the default menus) and 
menu items that invoke arbitrary \fIwaves\fP+ commands or command
files.
.ip \fIdelete_item\fP
Used to delete specific menu items.
.ip \fIdelete_all_items\fP
Deletes all menu items (the first step in building a completely 
custom menu).  
.ip \fImake_panel\fP
This creates a new window containing screen buttons.  A simple ASCII
file is used to define the button labels and the waves+ command (or
command file) to be executed if the buttons are pressed.  Articulation
is provided for location, geometry, title, and icon title.
.ip \fIclose_panel\fP
Used to iconize a specific button panel.
.ip \fIopen_panel\fP
Used to open a specific button panel that has been iconized. 
.ip \fIkill_panel\fP
Destroys a specific button panel.
.ip \fIzoom_full_out\fP
New operation zooms out to full buffer.