spspaper.vme

speech signal process tools

    /*string array of filter_type values*/
    char * f_types[] = {"MISC", "LOW_PASS", "HIGH_PASS", "BAND_PASS", NULL};

    /*create generic header item and fill it*/
    *add_genhd_e("filt_type", NULL, 1L, f_types, hd) = MISC;
    . . .
    /*change filt_type item in header*/
    *(short *) get_genhd("filt_type", hd) = BAND_PASS;

.fi
.vE
.lp
The \fIpsps\fP (1\-\s-1ESPS\s+1) listing for a file processed as above
will show the item symbolically, i.e.:
.nf

    . . .
    filt_type: BAND_PASS
    . . .

.fi
.lp
Also, programs that read a file with such a generic item defined in
the header can refer to the contents symbolically, as in the
following:
.vS
.nf

    struct header *hd;
    short filter_class;
    . . .
    filter_class = *(short *) get_genhd("filt_type", hd);
    . . .
    switch (fitler_class) {	
	case LOW_PASS:
	    . . .
	    break;
	case HIGH_PASS:
	    . . .
	    break;
	case BAND_PASS:
	    . . .
	    break;
	case MISC:
	    . . .
	    break;
	default:
	    ERROR_EXIT("invalid filter type encountered");
    }

.fi
.vE
.sh 2 "ESPS Record Structures"
.lp
The ESPS header is followed by a set of fixed-length data records.
When any record is read into memory (through use of an ESPS library
routine), it is stored as a C structure that is documented in the
relevant Section 5 manual page of the ESPS Manual.  As is the case for
file headers, programmers need not be concerned with the actual
format of ESPS data records.  For example, suppose that the variable
scbkrec is pointer to a SCBK file record (each record contains a
scalar quantization codebook plus related design information).  Then
the final distortion value for that codebook and the population of
the \fIi\fPth codeword are referred to as
.vS
.nf

    scbkrec->final_dist

and

    scbkrec->final_pop[i]

.fi
.vE
respectively (see SCBK (5\-\s-1ESPS\s+1)).  
.lp
This symbolic form of
reference for ESPS data records also applies to FEA files.  
For example, if anarec is a pointer to a FEA_ANA file record, the 
\fIi\fPth filter pole in that record is referred to as 
.vS
.nf

    anarec->filt_poles[i]

.fi
.vE
(see FEA_ANA (5\-\s-1ESPS\s+1). As mentioned earlier, users can 
define their own FEA file sub-types and extend existing subtypes.  
New fields in FEA file records are defined through use 
of \fIadd_fea_fld\fP (3\-\s-1ESPS\s+1), which creates a new field 
with a given name size, numerical type, etc.  The new fields are 
accessed by means of of \fIget_fea_ptr\fP (3\-\s-1ESPS\s+1), which 
returns a pointer to a field with a given name from a given record.  
.sh 2 "The ESPS Library"
.lp
To support the writing of new user-level ESPS programs, the ESPS
library contains various routines for processing ESPS headers, for
processing ESPS data records, and for performing various signal
processing functions.  At present, there are over 110 routines in the
library.  
.lp
A full ESPS lint library is included so that ESPS programs can be
fully checked with the standard \s-1UNIX\s+1 \fIlint\fP(1)
utility for C program checking.  As a further aid to programmers,
\fIscheck\fP (3\-\s-1ESPS\s+1) looks up entries in the ESPS lint
library and prints the proper calling sequence.  For emacs users, a
mock-lisp file provides for \fIscheck\fP use from within emacs.
.lp
Here are a few examples of functions in the ESPS library:
.sh 3 "Signal Processing Support Library Functions"
.ta .1i 1i 
.nf

	\fIanalyze\fP	compute prediction error filter and reflection coefficients
	\fIblock-filter\fP	filter a data array
	\fIconvolv\fP	convolution of polynomials or auto-correlations
	\fIcovar\fP	compute reflection coefficients with covariance method 
	\fIfdbk_latic\fP	feedback filtering with lattice form
	\fIfeedbk_fil\fP	feedback filtering with transversal form
	\fIgauss\fP	compute Gaussian random numbers
	\fIget_auto\fP	compute auto-correlation coefficients
	\fIget_burg\fP	compute reflection coefficients with Burg or modified
		Burg method
	\fIget_fft\fP	compute fast Fourier transform
	\fIhamm_dec\fP	decode (8,4) Hamming code
	\fIhamm_enc\fP	encode with (8,4) Hamming code
	\fIinterp_filt\fP	perform interpolation filtering
	\fIis_dist_td\fP	compute Itakura-Saito distortion
	\fIpc_to_lsf\fP	convert prediction coefficients to line spectrum frequencies
	\fIrand_intnr\fP	sample without replacement from uniformly
		distributed integers
	\fIrefl_to_filt\fP	convert reflection coefficients to filter coefficients
	\fIremove_dc\fP	remove DC, using exponential weighting
	\fIvqdesign\fP	design a full-search vector quantization codebook

.fi
.sh 3 "File Support Library Functions"
.ta
.nf
.ta .1i 1.4i

	\fIadd_comment\fP	adds a string to the comment field of an ESPS header
	\fIadd_fea_fld\fP	add a new field to data record in a FEA file
	\fIadd_genhd\fP	adds a generic header item to a ESPS header
	\fIadd_source_file\fP	add the header of a source file to an ESPS header
	\fIcopy_header\fP	copies an ESPS header to a new header
	\fIgenhd_list\fP	returns a list of defined generic header items
	\fIget_cmd_line\fP	returns pointer to string containing program's command line
	\fIget_fea_fld\fP	returns pointer to named field in a FEA record
	\fIget_genhd\fP	returns pointer to named generic header item
	\fIget_spec_rec\fP	get next spectral record from ESPS SPEC file
	\fIget_sym\fP	get a parameter value after read_params called
	\fInew_header\fP	create new ESPS file header
	\fIprint_spec_rec\fP	prints a SPEC file record
	\fIput_spec_rec\fP	writes a SPEC file record
	\fIput_sym\fP	put value in ESPS common file
	\fIrange_switch\fP	parse the argument to a command-line range switch
	\fIread_header\fP	read an ESPS file header
	\fIread_params\fP	read the parameters in ESPS parameter or common file
	\fIskiprec\fP	skip records in ESPS file
	\fIwrite_header\fP	write an ESPS file header

.fi
.sh 1 "EXAMPLE USER-LEVEL ESPS PROGRAMS"
.lp
This section lists some user-level ESPS programs of general interest.
Note that the entire ESPS Manual is stored on-line.  The manual pages
can be viewed with the 
.i eman
(1\-\s-1ESPS\s+1) command, which is an ESPS version of the \s-1UNIX\s+1 
.i man 
command.  
.i Eman
includes the \fB\-k\fP option to search the manual for programs
whose one-line descriptions include a given keyword. 
.sh 2 "Signal I/O and Processing"
.ta .1i 1i 
.nf

	\fIaddsd\fP	adds SD files with scaling
	\fIana\fP	perform speech analysis from SD file
	\fIanaspec\fP	compute spectra (SPEC file) from FEA_ANA file
	\fIdistort\fP	compute distortion measures between ESPS files
	\fIclassify\fP	classify records in FEA files
	\fIfea_stats\fP	compute statistics from FEA files
	\fIfft\fP	produces SPEC file by doing fft on SD file
	\fIfilter\fP	performs digital filtering on SD file
	\fIlloydcbk\fP	design a scalar quantizer using Lloyd's algorithm
	\fInotch_filt\fP	design a notch filter
	\fIplay\fP	play portions of SD files
	\fIplaytest\fP	step through an "A-B" listening test with control options
	\fIrandplay\fP	create play scripts for randomized "A-B" listening comparisons
	\fIrecord\fP	digitize data using Masscomp EF-12M
	\fIrefco\fP	compute reflection coefficients from sampled data (FEA_ANA output)
	\fIrem_dc\fP	remove DC component from SD file
	\fIsdcomp\fP	listening program for detailed comparison of two sampled data files
	\fIspectrans\fP	transform FEA_ANA from one spectral representation to another
	\fIstats\fP	computes statistics from ESPS files
	\fIsynt\fP	synthesize speech from ANA file
	\fItestsd\fP	make SD file with sine wave, pulses, Gaussian noise, or from ASCII data
	\fIvqdes\fP		design a vector quantization codebook from a FEA file
	\fIvq\fP		encode FEA file with a vector quantization codebook
	\fIwmse_filt\fP	design FIR filter using weighted mean square error criterion

.fi
.sh 2 "File Manipulation and Plotting"
.nf

	\fIatofilt\fP	convert ASCII file to FILT file
	\fIatosps\fP	converts ASCII output to ESPS file (see spstoa)
	\fIbhd\fP	behead an ESPS file
	\fIcomment\fP	displays or adds comments in the header of an ESPS file
	\fIcopysd\fP	copy selected portions of SD files to a new file
	\fIfea_edit\fP	edit a FEA file in ASCII form
	\fIgenplot\fP	plot elements from any ESPS file in precise, multiline format 
	\fIhistogram\fP	sort data into bins for plotting histograms
			(screen, Imagen, or Tektronix) 
	\fIils_sps\fP	converts ILS sampled data file to ESPS SD file
	\fImlplot\fP	plot SD file in precise, multiline format 
			(screen, Imagen, or Tektronix) 
	\fIplotsd\fP	plot sampled data (screen, Imagen, or Tektronix) 
	\fIplotspec\fP	plot spectra from SPEC file (screen, Imagen, or Tektronix) 
	\fIpplain\fP	print values from ESPS file in "plain format"
	\fIpsps\fP	print ESPS file headers and records
	\fIrange\fP	select a range from a graphics plot
	\fIselect\fP	select FEA records that satisfy queries
	\fIscatplot\fP	make a scatter plot
	\fIspstoa\fP	convert ESPS file to machine-independent ASCII format

.fi
.sh 1 "FUTURE CHANGES"
.lp
Everything discussed in the foregoing is available in ESPS Version
3.0.  In this section, we mention some of the things that will added
in later versions.  
.lp
Although users can implement their own FEA file subtypes with ESPS
Version 3.0, later versions will include implementations for a
variety of subtypes beyond the ones now provided (see Section 3.2).  
Also, additional support will be provided for segment-labelled feature
files.  For example, there will be a program that allows the user to
mark a segment and then (optionally) enter segment-associated
information.  There will also be a program to augment sampled-data
plots with segment marks and numerical or character information from
the segment-labelled records.
.lp
We will provide some additional facilities to support ESPS
programming.  For example, there will be a program for the
semi-automatic generation of new FEA file sub-types, and there will
be a program for the automatic generation of C skeletons for
user-level programs.
.lp
.lp
The ESPS parameter file format might be simplified, so that users
didn't have to specify types (they don't on command lines, for
example).   It would also be desirable to have reasonable default
values for missing parameters.   Programs shouldn't fail to run
because parameters are given, unless there is no reasonable default
value.   In most cases the program should print a warning to the user
that a parameter value is missing from the parameter file, use a
default value, and inform the user of the default.  
.lp
Future versions will feature improved plotting programs and a
much-improved user-interface.  The standard \s-1UNIX\s+1 command-line
interface will be augmented with a screen- and mouse-oriented
interface based on X Windows.  Although such an interface could be
implemented with vendor-dependent proprietary window systems, the use
of X will facilitate ESPS applications in network environments
containing \s-1UNIX\s+1 machines from different vendors.  The new
user-interface will include a help system that goes beyond the
capabilities of \fIeman \fB\-k\fR.
.lp
Another significant enhancement will be provided by an interface
between ESPS and a \s-1UNIX\s+1 relational data base system.  This
interface will create data base records from ESPS file headers so
that the data base system can be used to manage sets of ESPS files.