fdsnws2sds
fdsnws2sds can be used to download large amounts of waveform data from EIDA FDSN web services. Compared to fdsnws_fetch
- Only command-line options can be used, no request files.
- Only waveform requests are supported.
- Large requests are automatically split into small pieces to avoid exceeding limits.
- Data is saved as SDS structure.
- Download can be stopped and restarted.
Installation
fdsnws2sds is included in SeisComP 3. A standalone version is available from Github and can be installed as follows:
$ git clone https://github.com/GEOFON/fdsnws_scripts $ cd fdsnws_scripts && for f in *.py; do chmod a+x $f; ln -s $f `basename $f .py`; done
Command line options
All command line options, except --max-lines, --max-timespan and --output-dir, are shared with fdsnws_fetch.
--version:
show program's version number and exit
-h, --help:
show help message and exit
-v, --verbose:
verbose mode
-u URL, --url=URL:
URL of routing service (default http://geofon.gfz-potsdam.de/eidaws/routing/1/)
-N NETWORK, --network=NETWORK:
network code or pattern
-S STATION, --station=STATION:
station code or pattern
-L LOCATION, --location=LOCATION:
location code or pattern
-C CHANNEL, --channel=CHANNEL:
channel code or pattern
-s STARTTIME, --starttime=STARTTIME:
start time
-e ENDTIME, --endtime=ENDTIME:
end time
-t TIMEOUT, --timeout=TIMEOUT:
request timeout in seconds (default 600)
-r RETRIES, --retries=RETRIES:
number of retries (default 10)
-w RETRY_WAIT, --retry-wait=RETRY_WAIT:
seconds to wait before each retry (default 60)
-n THREADS, --threads=THREADS:
maximum number of download threads (default 5)
-c CREDENTIALS_FILE, --credentials-file=CREDENTIALS_FILE:
URL,user,password file (CSV format) for queryauth
-a AUTH_FILE, --auth-file=AUTH_FILE:
file that contains the auth token
-o OUTPUT_DIR, --output-dir=OUTPUT_DIR:
SDS directory where downloaded data is written
-l MAX_LINES, --max-lines=MAX_LINES
max lines per request (default 1000)
-m MAX_TIMESPAN, --max-timespan=MAX_TIMESPAN
max timespan per request in minutes (default 1440)
-z, --no-citation
suppress network citation info
-Z, --no-check
suppress checking received routes and data
Example
$ fdsnws2sds -N 7G -s 2014-04-01 -e 2018-01-01 -o SDS
