Skip to content

Waveform Data

The seismic can be delivered in MiniSeed or any other format compatible with Pyrocko. Qseek utilizes the Pyrocko Squirrel for fast and asynchronous data access.

To prepare your data for EQ detection and localisation, organize it in a MiniSeed file or an SDS structure.

Local Waveform Data

To copy large data from FDSN data centers use fdsn-fetch.

PyrockoSquirrel Module

Waveform provider using Pyrocko's Squirrel.

channel_selector

Channel selector for waveforms, e.g. ['HH', 'EN'].

environment

Path to a Pyrocko Squirrel environment.

persistent

Name of the Squirrel's persistent collection for faster loading of large data sets.

waveform_dirs

List of directories holding the waveform files.

start_time

Start time for the search in ISO8601 including timezone. E.g. 2024-12-30T00:00:00Z.

end_time

End time for the search in ISO8601 including timezone. E.g. 2024-12-31T00:00:00Z.

n_threads: 8

Number of threads for loading waveforms, important for large data sets.

watch_waveforms

Watch the waveform directories for changes. If True it will check every ten minutes. If a timedelta is provided it will check every specified time. Default is False.

queue_size: 16

Size of the internal queue for prefetching waveform batches.

JSON for PyrockoSquirrel
{
  "provider": "PyrockoSquirrel",
  "channel_selector": null,
  "environment": null,
  "persistent": "docs",
  "waveform_dirs": [
    "data"
  ],
  "start_time": null,
  "end_time": null,
  "n_threads": 8,
  "watch_waveforms": false,
  "queue_size": 16
}

Real-Time Waveform Streaming

Waveform provider to connect to SeedLink real-time streams.

channel_selector

Channel selector for waveforms, e.g. ['HH', 'EN'].

timeout

Maximum wait time for new traces.

clients

List of SeedLink clients to connect to. If multiple clients are given, they will be used in parallel.

save_sds_archive

Path to save MiniSeed in an SDS structure. Give a path to save the archive, or True to use the default path. If False, no saving is done.

JSON for SeedLink
{
  "provider": "SeedLink",
  "channel_selector": null,
  "timeout": "PT20S",
  "clients": [
    {
      "host": "geofon.gfz-potsdam.de",
      "port": 18000,
      "station_selection": [
        {
          "nsl": "1D.SYRAU.",
          "channel": "HH?"
        },
        {
          "nsl": "1D.WBERG.",
          "channel": "HH?"
        },
        {
          "nsl": "WB.KOC.",
          "channel": "HH?"
        },
        {
          "nsl": "WB.KRC.",
          "channel": "HH?"
        },
        {
          "nsl": "WB.LBC.",
          "channel": "HH?"
        },
        {
          "nsl": "WB.SKC.",
          "channel": "HH?"
        },
        {
          "nsl": "WB.STC.",
          "channel": "HH?"
        },
        {
          "nsl": "WB.VAC.",
          "channel": "HH?"
        }
      ],
      "buffer_length": "PT30M",
      "reconnect_timeout": 60.0
    }
  ],
  "save_sds_archive": "sds-seedlink"
}