,wrel3.1.me

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

.lo
.he '\fBwaves\fP+ Version 3.1 Release Notes''page %'
.ce 3
.b
\fBwaves\fP+ Version 3.1 Release Notes
.sp
Document Version: %I% %G%
.sh 1 "INTRODUCTION"
.lp
This new release of \fBwaves\fP+, prepared for distribution in January 1993,
provides new features requested by our customers.  It also provides
fixes to many bugs and removal of numerous annoyances.  In addition,
the software and documentation improvements embodied in this release
are part of the groundwork for significant feature enhancements to
come in future releases.

.sh 2 "Version 3.1 Release Highlights"
.ip \ \ \ \(bu
\fIxchart\fP: a new display method for lattices of time-series labels
.ip \ \ \ \(bu
full editing and display support for aperiodically sampled time series
.ip \ \ \ \(bu
streamlined software license facilities
.ip \ \ \ \(bu
improved control of output file destinations
.ip \ \ \ \(bu
enhanced control over "server mode" operation
.ip \ \ \ \(bu
greatly improved D/A and A/D (play and record) programs
.ip \ \ \ \(bu
enhanced scrolling and random access in long data files
.ip \ \ \ \(bu
\fIxspectrum\fP now permits FFT's of unlimited size
.ip \ \ \ \(bu
fine-grained control of harmonic spectrum cursors
.ip \ \ \ \(bu
enhanced \fIxwaves\fP startup environment and control panels
.ip \ \ \ \(bu
updated documentation

.sh 2 "Compatibility with Previous Versions"
.lp 
\fIXwaves\fP is backwards compatible with Version 2.1 with the following
exceptions:
.lp
The program \fIxwaves\fP now has only one official name.  Similarly, the
attachments, \fIxspectrum\fP, \fIxlabel\fP, \fIxchart\fP and
\fIxmarks\fP have only one official name each.  We provide an
installation option to generate symbolic links to the various aliases
(xvwaves, waves+, xwaves+, ...), but we encourage you to join us in
eliminating this confusion once and for all!  The name \fBwaves\fP+ is
now used only to refer to the collection of programs and documentation
comprising the whole product.
.lp
\fIxwaves\fP is only available for use with the \fIX\fP window system.  The
Sunview version is no longer available.
.lp
The display server potential of \fIxwaves\fP has been significantly
increased by allowing \fIsend_xwaves\fP to block (by default) until
the sent command is complete.  Shell scripts that counted on
non-blocking behavior should be changed by inserting the \fB-B\fP
command-line option in the \fIsend_xwaves\fP calls.
.lp
\fIWcheckout\fP has been eliminated.  All auxiliary \fIxwaves\fP programs
now run whether \fIxwaves\fP is running or not.  This should make life more
pleasant, but if you have old UNIX scripts that ran \fIwcheckout\fP,
you should remove these calls.
.lp
Filenames entered into \fIxwaves\fP no longer have "./"
automatically prepended to the internal representation.  This behavior
caused subquent references to files loaded into \fIxwaves\fP to be
incorrect, since the user had no way of knowing that the name (as far
as \fIxwaves\fP was concerned) had a leading "./".  This fixes
apparent bugs in several commands (e.g.  \fIalign\fP) that reference
specific files.  If you worked around this deficiency in your shell
scripts or \fIsend_xwaves\fP calls, you may need to remove the leading
"./" from scripts that reference these files.
.lp
The programs \fIwplay\fP and \fIwrecord\fP have been replaced by
\fIv32play\fP and \fIv32record\fP, respectively.  These provide
dual-channel D/A and A/D with the AT&T/Heurikon SURF VME board, and
provide single-channel play and record for the old AT&T dsp32 "FAB2"
board.  The new programs read/write directly from/to disk and have
several other improvements.
.lp
The scope of the \fIxwaves\fP parameters \fIimage_clip\fP and
\fIimage_range\fP has been broadened to include adjustments for
color/greyscale systems.  Formerly, these only influenced the
intensity mapping for monochrome dithered spectrograms and images.
Since they now provide control of color/greyscale as well, you may
discover that the settings in your personal .wave_pro profile or in
the default profile found in $ESPS_BASE/lib/waves/.wave_pro are not to
your taste.  Increasing \fIimage_clip\fP darkens the image; decreasing
\fIimage_range\fP increases the contrast.
.lp
You may now have to find some other reason to take long coffee
breaks; we've eliminated three.  \fIXwaves\fP and the attachments can
no longer hang up the mouse and monitor.  Previous versions
occasionally did this, requiring you to login remotely or reboot your
system to regain control.  Another impact on coffee breaks comes
from the new program \fIfreewaves\fP.  Previously, if \fIxwaves\fP exited
ungracefully, e.g. by a UNIX \fIkill\fP command, the license was left
occupied for three minutes.  It is now left for only 30 seconds, and
if this is too long, just issue the \fIfreewaves\fP command to free it
immediately.  Finally, the license control daemon \fIelmd\fP now only
requires one minute to initialize, rather than the three minutes
required in Version 2.1.

.sh 1 "NEW FEATURES"
.lp
The primary aim of the Version 3.1 release of \fBwaves+\fP is to fix
problems and ro make the overall operation of the system smoother.
This also lays the groundwork for major enhancements to come later
in the Spring of 1993.  Entropic has, however added the new features
listed below to Version 3.1.

.sh 2 \fIxwaves\fP
.lp
The \fIxwaves\fP \fIspectrogram\fP command now has four additional,
optional arguments.  The keywords \fIheight\fP and \fIwidth\fP
(in pixels) permit specification of the presentation dimensions on the
screen.  If horizontal and vertical rescale are enabled (with
h_spect_rescale and v_spect_rescale), the spectrogram will be scaled
to fit the requested dimensions.  If scaling is disabled, the
spectrogram display will either clip the data image or be limted in
maximum size to the data image.  The new keywords \fIrange\fP and
\fIthreshold\fP provide means for specifying the intensity mapping
parameters when the spectrogram is created.  Previously, this was only
available via the separate \fIcolormap\fP command.
.lp
A new time display mode has been added to \fIxwaves\fP.  When the cursor is
in the scrollbar region near the top of the display, the time readout
is now for the whole file. This allows accurate direct access to any
part of the signal.  Note that the time/frequency cursor is now frozen
when the mouse is in the scrollbar region.  The "Time:" item changes
to "Time(f):" when the mouse is in the scrollbar region.  Thus: if it
is necessary to scroll to a particular time in a long file: move the
mouse pointer into the scrollbar region; move it right or left until
the "Time(f):" display reads approximately the desired time; press the
middle mouse button.  The desired time will then be centered in the
display.
.lp
The startup environment invoked by the .wave_pro entry 
.ce 1
init_file  $ESPS_BASE/lib/waves/commands/xw_init.WC
has been improved.  (This \fIinit_file\fP is what brings up the
"Miscellaneous \fIxwaves\fP Controls" button panel.)  Changes include:
.ip \ \ \ \(bu
spectral averaging can be added to image menus
.ip \ \ \ \(bu
hardcopy ESPS plots can be added to menus
.ip \ \ \ \(bu
some buttons are now menu-buttons to provide shortcuts
.ip \ \ \ \(bu
there's a quick way to turn rescale on and off
.ip \ \ \ \(bu
when plot3d is added, server mode is enabled
.lp
\fIXwaves\fP now reads, displays, edits and writes ESPS tagged FEA
files correctly.  This means \fIxwaves\fP can be used to manipulate
any aperiodically-sampled time series.  It also aligns these correctly
with other data types.  Thus, all ESPS signal files, including
those produced by programs like \fIlpcana\fP, may now be displayed correctly
using \fIxwaves\fP.  The ESPS manual describes how to write ESPS
tagged files from C programs.  If you have aperiodic data in ASCII
form generated by some non-ESPS process, you can build a tagged ESPS
file acceptable to \fIxwaves\fP and ESPS programs with a UNIX script
like the following:
.sp
.nf
-------------------------------------------------------------------------
#!/bin/sh
#
# $1	data type: DOUBLE, FLOAT, LONG, or SHORT
# $2	size: number of elements per record (columns), not counting tag
# $3	src_sf: sampling frequency of the data to which the tags refer
# $4	input: name of ASCII input file
# $5	output: name of output tagged FEA file

# The first column in the input file contains the "tags".  These are
# sample (record) indices into the file from which the remaining columns
# were derived.  This "source" file was sampled at "src_sf" samples per
# second.  This script assumes the remaining columns are all of the data
# type specified by $1.

USE_ESPS_COMMON=off; export USE_ESPS_COMMON

prog=$0

case $# in
5)
    type=$1
    size=$2
    freq=$3
    input=$4
    output=$5
    ;;
*)
    echo "Usage: $prog type size src_sf input_file output_file"
    exit 1
    ;;
esac

# Pick a format string for reading data of the specified type with scanf.

case $type in
DOUBLE)
    fmt="%lf"
    ;;
FLOAT)
    fmt="%f"
    ;;
LONG)
    fmt="%ld"
    ;;
SHORT)
    fmt="%hd"
    ;;
*)
    echo "$prog: can't handle type $type"
    exit 1
    ;;
esac

# Create a format file for use with addfeahd.

fmtfile=/tmp/fmt$$
cat >$fmtfile <<EOF
Tag	 LONG	1	%ld
data	 $type	$size	$fmt
EOF

# Create output file (untagged).
# Tag data go into an ordinary field named "Tag".

addfeahd -c "$0 $*" -a $fmtfile $input $output 2>/dev/null

# Now make a couple of changes with fea_edit to turn the output file
# into a tagged file:
# 1) Change the "common.tag" flag to indicate a tagged file by changing
#    the first 0 to 1 in the first line ("0 0 0 << do not edit >>") of the
#    fea_edit display.
# 2) Remove the field definition for "Tag".
# (This oblique technique for generating tagged files from ESPS-external
# data will not be necessary in future Entropic software releases.)

EDITOR=ed; export EDITOR