/fdsnws_scripts

Scripts for working with (EIDA) FDSN web services

Primary LanguagePythonGNU Lesser General Public License v3.0LGPL-3.0

fdsnwsscripts

https://img.shields.io/badge/DOI-10.5880/gfz.2.4.2024.002-green https://img.shields.io/badge/License-LGPLv3-blue

Scripts for working with (EIDA) FDSN web services.

Citation

Please cite the use of this software as:

Heinloo, A. (2024). fdsnws_scripts: a collection of next generation distributed data request tools based on FDSN web services and the EIDA routing service (Version 2023.191) [Computer software]. GFZ Data Services. DOI: 10.5880/gfz.2.4.2024.002

Overview

fdsnws_scripts is a collection of next generation distributed data request tools that are based on FDSN web services and the EIDA routing service.

You may use these tools to request

  • seismic waveform data, as mini-SEED, using the fdsnws-dataselect web service,
  • seismic metadata, as FDSN Station XML, using the fdsnws-station web service.
  • availability information, as JSON or POST format, using the fdsnws-availability web service.

There are four tools here:

  1. fdsnws_fetch can request waveform data or metadata, from multiple data centres (access points) with a single command. It does this using the EIDA routing service to discover which data centre(s) holds the data requested.
  2. fdsnws2sds supports requests for larger amounts of data, saving it in an SDS tree-like file system structure (the SeisComP Data Structure). SDS is defined here.
  3. fdsnws2seed provides full SEED and dataless SEED using EIDA FDSN web services. Modern applications should use FDSN StationXML instead of SEED.
  4. fdsnavail lets the user interact with the new FDSN availability web service and compare to their local data holdings to find missing data.

Documentation

Detailed user and developer documentation is available at Read the Docs