- Name
- Synopsis
- Description
- Options
- Input Files
- Input List File
- Match Or Reject List File
- Leap Second List File
- Author
msi [options] file1 [file2 file3 ...]
msi is a general purpose Mini-SEED parser. In addition to parsing and displaying the contents of Mini-SEED records, msi will derive continuous trace information for Mini-SEED data.
By default, msi will output a single line of information to summarize each record parsed. More verbose or different output can be specified via the numerous options.
If '-' is specified standard input will be read. Multiple input files will be processed in the order specified.
Files on the command line prefixed with a '@' character are input list files and are expected to contain a simple list of input files, see \fBINPUT LIST FILE\fR for more details.
When a input file is full SEED including both SEED headers and data records all of the headers will be skipped and completely unprocessed unless the -y option has been specified.
-V
Print program version and exit.
-h
Print program usage and exit.
-v
Be more verbose. This flag can be used multiple times ("-v -v" or "-vv") for more verbosity.
-r reclen
Specify the input record length in bytes. By default the record length of each input Mini-SEED record is automatically detected, this option forces the record length.
-e encoding
Specify the data encoding format. These encoding values are the same as those specified in the SEED 1000 Blockette.
-ts time
Limit processing to Mini-SEED records that contain or start after time. The format of the time arguement is: 'YYYY[,DDD,HH,MM,SS,FFFFFF]' where valid delimiters are either commas (,), colons (:) or periods (.).
-te time
Limit processing to Mini-SEED records that contain or end before time. The format of the time arguement is: 'YYYY[,DDD,HH,MM,SS,FFFFFF]' where valid delimiters are either commas (,), colons (:) or periods (.).
-M match
Limit processing to Mini-SEED records that match the match regular expression. For each input record a source name string composed of 'NET_STA_LOC_CHAN_QUAL' is created and compared to the regular expression. If the match expression begins with an '@' character it is assumed to indicate a file containing a list of expressions to match, see the \fBMATCH OR REJECT LIST FILE\fR section below.
-R reject
Limit processing to Mini-SEED records that do not match the reject regular expression. For each input record a source name string composed of 'NET_STA_LOC_CHAN_QUAL' is created and compared to the regular expression. If the reject expression begins with an '@' character it is assumed to indicate a file containing a list of expressions to reject, see the \fBMATCH OR REJECT LIST FILE\fR section below.
-n count
Only process count input records.
-y
Do not skip non-SEED data records. By default the program will quietly skip any data which cannot be identified as a SEED data record, allowing the program to work with full SEED volumes and skip bad data. This option is useful to help identify bad data records.
-p
Print details of each record header. This flag can be used multiple times ("-p -p" or "-pp") for more verbosity. Specifying two flags will result in all header details being printed.
-O
Include the offset into the file in bytes when printing header details.
-L
Include data latency when printing header details. The latency is calcualed as the difference between the time of the last sample and the current time from the host computer.
-s
Print a basic summary including the number of records and the number of samples they included after processing all input records.
-d
Decompress/unpack data in input records and print the first 6 sample values from each record.
-D
Decompress/unpack data in input records and print all the sample values.
-t
Print a sorted trace list after processing all input records.
-T
Print a sorted trace list after processing all input records and suppress record-by-record output, i.e. trace list only.
-tg
Include gap estimates when approriate in trace listings.
-tt secs
Specify a time tolerance for constructing continous trace segments. The tolerance is specified in seconds. The default tolerance is 1/2 of the sample period.
-rt diff
Specify a sample rate tolerance for constructing continous trace segments. The tolerance is specified as the difference between two sampling rates. The default tolerance is tested as: (abs(1-sr1/sr2) < 0.0001).
-g
Print a sorted gap/overlap list after processing all input records.
-G
Print a sorted gap/overlap list after processing all input records and suppress record-by-record output, i.e. gap list only.
-gmin sec
Only include gaps in the gap list larger or equal to sec number of seconds.
-gmax sec
Only include gaps in the gap list smaller or equal to sec number of seconds.
-S
Print a sorted SYNC format trace list after processing all input records and suppress record-by-record output.
-Q
Additionally group input data based on SEED data qualitiy flags. By default data are grouped by network, station, location, channel and adjacent time windows, this option adds data quality to the grouping parameters.
-tf format
Specify the time stamp format for trace and gap/overlap lists. The format can be one of the following (default = 0):
0 = SEED time, e.g. "2005,068,00:00:01.000000" 1 = ISO time, e.g. "2005-03-09T00:00:01.000000" 2 = Epoch seconds, e.g. "1110326401.000000"
-b binfile
Decompress/unpack data in input records and write the binary samples to binfile.
-o outfile
Write all processed Mini-SEED records to outfile.
An input file name may be followed by an @ charater followed by a byte offset. In this case the program will interpret the byte offset as the starting offset into the file. Useful for diagnosing specific records. As an example an input file specified as ANMO.mseed@8192 would result in the file ANMO.mseed being read starting at byte 8192.
A list file can be used to specify input files, one file per line. The initial '@' character indicating a list file is not considered part of the file name. As an example, if the following command line option was used:
@files.list
The 'files.list' file might look like this:
data/day1.mseed data/day2.mseed data/day3.mseed
A list file used with either the -M or -R options contains a list of regular expressions (one on each line) that will be combined into a single compound expression. The initial '@' character indicating a list file is not considered part of the file name. As an example, if the following command line option was used:
-M @match.list
The 'match.list' file might look like this:
IU_ANMO_.* IU_ADK_00_BHZ.* II_BFO_00_BHZ_Q
If the environment variable LIBMSEED_LEAPSECOND_FILE is set it is expected to indicate a file containing a list of leap seconds as published by NIST and IETF, usually available here: http://www.ietf.org/timezones/data/leap-seconds.list
If present, the leap seconds listed in this file will be used to adjust the time coverage for records that contain a leap second. Also, leap second indicators in the miniSEED headers will be ignored.
Chad Trabant IRIS Data Management Center
(man page 2015/03/03)