NAME
dfs - DeFine Segment
SYNOPSIS
dfs [-OPT:val] wavfil[.ext]$segment
DESCRIPTION
Creates a new segment definition in the specified waveform
file. The new segment will start at a time specified by -BEG and end at
a time specified by -END. If an offset is specified relative to an
existing segment definition usings -OFF:<seg>, the begining and end
times will be taken as relative to the start of the offset
segment. If -FEA is set,
the beginning and end times are relative to the location
of the specified feature. When a feature search is enabled
(with -FEA), the three additional options -SS, -SB, -SE can
be used to indicate, respectively, a Search Segment name, a
Search Begin time, and a Search End time. The -SB and -SE
times (in msec) are relative to the begining of the waveform
file if -SS is not given, otherwise they are relative to the
beginning of the search segment to allow searches to be made
in the region around, but not necessarily restricted to the
search segment. DFS will not allow the redefinition of an
existing segment unless the -REN switch is present.
OPTIONS
- wavfil.ext
- The file to receive the new segment definition.
- $segment
- The new segment name to be added to wavfil.
- -BEG:m
- Begin time in msec for the new segment definition. Default is -BEG:0
- -END:m
- End time in msec for the new segment definition. Default is end of
file.
- -OFF:segment
- The name of an existing segment to use as an offset into the
file. Times specified by -BEG and -END are added to the onset time of
segment.
- -REN
- Allows redefinition of an existing segment. If -REN is not used,
dfs will stop with an error message when an existing segment is
about to be redefined.
- -FEA:type
- A waveform feature to use in locating the segment. Allowable types
are:
- MAX
- The location of the maximum sample value.
- MIN
- The location of the minimum sample value.
- PZC
- A Positive-going Zero Crossing
- NZC
- A Negative-going Zero Crossing
- -SS:seg
- Search segment name for -FEA search. The feature search will
occur only within this segment.
- -SB:m
- Search begin time in msec for -FEA search. The feature search
will begin at this time. The time is relative to the segment specified
by -SS if given, otherwise, time is relative to the begining of the
waveform file.
- -SE:m
- Search begin time in msec for -FEA search. The feature search
will begin at this time. The time is relative to the segment specified
by -SS if given, otherwise, time is relative to the begining of the
waveform file.
SEE ALSO
putseg (1)
getseg (1)
length (1)
edw (1)
AUTHOR
H. T. Bunnell