You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
187 lines
4.3 KiB
Groff
187 lines
4.3 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "SCMSSORT" "1" "Jan 10, 2023" "5.3.0" "SeisComP"
|
|
.SH NAME
|
|
scmssort \- SeisComP Documentation
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.sp
|
|
\fBRead and manipulate miniSEED records\fP
|
|
.SH DESCRIPTION
|
|
.sp
|
|
scmssort reads unsorted (and possibly multiplexed) MiniSEED files and sorts
|
|
the individual records by time. This is useful e.g. for simulating data
|
|
acquisition and playbacks. Removing of duplicate data and trimming of time
|
|
window is available.
|
|
.sp
|
|
scmssort reads single files and output to the command line. Cat many files
|
|
to read them at the same time. In this way huge amount of data can be processed
|
|
efficiently.
|
|
.sp
|
|
Applications to miniSEED records:
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
Sort records by time, e.g. for playbacks.
|
|
.IP \(bu 2
|
|
Remove duplicate records from files and clean waveform archives.
|
|
.IP \(bu 2
|
|
Filter data records, i.e. keep or remove them, based on
|
|
.INDENT 2.0
|
|
.IP \(bu 2
|
|
time windows,
|
|
.IP \(bu 2
|
|
stream lists where each line has the format NET.STA.LOC.CHA including regular
|
|
expressions. Such stream lists can be generated, e.g., using scinv\&.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
\fBHINT:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
Combine with scart or msrtsimul to archive data or to make
|
|
playbacks with real\-time simulations.
|
|
.IP \(bu 2
|
|
Filter data by stream IDs using NSLC lists which can be generated using
|
|
scinv\&.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.INDENT 0.0
|
|
.IP 1. 3
|
|
Read a single miniSEED data file. The records are sorted by endtime and
|
|
duplicates are removed.
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scmssort \-vuE unsorted.mseed > sorted.mseed
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 2. 3
|
|
Read all files ending with ".mseed" at the same time. The data are trimmed
|
|
to a time window and duplicated data are removed.
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
cat *.mseed | scmssort \-vuE \-t \(aq2020\-03\-28 15:48~2020\-03\-28 16:18\(aq > sorted.mseed
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 3. 3
|
|
Remove streams listed by stream code and sort records by end time. Stream
|
|
lists can be generated, e.g., by scinv\&.
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scmssort \-vuE \-\-rm \-l stream\-list.txt test.mseed > sorted.mseed
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 4. 3
|
|
Extract streams by time and stream code and sort records by end time.
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
echo CX.PB01..BH? | scmssort \-vuE \-t \(aq2007\-03\-28 15:48~2007\-03\-28 16:18\(aq \-l \- test.mseed > sorted.mseed
|
|
scmssort \-vuE \-t \(aq2007\-03\-28 15:48~2007\-03\-28 16:18\(aq \-l stream\-list.txt test.mseed > sorted.mseed
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH COMMAND-LINE OPTIONS
|
|
.sp
|
|
\fBscmssort [options] input\fP
|
|
.SS Options
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show the command\-line help and exit.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-E, \-\-sort\-by\-end\-time
|
|
Sort by end time.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-l, \-\-list
|
|
File with streams to filter the records. One stream per
|
|
line. Instead of a file read the from stdin (\-). Line
|
|
format: NET.STA.LOC.CHA \- wildcards and regular expressions
|
|
are considered. Example: CX.*..BH? .
|
|
.sp
|
|
NSLC lists may be generated, e.g., using scinv.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-r, \-\-rm
|
|
Remove all traces in stream list given by \-\-list
|
|
instead of keeping them.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-t, \-\-time\-window
|
|
Specify time window (as one \-properly quoted\- string).
|
|
Times are of course UTC and separated by a tilde ~
|
|
.sp
|
|
Example:
|
|
.sp
|
|
\(aq2020\-03\-28 15:48~2020\-03\-28 16:18\(aq
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-u, \-\-uniqueness
|
|
Ensure uniqueness of output, i.e. skip duplicate records.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-v, \-\-verbose
|
|
Run in verbose mode.
|
|
.UNINDENT
|
|
.SH AUTHOR
|
|
gempa GmbH, GFZ Potsdam
|
|
.SH COPYRIGHT
|
|
gempa GmbH, GFZ Potsdam
|
|
.\" Generated by docutils manpage writer.
|
|
.
|