Skip to content

Selecting stations and channels

Four settings control what FDSN Rush downloads:

  • station_selections: which stations, by code, in a bounding box or within a radius.
  • channel_priority and min_channels_per_station: which channels per station.
  • min_sampling_rate and max_sampling_rate: which sampling rates are acceptable.
  • time_range: which days.

Stations

station_selections is a list of selections. Each one chooses stations in one of three ways, set by selection. The FDSN server applies the selection and returns the matching channel inventory. All options are listed in the configuration reference.

The stations of all selections are downloaded. A station that several selections match is downloaded once:

"station_selections": [
  {"selection": "StationSelection", "stations": ["GE.APE"]},
  {"selection": "RadiusSelection", "networks": ["IV"], "maxradius": 0.1}
]

The examples below show one entry of the list each.

By code

{
  "selection": "StationSelection",
  "stations": ["GE", "2D.ST0?", "Z3.A*"]
}

Stations are written as NET.STA.LOC codes, following the SEED convention. Parts you leave empty match anything:

Selection Matches
"GE" every station of network GE
"GE.APE" station APE of network GE, all locations
"GE.APE.00" location 00 of GE.APE
"GE.A*" all GE stations whose code starts with A
"GE..00" location 00 of every GE station

The network code is always required and explicit: "*.STU" or ".STU" are refused. Station and location codes can contain the wildcards * (anything) and ? (one character). FDSN servers reject [...], so it is refused when the configuration is loaded.

FDSN Rush sends one station query per network. A network that the server does not know (404) is logged as a warning and does not affect the others. A station that several entries match is downloaded once.

In a bounding box

{
  "selection": "GeographicSelection",
  "minlatitude": 40.68,
  "maxlatitude": 40.98,
  "minlongitude": 13.94,
  "maxlongitude": 14.34,
  "networks": ["IV"]
}

Selects every station inside the box, bounds included. networks limits the box to some networks, as explicit codes without wildcards. Leave it empty (the default) to get all networks.

Within a radius

{
  "selection": "RadiusSelection",
  "latitude": 40.827,
  "longitude": 14.139,
  "maxradius": 0.15
}

Selects every station within maxradius degrees of the centre. Set minradius to get a ring instead of a disc. networks works as for the bounding box.

The defaults of both area selections cover the Campi Flegrei caldera, which INGV (https://webservices.ingv.it/) serves.

Excluding stations

Every selection takes exclude_stations, in the same NET.STA.LOC syntax:

{
  "selection": "RadiusSelection",
  "exclude_stations": ["IV.CPOZ", "IV.CS*"]
}

Excluded stations are removed after the server has answered, from this selection only. A station that another selection matches is still downloaded. Here, empty parts match anything in every position (".CPOZ", "IV..01"), -- is the blank location, and [...] works too ("IV.CA[AB]*").

When the server fails

A station query that fails with a server error (5xx), 429 Too Many Requests, a timeout or a lost connection is retried twice, after 2 s and 4 s, or later if the server asks for it with a Retry-After header (at most 60 s). Other errors, such as 400 Bad Request or 401 Unauthorized, are not retried. A failed query is logged and counted as failed_queries. The stations of the other queries are still downloaded, and the run ends as partial. If every selection fails on every client, the run stops with an error. See Scripting and automation.

Restricted stations

Some stations are only available with an EIDA token. Without one, set "include_restricted": false so that they are not selected at all instead of failing at download time.

Channels

Stations often record several channel groups, for example a broadband seismometer on HH? and a strong-motion sensor on HN?. channel_priority is an ordered list of channel patterns. For each station and each day, FDSN Rush takes the first pattern that matches at least min_channels_per_station channels and ignores the rest:

"channel_priority": ["HH[ZNE12]", "EH[ZNE12]", "HN[ZNE12]"],
"min_channels_per_station": 3

With this configuration:

  • A station with HHZ, HHN and HHE gets its three HH channels.
  • A station with only EHZ, EHN and EHE gets the EH channels.
  • A station with HHZ alone and no complete group is skipped. With min_channels_per_station set to 1, it would get HHZ.

Because the decision is made per day, a station that was upgraded from short-period to broadband mid-campaign gets EH before the upgrade and HH after it.

Patterns use the same wildcard syntax as stations. "HH?" matches all HH channels, "HH[ZNE]" only the standard orientations, and "*Z" every vertical component.

State-of-health channels are ignored

Auxiliary channels, such as voltages, temperatures, mass positions and LDO pressure, are filtered from the inventory. They are never downloaded, even if a pattern would match them.

Sampling rates

Channels outside [min_sampling_rate, max_sampling_rate] (in Hz) are skipped. A warning names each skipped channel. The defaults (100–200 Hz) suit local and regional seismology. To download long-period LH? channels at 1 Hz:

"channel_priority": ["LH[ZNE]"],
"min_sampling_rate": 1.0,
"max_sampling_rate": 1.0

Set either value to 0 to disable that bound.

Time range

time_range is a pair [start, end] of UTC dates. FDSN Rush downloads whole days from start up to, but not including, end.

time_range Days downloaded
["2026-09-01", "2026-09-03"] September 1 and 2
["2026-01-01", "today"] January 1 up to and including yesterday
["yesterday", "today"] yesterday only

Downloads always cover whole UTC days. A channel is only requested on days that fall within its epoch in the station inventory.

Checking a selection without downloading waveforms

Run metadata to fetch the inventory and StationXML only:

fdsn-rush metadata config.json

Open metadata/<NET>.xml to see which stations and channels your selection covers before you start a large download. To catch typos in the configuration file itself, run fdsn-rush check config.json.