history.prme

speech signal process tools

    src_sf:  8000 
    start:  1 
    step:  80 
    window_type:  WT_HAMMING 

.ft LR
.lp
If a program needs access to the data in an external header, it is 
a simple matter to open that file, read in the header, and use the 
ESPS library routines to access the generics.  
.lp
For cases where it makes more sense to store external information as 
a pure ASCII file, ESPS provides another generic header type, AFILE, 
which works exactly as described above for EFILEs. 
.sh 1 "FEA File Field Definitions"
.pp
FEA files provide user-defined file types and therefore 
contain relatively few built-in fields in the type-specific header.  
In particular, the type-specific header contains just the number
of fields in each record, a flag signifying whether or not the 
records are segment labelled, and the identity of the FEA file 
sub-type.  For FEA files, most header information is contained 
in generics that are defined depending on the FEA file sub-type.  
Here, for example, is the \fIpsps\fP \fB\-l\fP output for 
the FEA file signal.rc. 
.nf
.ft CW

    %psps -Dl signal.rc
    File: signal.rc

    ---Universal Part of Header---
    File type: FEA (Feature File)
    File header date: Wed Aug 10 15:11:32 1988 , header version: 1.61
    Produced by: refcof, version: 3.6, of: 5/24/88, user: shore
    Hostname:path: epiwrl:/usr/edemos/demo
    Number of data records: 1
    Data is  tagged.
    refer file: signal.sd
    comment text:
     refcof -o100 -p1:2500 -l0 signal.sd signal.rc 
    Source files: signal.sd
    There is no reference header.

    ---Type Specific Part of Header (FEA)---
    fea_type: FEA_ANA, segment_labeled: NO, field_count: 8

    ---Generic Part of Header---
    DC_removed: NO 
    filters: NO 
    frmlen: 2500 
    maxlpc: 1 
    maxpulses: 1 
    maxraw: 1 
    method: AUTOC 
    nan: 2500 
    order: 100 
    order_unvcd: 100 
    order_vcd: 0 
    spec_rep: RC 
    src_sf: 20000 
    start: 1 

.ft LR
.fi
.lp
Since FEA file headers also contain the definitions of record fields, a
special option (\fB\-v\fP) is provided to output them as part of the
type-specific header.  Thus, here is the full header for signal.rc:
.nf
.ft CW

    %psps -Dv signal.rc
    File: signal.rc

    ---Universal Part of Header---
    File type: FEA (Feature File)
    File header date: Wed Aug 10 15:11:32 1988 , header version: 1.61
    Produced by: refcof, version: 3.6, of: 5/24/88, user: shore
    Hostname:path: epiwrl:/usr/edemos/demo
    Number of data records: 1
    Data is  tagged.
    Data format is 0 doubles, 104 floats, 2 longs,
    1 shorts, and 0 chars (bytes).
    refer file: signal.sd
    comment text:
     refcof -o100 -p1:2500 -l0 signal.sd signal.rc 
    Source files: signal.sd
    There is no reference header.

    ---Type Specific Part of Header (FEA)---
    fea_type: FEA_ANA, segment_labeled: NO, field_count: 8
    Item name: frame_len, type: LONG, size: 1
    Item name: num_pulses, type: LONG, size: 1
    Item name: frame_type, type: CODED, size: 1
     Possible coded values:
     NONE
     UNKNOWN
     VOICED
     UNVOICED
     SILENCE
     TRANSITION
    Item name: voiced_fraction, type: FLOAT, size: 1
    Item name: raw_power, type: FLOAT, size: 1
    Item name: lpc_power, type: FLOAT, size: 1
    Item name: p_pulse_len, type: FLOAT, size: 1
    Item name: spec_param, type: FLOAT, size: 100, rank: 1

    ---Generic Part of Header---
    DC_removed: NO 
    filters: NO 
    frmlen: 2500 
    maxlpc: 1 
    maxpulses: 1 
    maxraw: 1 
    method: AUTOC 
    nan: 2500 
    order: 100 
    order_unvcd: 100 
    order_vcd: 0 
    spec_rep: RC 
    src_sf: 20000 
    start: 1 

.ft LR
.fi
.sh 1 "SOURCE FILE HEADERS \- COMPLETE PROCESSING HISTORIES"
.pp
As I mentioned earlier, an ESPS program output file header includes
the names of any source files as well the headers of these source
files.  Since ESPS headers are recursive structures, these source file
headers themselves contain the names and headers of files that were
their sources.  Thus, ESPS file headers contain the headers of all
source files in the processing chain.  This chain of headers can be
viewed using various \fIpsps\fP options.  If you want to see only the
universal sections of all the embedded headers, use the \fB\-f\fP
option.  If you want to see all of the type-specific and generic
portions, use \fB\-a\fP.  If you want to expand any EFILE or AFILE
generics, use \fB-ae\fP.  If FEA files are involved and you want to
see the field definitions, then use \fB\-av\fP (or \fB-ave\fP, to get
the EFILE/AFILE expansion).  The resulting output can be quite long
(see the Appendix for an example of \fIpsps\fP \fB-a\fP output).  
.pp
ESPS headers can get quite large if long processing chains are used.  If
file space is short or the history is uninteresting, you can use
\fIhd_shrink\fP (1\-\s-1ESPS\s+1) to remove all of the embedded headers.  
.sh 1 "Other \fIpsps\fP Options"
.pp
\fIPsps\fP has some other useful options besides the ones discussed
above.  For completeness, we summarize the \fIpsps\fP options here:
.ip \ \ \ \ \ \fB\-a\fP
Print headers recursively for all source files.  Headers 
are printed in long format with both common and type 
specific portions of each header. (i.e., as for \fB\-l\fP option).  
FEA file field definitions will be printed if \fB\-v\fP option is 
also used.
.ip \ \ \ \ \ \fB\-D\fP
Suppress printing of data records.
.ip \ \ \ \ \ \fB\-g\fP
Print data records in a generic format, independent of 
file type.
.ip \ \ \ \ \ \fB\-h\fP
Recursively prints the common part of all source file headers.  If
the full headers are wanted, use the \fB\-a\fP option.  
.ip \ \ \ \ \ \fB\-H\fP
Suppress printing of headers.  
.ip \ \ \ \ \ \fB\-l\fP
Print the type-specific portion of the header and also generic header
items.  This does not apply to embedded headers.  If similar behavior
is wanted for embedded headers, use \fB\-a\fP.  For EFILE (external
ESPS file) and AFILE (external ASCII file) generic header items, just
the filename is printed (full path with possible leading hostname).
If you want to follow the pointer, use \fB-e\fP.
.ip \ \ \ \ \ \fB\-e\fP
Follow references to external files.  If any generic header items are
of type EFILE (external ESPS file), the header of that file is
printed.  If any of the generic header items are of type AFILE
(external ASCII file), the contents of that file are printed.  This
option implies \fB-l\fP (i.e., if you give \fB-e\fP, you don't need to
give \fB-l\fP).  This option does not apply to embedded source file
headers.  If similar behavior is wanted for embedded headers, use
\fB\-a\fP.
.IP
For EFILE and AFILE items that refer to a file on a different host 
(the hostname followed by a colon precedes the full path of the 
file), \fIpsps\fP will copy the file header from the remote host
and print it.  Depending on network configuration, this can cause 
\fIpsps\fP to run slowly.  
.ip \ \ \ \ \ \fB\-v\fP
Verbose printing of FEA headers and generic header items.  This option
causes printing of all \fB-l\fP information, plus the following:
Generic header types (along with their values), FEA field definitions,
field derivations (if relevant \- see \fIfea_deriv\fP
(1\-\s-1ESPS\s+1)), and the reference header (if present \- see, for
example, the discussion of variable.refhd in \fIfea_stats\fP
(1\-\s-1ESPS\s+1).  If \fB-e\fP is specified together with \fB-v\fP, 
verbose printing also applies to external EFILE headers.  
.ip \ \ \ \ \ \fB\-x\fP
Enable debug output.  
.BI \-r " start:end"
.ip \ \ \ \ \ \fB\-r\fI\ start:end\fR
.ip \ \ \ \ \ \fB\-r\fI\ start:+incr\fR
Determines the range of data records to print.  In the first form, a
pair of unsigned integers gives the first and last points of the range.  
If 
.i start
is omitted, 1 is used.  If 
.i end
is omitted, the last point in the file is used.  The second form is
equivalent to the first with 
.i "end = start + incr".
.ip \ \ \ \ \ \fB\-t\fI\ tag\fR
Only print the data record with the corresponding tag.
A warning message is printed if this option is specified and the data
is not tagged.  
.ip \ \ \ \ \ \fB\-f\fI\ field_name\fR
Print only the feature file field that matches the given field name.
A warning is printed on stderr if the requested field name does not
exist.  This option may be specified as often as desired.
.sp 1
.sh 1 "REFERENCES"
.[
$LIST$
.]
.bp
.sp 2
.ce
\fB APPENDIX \fI
.sp 2
.pp
The complete history of a file can be viewed using the \fB\-a\fP
option on \fIpsps\fP, which prints the full headers of all 
source files.  Here, for example, is the result for the output 
of the \fIpipedemo\fP script:

.nf
.ft CW
File: psignal.spec

---Universal Part of Header---
File type: FEA (Feature File)
File header date: Tue Mar 20 15:45:56 1990 , header version: 1.73
Produced by: me_spec, version: 1.4, of: 12/13/88, user: burton
Hostname:path: sun4:/mc_u2/burton/esps/refcof
Machine type: Sun4; file is in NATIVE format.
Number of data records: 1
Data is  tagged.
refer file: <stdin>
comment text:
 me_spec - psignal.spec 
Source files: <stdin>
There is no reference header.

---Type Specific Part of Header (FEA)---
fea_type: FEA_SPEC, segment_labeled: NO, field_count: 3

---Generic Part of Header---
contin:  YES 
frame_meth:  FIXED 
freq_format:  SYM_EDGE 
frmlen:  2500 
num_freqs:  513 
order_unvcd:  100 
order_vcd:  0 
record_freq:  8 
sf:  20000 
spec_type:  DB 
src_sf:  20000 
start:  1 
start_time:  0.0625 

 ----------------
 File: <stdin>

 ---Universal Part of Header---
 File type: FEA (Feature File)
 File header date: Tue Mar 20 15:45:55 1990 , header version: 1.73
 Produced by: refcof, version: 3.9, of: 1/22/93, user: burton
 Hostname:path: sun4:/mc_u2/burton/esps/refcof
 Machine type: Sun4; file is in NATIVE format.
 Number of data records: unknown (input is pipe)
 Data is  tagged.
 refer file: <stdin>
 comment text:
  refcof -o100 -p1:2500 -l0 - - 
 Source files: <stdin>
 There is no reference header.

 ---Type Specific Part of Header (FEA)---
 fea_type: FEA_ANA, segment_labeled: NO, field_count: 8

 ---Generic Part of Header---
 DC_removed:  NO 
 filters:  NO 
 frmlen:  2500 
 maxlpc:  1 
 maxpulses:  1 
 maxraw:  1 
 method:  AUTOC 
 nan:  2500 
 order:  100 
 order_unvcd:  100 
 order_vcd:  0 
 record_freq:  8 
 spec_rep:  RC 
 src_sf:  20000 
 start:  1 
 start_time:  0.0625 
 step:  2500 
 window_type:  WT_RECT 

  ----------------
  File: <stdin>

  ---Universal Part of Header---
  File type: FEA (Feature File)
  File header date: Tue Mar 20 15:45:54 1990 , header version: 1.73
  Produced by: addsd, version: 3.12, of: 2/19/90, user: burton
  Hostname:path: sun4:/mc_u2/burton/esps/refcof
  Machine type: Sun4; file is in NATIVE format.
  Number of data records: unknown (input is pipe)
  Data is not tagged.
  comment text:
   addsd - psines.sd - 
     Added samples from psines.sd to samples 1 - 2147483647 of <stdin>.
  Source files: <stdin>
                psines.sd
  There is no reference header.

  ---Type Specific Part of Header (FEA)---
  fea_type: FEA_SD, segment_labeled: NO, field_count: 1

  ---Generic Part of Header---
  record_freq:  20000 
  start_time:  0 

   ----------------
   File: <stdin>

   ---Universal Part of Header---
   File type: FEA (Feature File)
   File header date: Tue Mar 20 15:45:54 1990 , header version: 1.73
   Produced by: testsd, version: 3.13, of: 12/6/89, user: burton
   Hostname:path: sun4:/mc_u2/burton/esps/refcof
   Machine type: Sun4; file is in NATIVE format.
   Number of data records: unknown (input is pipe)
   Data is not tagged.
   comment text:
    testsd -Tgauss -r20000 - 
   There is no reference header.

   ---Type Specific Part of Header (FEA)---
   fea_type: FEA_SD, segment_labeled: NO, field_count: 1

   ---Generic Part of Header---
   level:  500 
   max_value:  0 
   record_freq:  20000 
   seed:  1234567 
   start_time:  0 
   test_type:  GAUSS 

   ----------------
   File: psines.sd

   ---Universal Part of Header---
   File type: FEA (Feature File)
   File header date: Tue Mar 20 15:45:52 1990 , header version: 1.73
   Produced by: addsd, version: 3.12, of: 2/19/90, user: burton
   Hostname:path: sun4:/mc_u2/burton/esps/refcof
   Machine type: Sun4; file is in NATIVE format.
   Number of data records: 8000
   Data is not tagged.
   comment text:
    addsd - psine1.sd psines.sd 
      Added samples from psine1.sd to samples 1 - 2147483647 of <stdin>.
   Source files: <stdin>
                 psine1.sd
   There is no reference header.

   ---Type Specific Part of Header (FEA)---
   fea_type: FEA_SD, segment_labeled: NO, field_count: 1

   ---Generic Part of Header---
   record_freq:  20000 
   start_time:  0 

    ----------------
    File: <stdin>

    ---Universal Part of Header---
    File type: FEA (Feature File)
    File header date: Tue Mar 20 15:45:51 1990 , header version: 1.73
    Produced by: testsd, version: 3.13, of: 12/6/89, user: burton
    Hostname:path: sun4:/mc_u2/burton/esps/refcof
    Machine type: Sun4; file is in NATIVE format.
    Number of data records: unknown (input is pipe)
    Data is not tagged.
    comment text:
     testsd -Tsine -f1100 -r20000 - 
    There is no reference header.

    ---Type Specific Part of Header (FEA)---
    fea_type: FEA_SD, segment_labeled: NO, field_count: 1

    ---Generic Part of Header---
    frequency:  1100 
    level:  500 
    max_value:  500 
    phase:  0 
    record_freq:  20000 
    start_time:  0 
    test_type:  SINE 

    ----------------
    File: psine1.sd

    ---Universal Part of Header---
    File type: FEA (Feature File)
    File header date: Tue Mar 20 15:45:50 1990 , header version: 1.73
    Produced by: testsd, version: 3.13, of: 12/6/89, user: burton
    Hostname:path: sun4:/mc_u2/burton/esps/refcof
    Machine type: Sun4; file is in NATIVE format.
    Number of data records: 8000
    Data is not tagged.
    comment text:
     testsd -Tsine -r20000 -f600 psine1.sd 
    There is no reference header.

    ---Type Specific Part of Header (FEA)---
    fea_type: FEA_SD, segment_labeled: NO, field_count: 1

    ---Generic Part of Header---
    frequency:  600 
    level:  500 
    max_value:  500 
    phase:  0 
    record_freq:  20000 
    start_time:  0 
    test_type:  SINE 

Record 1: tag: 1, tot_power: 516897, frame_len: 2500

voiced:  NO 

freq		re_spec_val	im_spec_val
0.000000e+00	1.407048e+01
1.953125e+01	1.404504e+01
3.906250e+01	1.396749e+01
5.859375e+01	1.383674e+01
 .
 .
 .
 .
.ft LR
.fi