Configuration¶
A download is configured in a single JSON file. Generate one with all defaults filled in:
Default configuration
{
"writer": {
"sds_archive": "data",
"steim_compression": 1,
"record_length": 4096,
"min_length_seconds": "PT1M",
"fix_date_suffixes": false,
"squirrel_environment": null
},
"clients": [
{
"url": "https://geofon.gfz.de/",
"timeout": 30.0,
"n_workers": 8,
"n_connections": 24,
"chunk_size": "4.0MiB",
"rate_limit": 10,
"eida_key": null
}
],
"metadata_path": "metadata",
"time_range": [
"2026-11-07",
"today"
],
"station_selections": [
{
"selection": "StationSelection",
"exclude_stations": [],
"include_restricted": true,
"stations": [
"2D.."
]
},
{
"selection": "GeographicSelection",
"exclude_stations": [],
"include_restricted": true,
"networks": [],
"minlatitude": 40.68,
"maxlatitude": 40.98,
"minlongitude": 13.94,
"maxlongitude": 14.34
},
{
"selection": "RadiusSelection",
"exclude_stations": [],
"include_restricted": true,
"networks": [],
"latitude": 40.827,
"longitude": 14.139,
"minradius": 0.0,
"maxradius": 0.15
}
],
"channel_priority": [
"HH[ZNE12]",
"EH[ZNE12]",
"HN[ZNE12]"
],
"min_channels_per_station": 1,
"min_sampling_rate": 100.0,
"max_sampling_rate": 200.0
}
You can leave out any option, and it takes its default. The smallest useful configuration is:
{
"station_selections": [{"selection": "StationSelection", "stations": ["GE.APE"]}],
"time_range": ["2026-09-01", "2026-09-03"]
}
The file is validated strictly when it is loaded. Malformed values are reported with the name of the option before any request is made. Relative paths are resolved against the directory you run fdsn-rush from.
Unknown options are an error, so a misspelled option such as station_selecton stops the run instead of being ignored. Run fdsn-rush check to find them.
Top level¶
station_selections-
List of objects · default: network
2D, plus the Campi Flegrei bounding box and radius · see Station selectionWhich stations to download: by code, in a bounding box or within a radius. The stations of all selections are downloaded, a station that several selections match only once. At least one selection is required. The default has one selection of each type as an example, so
fdsn-rush initshows all of them. Keep the ones you need. time_range-
Pair of dates · default: the last seven days,
["<7 days ago>", "today"][start, end]as ISO dates ("2026-09-01") or"today"/"yesterday". UTC days fromstartup to, but not including,endare downloaded.startmust not be afterend. channel_priority-
List of channel patterns · default
["HH[ZNE12]", "EH[ZNE12]", "HN[ZNE12]"]Channel groups in order of preference. For each station and day, the first pattern that matches at least
min_channels_per_stationchannels is downloaded. See Channels. min_channels_per_station-
Integer · default
1Minimum number of channels a pattern in
channel_prioritymust match to be used. Set it to3to require complete three-component recordings. min_sampling_rate-
Number (Hz) · default
100.0Channels sampled below this rate are skipped.
0disables the check. max_sampling_rate-
Number (Hz) · default
200.0Channels sampled above this rate are skipped.
0disables the check. metadata_path-
Path · default
"metadata"Directory for StationXML files with full instrument responses, one
<NET>.xmlper network. The files are overwritten on every run. writer- Object · see Writer
clients- List of objects · default: one GEOFON client · see Clients
Station selection¶
Each entry of station_selections picks stations by one of three methods, chosen with selection. The FDSN server does the selecting. Each client queries its own server with every selection.
The defaults of the bounding box and the radius cover the Campi Flegrei caldera, Italy.
selection-
"StationSelection","GeographicSelection"or"RadiusSelection"· requiredThe selection method. It decides which of the options below apply.
stations-
List of station codes · default
["2D.."]·StationSelectiononlyStations to download, as
NET.STA.LOCcodes. The network code is required and explicit. Station and location codes may be left empty to match anything, or contain the wildcards*and?. At least one entry is required. See Selecting stations and channels. minlatitude,maxlatitude-
Number (degrees) · default
40.68,40.98·GeographicSelectiononlyLatitude bounds of the box, inclusive.
minlatitudemust be smaller thanmaxlatitude. minlongitude,maxlongitude-
Number (degrees) · default
13.94,14.34·GeographicSelectiononlyLongitude bounds of the box, inclusive.
minlongitudemust be smaller thanmaxlongitude, so a box cannot cross the antimeridian. latitude,longitude-
Number (degrees) · default
40.827,14.139·RadiusSelectiononlyCentre of the circle.
minradius,maxradius-
Number (degrees) · default
0.0,0.15·RadiusSelectiononlyStations between
minradiusandmaxradiusfrom the centre are selected. Aminradiusabove0selects a ring. networks-
List of network codes · default
[](all networks) ·GeographicSelectionandRadiusSelectionLimits the area to these networks. Codes are explicit, without wildcards.
exclude_stations-
List of station codes · default
[]Stations to drop from the selection, as
NET.STA.LOCcodes. They are matched locally: empty parts match anything,--is the blank location, and the wildcards*,?and[...]all work. include_restricted-
Boolean · default
trueInclude stations with restricted data. Set it to
falseif you have no EIDA token for them, so they are not requested at all.
Writer¶
Controls how day files are written to the SDS archive.
"writer": {
"sds_archive": "data",
"steim_compression": 1,
"record_length": 4096,
"min_length_seconds": "PT1M",
"fix_date_suffixes": false,
"squirrel_environment": null
}
sds_archive-
Path · default
"data"Root directory of the SDS archive. It is created if it does not exist. It also holds
remote_errors.log, as explained in Missing data. steim_compression-
1or2· default1STEIM compression of the MiniSEED records. STEIM2 produces smaller files for most seismic data.
record_length-
512or4096· default4096MiniSEED record length in bytes.
min_length_seconds-
ISO 8601 duration · default
"PT1M"(one minute)Traces shorter than this are dropped before writing. Examples:
"PT30S","PT5M". Plain numbers are not accepted. fix_date_suffixes-
Boolean · default
falseRepairs archives written by older versions that did not zero-pad the day of year, for example
.5instead of.005. The files are renamed in place on startup. squirrel_environment-
Path or
null· defaultnullPath to an existing Pyrocko Squirrel environment. Each new day file is added to it right after it is written.
Clients¶
Each entry in clients is one FDSN data centre. All clients download in parallel. See Servers and performance.
"clients": [
{
"url": "https://geofon.gfz.de/",
"timeout": 30.0,
"n_workers": 8,
"n_connections": 24,
"chunk_size": "4.0MiB",
"rate_limit": 10,
"eida_key": null
}
]
url-
URL · default
"https://geofon.gfz.de/"Base URL of the FDSN web service, without the
/fdsnws/...path. timeout-
Number (seconds) · default
30.0, minimum1How long to wait for data before a request is abandoned.
n_workers-
Integer · default
8, range1–64Number of day files downloaded concurrently from this server.
n_connections-
Integer · default
24, range1–128Size of the HTTP connection pool.
chunk_size-
Byte size · default
"4.0MiB", minimum"1MiB"Size of the chunks the download stream is read in.
rate_limit-
Integer (requests/second) · default
10, minimum1Maximum rate of new waveform requests. It is replaced by the server's
X-RateLimit-Limitheader if one is sent. eida_key-
Path or
null· defaultnullPath to an EIDA token file for restricted data.
~is expanded, and the file must exist. See Restricted data with EIDA tokens.