Table of Contents

NAME

seedfilter - filter records from a SEED stream

SYNOPSIS

seedfilter -x -i -S -v -b size -s selectfile -t types -r types

DESCRIPTION

Filter SEED records from standard in to standard out, copying only those records which meet the include/exclude rules and that of a select file (optional).

The different flags specify the methods for record selection.

-x
Output data to the standard output in LISS-2 (extended mode). Extended mode is comprised simply of SEED records enclosed in a representation which automatically specifies the source, format, and size of the data. If this flag is not used, data will be send to standard output in the same format (raw SEED or extended mode that came in).
-S
Output data records in raw SEED. This is only used to override the format of data that is coming into standard in (as opposed to -x).
-v
Emit diagnostic messages to standard error. Otherwise seedfilter will be quiet.
-b
size
Override the default record sizes. This corresponds with the SEED logical record size. The default record size for files is 512.
-s
selectfile
Allows complex selection to be performed on the input data stream. Combinations of Network, Station, Location, Channel and time-range can be used. Please see the selectfile(4) manual page for information on how to construct a select file. If seedfilter is connecting to a bi-directional LISS-2 port, the filter will be sent up the server. This can greatly lower the network load by transmitting only the desired data, instead of sending it all and throwing away undesired data at the client end.
-i
Invert the sense of the select file. Records which match the select file are removed instead of kept.
-t
types
A list of record types that will be retained when the data is filtered. Defaults to 'D'. You can specify other types (from the ASCII SEED header types).
-r
types
Specify a list of record types that will be removed when the data is filtered. Any retain settings (the -t option) are ignored if this is set.

EXAMPLES

Copy standard out to in - remove all but 'D' type records.

example% seedfilter <in >out

Copy standard out to in - remove only 'A' type records.

example% seedfilter -r A <in >out

Copy standard out to in - Use a select file - copy only 'D' records.

example% seedfilter -s select.dat <in >out

HISTORY

seedfilter was extracted from dumpseed(1) to form a standalone program to permit users to receive raw seed from a LISS.

SEE ALSO

dumpseed(1) , seedport(1) , selectfile(4) , SEED(4)

AUTHOR

Public Domain Software by Scott Halbert - Allied Signal Technical Services Corporation under contract to the Albuquerque Seismological Laboratory - United States Geological Survey - Department of Interior, United States, North American Continent, Earth/Sol 3, Sagitarius Arm of Milky Way Galaxy.


Table of Contents