Command reference

squirrel merge

Merge two waveform archives into a single one.

squirrel merge
usage: squirrel merge [--help] [--loglevel LEVEL] [--progress DEST]
                      [--threads-loading INT] [--tinc SECONDS] [--align]
                      [--analyse-delay PATH] [--kinds KINDS] [--codes CODES]
                      [--codes-exclude CODES] [--tmin TIME] [--tmax TIME]
                      [--out-path TEMPLATE] [--out-sds-path PATH]
                      [--out-storage-path PATH] [--out-storage-scheme SCHEME]
                      [--out-format FORMAT] [--out-mseed-record-length INT]
                      [--out-mseed-steim INT]
                      DATASET_A DATASET_B

Merge two datasets into a single one. Data gaps in the first are filled with data from the second.

Positional arguments:

DATASET_A

Primary dataset (higher priority): Path to YAML file with a Squirrel dataset configuration. This file can be created using squirrel dataset create or by modifying one of the examples from squirrel template.

DATASET_B

Secondary dataset (lower priority).

Options:

--tinc SECONDS

Set time length of processing batches [s].

--align

Resample data so that samples are at exact multiples of the sampling interval with respect to UTC system time with zero on 1970-01-01 00:00:00.

--analyse-delay PATH

Analyse time delays between A and B in regions of overlap and save results to PATH.

General options:

--help, -h

Show this help message and exit.

--loglevel LEVEL

Set logger level. Choices: critical, error, warning, info, debug. Default: info.

--progress DEST

Set how progress status is reported. Choices: terminal, log, off. Default: terminal.

--threads-loading INT

Set number of threads used in file content loading/decoding. Default: 1

Data query options:

--kinds KINDS

Content kinds to query. KINDS is a comma-separated list of content kinds. Choices: waveform, station, channel, response, event, waveform_promise. By default, all content kinds are queried.

--codes CODES

Code patterns to query (STA, NET.STA, NET.STA.LOC, NET.STA.LOC.CHA, or NET.STA.LOC.CHA.EXTRA). The pattern may contain wildcards * (zero or more arbitrary characters), ? (single arbitrary character), and [CHARS] (any character out of CHARS). Multiple patterns can be given by separating them with commas.

--codes-exclude CODES

Code patterns to exclude. See --codes.

--tmin TIME

Begin of time interval to query. Format: YYYY-MM-DD HH:MM:SS.FFF, truncation allowed.

--tmax TIME

End of time interval to query. Format: YYYY-MM-DD HH:MM:SS.FFF, truncation allowed.

Storage options:

--out-path TEMPLATE

Set output path to TEMPLATE. Available placeholders are %n: network, %s: station, %l: location, %c: channel, %b: begin time, %e: end time, %j: julian day of year. The following additional placeholders use the current processing window’s begin and end times rather than trace begin and end times (to suppress producing many small files for gappy traces), %(wmin_year)s, %(wmin_month)s, %(wmin_day)s, %(wmin)s, %(wmin_jday)s, %(wmax_year)s, %(wmax_month)s, %(wmax_day)s, %(wmax)s, %(wmax_jday)s. Example: --out-path 'data/%s/trace-%s-%c.mseed'

--out-sds-path PATH

Set output path to create an SDS archive (https://www.seiscomp.de/seiscomp3/doc/applications/slarchive/SDS.html), rooted at PATH. Implies --tinc 3600 if not specified otherwise. Equivalent to --out-storage-path PATH --out-storage-scheme sds. Example: --out-sds-path data/sds

--out-storage-path PATH

Create storage directory under PATH. The storage scheme can be set with --out-storage-scheme.

--out-storage-scheme SCHEME

Set storage scheme to produce when using --out-storage-path. Choices: default, sds

--out-format FORMAT

Set output file format. Choices: mseed [default], sac, text, yaff, gse2

--out-mseed-record-length INT

Set the Mini-SEED record length in bytes. Choices: 256, 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536, 131072, 262144, 524288. Default is 4096 bytes, which is commonly used for archiving, unless the selected storage scheme specifies a different default.

--out-mseed-steim INT

Set the Mini-SEED STEIM compression. Choices: 1 or 2. Default is STEIM-2 unless the selected storage scheme specifies a different default. Note: STEIM-2 is limited to 30 bit dynamic range.

Manual: https://pyrocko.org/docs/current/apps/squirrel

Tutorial: https://pyrocko.org/docs/current/apps/squirrel/tutorial.html

Examples: https://pyrocko.org/docs/current/apps/squirrel/manual.html#examples

🐿️