Synopsis

fdsndataselect [-vV] [--help] [--longestonly] [--post] [--printurl] [--raw] [--validate] [-b=<startTime>] [--baseurl=<baseURL>] [-e=<endTime>] [--host=<host>] [--minimumlength=<minimumLength>] [--nodata=<nodata>] [-o=<outputFile>] [--port=<port>] [--quality=<quality>] [-c=<channel>[,<channel>…​]]…​ [-l=<location>[,<location>…​]]…​ [-n=<network>[, <network>…​]]…​ [-s=<station>[,<station>…​]]…​ [--user=<user> --password=<password>]

Description

Example client to query a remote FDSN DataSelect web service via GET or POST

Times are ISO8601 formatted strings, like yyyy-MM-ddTHH:mm:ss, and may be shortened to include only the significant fields. The remaining fields will be filled in as either zero or max value depending on the use. For example 2006-11-19 or 2006-11-19T06:34:21. The special strings now and yesterday may also be used.

View source code here.

Options

-b, --start, --starttime=<startTime>

Limit results to time series samples on or after the specified start time

--baseurl=<baseURL>

Base URL for queries, ie everything before the '/<service>/<version>/<query>?'

-c, --cha, --channel=<channel>[,<channel>…​]

Select one or more SEED channel codes. Multiple codes are comma-separated.

-e, --end, --endtime=<endTime>

Limit results to time series samples on or before the specified end time

--help

display a help message

--host=<host>

host to connect to, defaults to service.iris.edu

-l, --loc, --location=<location>[,<location>…​]

Select one or more SEED location identifiers. Multiple identifiers are comma-separated. As a special case — (two dashes) will be translated to a string of two space characters to match blank location IDs.

--longestonly

Limit results to the longest continuous segment per channel.

--minimumlength=<minimumLength>

Limit results to continuous data segments of a minimum length specified in seconds.

-n, --net, --network=<network>[,<network>…​]

Select one or more network codes. Can be SEED network codes or data center defined codes. Multiple codes are comma-separated.

--nodata=<nodata>

nodata http return code

-o, --output=<outputFile>

File for outputing result

--password=<password>

password for restricted data access

--port=<port>

port to connect to, defaults to 80

--post

use http POST instead of GET

--printurl

Construct and print URL and exit

--quality=<quality>

Select a specific SEED quality indicator, handling is data center dependent.

--raw

Output the raw data to stdout

-s, --sta, --station=<station>[,<station>…​]

Select one or more SEED station codes. Multiple codes are comma-separated.

--user=<user>

username for restricted data access

-v, --verbose

Verbose

-V, --version

Print version and exit

--validate

Validate XML against schema

Examples

Ask for 2 minutes of HHZ data from station CO.JSC, and output to a file.

> fdsndataselect -n CO -s JSC -c LHZ -o jsc_1.mseed -b 2021-02-28T12:45:00 -e 2021-02-28T12:46:00 -v
M CO.JSC.00.LHZ 2021,059,12:45:00.0695  57 57
M CO.JSC.00.LHZ 2021,059,12:45:57.0695  4 4

Multiple channels, either comma separated or using multiple flags.

> fdsndataselect -n CO -s JSC -c LHZ -c LHN,LHE -o jsc_2.mseed -b 2021-02-28T12:45:00 -e 2021-02-28T12:46:00 -v
M CO.JSC.00.LHE 2021,059,12:45:00.0695  1 1
M CO.JSC.00.LHE 2021,059,12:45:01.0695  60 60
M CO.JSC.00.LHN 2021,059,12:45:00.0695  61 61
M CO.JSC.00.LHZ 2021,059,12:45:00.0695  57 57
M CO.JSC.00.LHZ 2021,059,12:45:57.0695  4 4

Only print the URL that would be accessed without connecting to the remote server.

> fdsndataselect -n CO -s JSC -c LHZ -c LHN,LHE -b 2021-02-28T12:45:00 -e 2021-02-28T12:46:00 --printurl
http://service.iris.edu:80/fdsnws/dataselect/1/query?channel=LHZ,LHN,LHE&endtime=2021-02-28T12:46:00.999Z&network=CO&starttime=2021-02-28T12:45:00.000Z&station=JSC