rel4.1.me

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

\fIbhd\fP \- added \fB-F\fP to support foreign headers If \fB-F\fP is
used without the \fB-h\fP, then the foreign header is retained and
written to the output file before the data.  If \fB-F\fP is used with
\fB-h\fP, then the foreign header is written out after the ESPS
header.
.np
\fIfea_edit/spstoa/atosps\fP, \- revised so that blanks now remain in
strings.
.np
\fIpplain\fP \- has a new \fB-n\fP which facilitates output 
of character fields as strings; the \fB-i\fP option now works
correctly.  
.np
\fIecheckout\fP \- no longer gets a license if one is already 
checked out.
.sh 1 "ESPS LIBRARY CHANGES"
.sh 2 "Signal Processing Library"
.sh 3 "New Signal Processing Functions"
.np
\fIdtw_l2\fP \- new function; dynamic time warping based on euclidean
distance
.np
\fIdtw_tl\fP \- new function; dynamic time warping based on table lookup
.np
\fIblt\fP \- new function for bilinear transform
.np
\fIfft_cepstrum\fP \- new function; computes the cepstrum of a data sequence.
.np
\fIfft_cepstrum_r\fP \- new function; computes the cepstrum of real data sequence.
.np
\fIfft_ccepstrum\fP \- new function; computes the complex cepstrum of a data sequence.
.np
\fIfft_ccepstrum_r\fP \- new function; computes complex cepstrum of a real data sequence
.np
\fIget_fburg\fP \- new function; computes reflection coefficients
using a fast modified Burg method. 
.np
\fIstruct_cov\fP \- new functions; computes a structured covariance
estimate of a Toeplitz autocorrelation matrix (STRCOV)
.np
\fIgenburg\fP \- new function; generalized Burg (structured
covariance) estimation of covariance matrix (STRCOV1)
.np
\fIstrcov_auto\fP \- new function; estimates auto-correlation
coefficients using structured covariance
.np
\fIget_vburg\fP \- new function; computes reflection coefficients
using a vector Burg method (this is a fast approximation to a 
structured covariance method).
.np
\fIcompute_rc\fP \- new function; this is a cover function for the
various ESPS library functions that compute reflection coefficients.
It provides a common calling interface for all eight methods:
autocorrelation, covariance, Burg, modified Burg, fast modified Burg,
two structured covariance methods, and vector Burg (fast approximation
to structured covariance). 
.np
\fIwindowcf, windowcfd\fP \- new functions for windowing complex data
.np
\fIconvertlab\fP \- new function for converting NIST/Sphere (e.g.,
TIMIT) label files to \fI(x)waves\fP+ format.
.np
\fIa_to_linear_2\fP/\fIlinear_to_a_2\fP \- new N-law conversion
functions.  These differ from the existing functions \fIa_to_linear\fP
and \fIlinear_to_a\fP in the code byte inverted in accordance with a
CCITT recommendation.  TIMIT) label files to \fI(x)waves\fP+ format.
.np
\fIarr_func\fP \- new function for computing various standard functions such
as cosine, square root, logarithm, and absolute value for real and
complex arguments (any of the ESPS numeric data types).  It will take
an array input and apply the function to all elements of the array.
The function is used in the new version of the user-level program
\fIfeafunc\fP.  
.sh 2 "Utility Library"
.sh 3 "New Utility Functions"
.np
\fIskip_header\fP \- new function; skips an ESPS header (without
the overhead of the recursive header read); 
.np
\fIfree_header\fP \- new function; frees the storage associated with
an ESPS header. 
.np
\fIexec_command\fP \- new function; forks a shell to run a unix
command
.np
\fIe_temp_name, e_temp_file\fP \- new functions to support creating 
and opening temporary ESPS files.  These make use of the \fIunix\fP
environment variable ESPS_TEMP_PATH.  
.np
\fIget_esps_base\fP \- new function or ESPS position-independence; 
returns the base directory of ESPS  (ESPS_BASE or /usr/esps).  
.np
\fIfind_esps_file\fP \- new function for ESPS position-independence; 
searches for a file along a path that is specified through a default
path which can be overridden by an environment variable.  Various
cover macros are also defined (in $ESPS_BASE/include/esps/epaths.h) 
for various important categories of ESPS and \fI(x)waves\fP+ files.  
.np
\fIbuild_esps_path\fP \- new function for ESPS postition-independence; 
appends an arbitrary extension to a valid path in the ESPS hierarchy.  
.np
\fIbuild_file_name\fP \- new function; expands environment variables
in a path name
.np
\fIopen_xwaves\fP \- new function; opens a socket connection to an
\fIxwaves+\fP server
.np
\fIsend_xwaves\fP \- new function sends a command to an \fIxwaves+\fP
server
.np
\fIclose_xwaves\fP \- new function; closes a socket connection to an
\fIxwaves+\fP server
.np
\fIsend_xwaves2\fP \- new function; sends a single command to an
\fIxwaves+\fP server without a separate open and close
.np
\fIatoarrays\fP \- new function; converts ASCII file to a data 
array of strings (similar to \fIatoarrayf\fP and \fIatoarray\fP).
.np
\fIstrlistlen\fP \- new function; returns the current number of 
strings in a string array.  
.np
\fItrange_switch\fP \- new function to assist in parsing command-line
arguments expressed in seconds (parses -s<a>:<b> and returns 
start and end records).  
.sh 3 "Revised Utility Functions"
.np
\fIread_header\fP \- modified to read NIST (Sphere) sampled data 
headers and return an equivalent ESPS FEA_SD header.  From the 
viewpoint of programs that call \fIread_header\fP, NIST files are
FEA_SD files.  
.np
read_header \- modified to assume that a default header properly 
describes any header-less file.  If the environment variable
DEF_HEADER exists, and if the input file is a headerless (i.e.,
non-ESPS and non-SIGnal), then \fIread_header\fP uses the 
file pointed to by DEF_HEADER as a "virtual header". 
.np
read_header \- modified to look for generic header item
"foreign_header".  If it is defined and non-zero, then it is taken as
a number of bytes of a foreign header in the file after our header.
The foreign header is skipped over, so that the next read after
read_header will get the data. 
.np
\fIread_params\fP \- The assumption of "params" as the default ESPS
parameter file has been moved into \fIread_params\fP().  In
particular, if the parameter \fIparam_file\fP is NULL, then
read_params uses the ESPS default parameter file name "params".  If
\fIparam_file\fP is non-NULL, and if \fIread_params\fP is unable to
find a corresponding, readable parameter file, a warning is printed.
By default, \fIread_params\fP uses \fIfind_esps_file\fP() to search
along the path
.nf

     ".:$ESPS_BASE/lib/params".

.fi
This default search path can be overridden by setting the unix
environment variable ESPS_PARAMS_PATH.  The unix environment variable
ESPS_VERBOSE is used (as before) to control the extent of parameter
processing feedback messages issued by read_params. There are now
three significant settings: 0, 1, and 2.  If it is equal to 0, no
feedback is provided.  If ESPS_VERBOSE is 1, programs report the value
of any parameters taken from ESPS common.  If it is 2 or greater,
programs report the values of parameters taken from ESPS common, the
name of the actual parameter file used (if any), and the values of
parameters taken from the parameter file.  If ESPS_VERBOSE is not set,
a value of 2 is assumed.  Note that parameter file selection is
affected by ESPS_PARAMS_PATH (as described above). Regardless of
ESPS_VERBOSE, if debug_level is non-zero, read_params will warn if a
parameter file cannot be found (including the default "params"), will
report the name of any parameter file found, and will report if ESPS
Common is processed.  This new behavior is documented in the
\fIread_params\fP and \fIespsenv\fP man pages.
.np
\fIaddstr\fP \- modified so that it is now legal to call it with a 
NULL for the string array, in which case initial allocation results.  
.sh 2 "New XView Utility Library"
.lp
This release includes the first version of \fIlibxv\fP, an extension
of the utility library that supports XView applications.  The 
following functions are included: 
.np
\fIexv_helpfile\fP \- return file name containing cleaned man page or
plain text
.np
\fIexv_get_help\fP \- creates XView frame containing text of man page
or help file
.np
\fIexv_make_text_window\fP \- create XView frame containing text of ASCII
file  (complete with quit, search-forward, and search-backward
buttons). 
.np
\fIexv_attach_icon\fP \- attachs one of a selection of standard ESPS
icons to a frame.  
.np
\fIexv_prompt_params\fP \- fills in an ESPS parameter file by means of
an interactive X-Windows prompt panel
.np
\fIexv_bbox\fP \- create panel with arbitrary screen buttons
.np
\fIread_olwm_menu\fP \- reads a menu in Open Look Window Manager
format; this is a support function for \fIexv_bbox\fP()
.np
\fIprint_olwm_menu\fP \- prints an \fIolwm\fP-format menu; support
function for \fIexv_bbox\fP(). 
.sh 1 "ADDITIONS TO THE PUB DIRECTORY" 
.lp
The directory $ESPS_BASE/pub contains full-source copies of 
certain relevant and useful public domain programs. You are 
free to use them and pass them on in any manner consistent with 
restrictions stated by their authors.  This release 
contains these new additions:
.ip \fItpipe\fP
This is a utility that splits a \fIunix\fP pipeline into two
pipelines.  Stated differently, the output of one pipe can provide the
intput to two others.  \fItpipe\fP was written by David B. Rosen of
Boston University.
.ip \fIxloadimage\fP
Rod Johnson at ERL enchanced Jim Frost's \fIxloadimage\fP so that a
"slideshow" can run under the control of an external program,
\fInext_slide\fP (also included).  
.ip \fIshellforms\fP
This is a utility to build and edit forms.  It was written by 
Paul Lew.  
.ip \fIxgrabsc\fP
A utility that allows you to grab arbitrary portions of the 
screen and output them in Postscript or many other formats.
\fIxgrabsc\fP was written by Bruce Schuchardt.  
.ip \fIGNUtar\fP
We use \fIGNUtar\fP to make and read tapes, so we distribute 
in in the GNU spirit.  
.sh 1 "WHAT MIGHT BREAK"
.lp
\fIfeafunc\fP has changed in some ways that may break existing
scripts.  In particular, the notation for the natural and common
logarithms has been changed from "ln" and "log" to "log" and "log10"
for consistency with \fIselect\fP and with C; The parameters
"gain_factor" and "add_constant" have been replaced with "gain_real"
and "add_real", and "gain_imag" and "add_imag" are allowed in case
complex coefficients are needed.
.lp
If filter (FILT) files from the old release are used as intput for 
the filter programs in Version 4.1, they won't work.  The most likely
symptom is an exit from a FEA_FILT support routine with an assertion
error stating that a non FEA_FILT file was detected.  Just convert 
the file with \fIfilt2fea\fP (1\-\s-1ESPS\s+1).  
.lp
FEA_FILT files generated with the beta release of Version 4.1 also
will not work with this final release (sorry!).  Unfortunately the
most likely symptom is that ever-informative "segmentation fault, core
dump."  An assertion error is also possible.  If it is difficult to
re-create such a filter, many of them can be fixed by running
\fIfea_edit\fP on the file and changing all instances of the string
"degree" to "size".  This is not possible if the FEA_FILT contains the
fields "poles" and "zeros" (e.g., if generated from \fIxpz\fP).  In
this case, the ugly but workable solution is to use \fIxpz\fP to
create a FEA_FILT file with the right number of poles and zeros, use
\fIbhd\fP to obtain the header, use \fIbhd\fP to get rid of the header
in the beta file, and then glue the new header on with \fIcat\fP.
.ex
.lp
.sh 1 "KNOWN PROBLEMS"