miniseed2days - rewrite multiple input miniseed files into day volumes
miniseed2days
[-d db]
[-S dir]
[-w wfname]
[-s start-time] [-e end-time]
[-m match]
[-DIRUuv]
miniseed ...
miniseed2days reads input seed or miniseed volumes,
and constructs corresponding
output miniseed day volumes for each channel.
An input name of '-' indicates stdin. If a directory is specified,
then all files under that directory are taken as input volumes.
(Any directories to search should not include the current directory,
which is the output directory for miniseed2days).
In the standard usage, the input miniseed volumes should be
arranged in time order; miniseed2days processes the volumes in
command line order. If the command line order is not from oldest
to youngest, then data blocks in the output miniseed volumes may be
out of order. However, see the -u option below for more elaborate
processing.
Data block sequence numbers are changed as the new
day volumes are written.
-
-d db
Run miniseed2db on the output files to create the database db
-
-S dir
specify the top level directory into which the files are saved.
The default is the current directory ".".
-
-u
With the -u option, all the input files are first read and indexed,
and then output files are created in strict time order.
In this case, input files need not be in any particular order,
and input files may have overlaps: duplicate data blocks
are eliminated from the output. (Duplicate means that the blocks are
identical with the possible exception of the block sequence number).
Because all the input files are mapped into memory at once, miniseed2days
can fail due to memory limitations with a large number of input files.
-
-D
When -D is specified with the -u option,
duplicate seed blocks are retained in the output.
-
-U
This option enables a more limited method of suppressing duplication.
miniseed2days keeps a record of the time of the previously written data block for the
same net, sta, channel and loc, and will not write a second block with the same or previous time.
This is useful for qtunbale, which usually requests data for consecutive days
from a Quanterra baler. The baler responds with all the data blocks which
contain data for the day, and this results in overlapping output. With the
-U option, this overlap is eliminated.
-
-I
inclusive time screening: this means that if an input miniseed block
contains times within the specified range, it is written to the output;
normal processing writes only blocks where the initial miniseed block
time from the header is within the time range. This is important when
a block may contain multiple days.
-
-R
remove input miniseed files after contents are processed.
-
-m pattern
regular expression which matches the net_sta_chan_loc
of desired stations. Only channels which match this pattern are copied.
-
-s start-time
only copy data records where the block start time is at or after start-time
-
-e end-time
only copy data records where the block start time is before end-time
(end-time may also be a time period, like 1:30 for an hour and a half)
-
-w wfname
specify an alternate pattern for the output miniseed volumes.
This pattern dictates the way the data records are allocated to
files; all records which have the same resulting filename fall into
that same file.
The default pattern is
dir/%Y/%j/%{net}_%{sta}_%{chan}_%{loc}.msd ;
With a different wfname pattern which mentioned only net and sta,
all the channels for a particular station would fall into the same file.
This path may also be set in the parameter file miniseed2days.pf.
-
-v
Be more verbose.
The parameter file contains the default pattern used
to name the output miniseed files; this can be overridden on the command line.
-
wfname
%Y/%j/%{net}_%{sta}_%{chan}_%{loc}.msd
% miniseed2days -v alas03050.seed
alas03050.seed
325 miniseed data blocks
creating 050/G_ATD_BHE_.msd ..
creating 050/G_ATD_BHN_.msd ..
.
.
.
creating 050/G_UNM_VHE_.msd ..
creating 050/G_UNM_VHN_.msd ..
creating 050/G_UNM_VHZ_.msd ..
wrote 325 miniseed data blocks in 60 files
msdd(1)
db2sd(1)
With the -u option,
miniseed2days memory maps all the input miniseed volumes at
once; this limits the number of seed volumes which can be handled.
With the -U option, miniseed2days avoids writing two consecutive
blocks with the same net, sta, chan, loc and time codes. Perhaps
there are some unusual circumstances where two such blocks might contain
different data.
Daniel Quinlan
Table of Contents
Antelope Release 4.6 Linux 2.4.19-4GB 2004-10-21
Boulder Real Time Technologies, Inc
For more information, contact support@brtt.com