SNIP(1)

NAME
snip - copy an excerpt of a DB record

SYNOPSIS
snip -i input-record -n new-record [ options ]

DESCRIPTION
snip copies the signal files (and, optionally, annotation files) of the specified input-record, and generates a header file, thereby creating the specified new-record. snip is usually used to extract an excerpt of its input-record, using the -f and -t options (see below) to specify the segment to be copied.

The program xform(1) can also perform this task, but offers additional flexibility (it can scale the signals, resample them at a different frequency, rearrange them, select subsets of them, or reformat them); snip is faster than xform, however.

Options are:

-a annotator
    Copy the specified annotator as well as the signal files. Two or more annotator arguments, separated by spaces, can follow -a. An annotator supplied via the standard input may be specified using `-', but only immediately after `-a'; in this case only, annotations are copied to the standard output.

-f time
    Begin at the specified time in the input record (default: the beginning of the record).

-h  Print a usage summary.

-t time
    Process until the specified time in the input record (default: continue to the end of the record).

The shell variable DB should be set and exported (see setdb(1)).

FILES

new-record.dat
    output signal file

header.new-record
    output header file (under MS-DOS, new-record.hea)

annotator.new-record
    output annotation file (under MS-DOS, new-record.ann)

SEE ALSO
xform(1), setdb(1)