ws.ipgp.fr

fdsnws-dataselect
Web Service Interface Documentation

 
Interface description URL builder

The fdsnws-dataselect web service provides access to time series data in miniSEED format.

The data may be filtered, e.g., by time, station and network parameters. The request type is HTTP-GET and HTTP-POST.

This service is an implementation of the FDSN web service specification version 1.1.

Endpoints

Base URL: https://ws.ipgp.fr/fdsnws/dataselect/1

Endpoint Methods Description
/query GET
POST		 Retrieve time series data in miniSEED format.
/queryauth GET
POST		 Authenticate and retrieve time series data with restricted access.
/version GET Return the running version of the web service.
/application.wadl GET Return the WADL of the web service.

Query usage

To retrieve time series, the request can be submitted either by HTTP GET or HTTP POST methods.

Via HTTP GET method

With this method, the request is built as a URL. Request parameters are specified after /query? and separated by the & symbol. Parameters can be provided in any order.

/query? [time-constraints] [channel-options] [miscellaneous] [nodata=404]

See Description of the parameters below.

A URL builder is available to help to form the request.

Examples

The same request as above using the wget client to use in a script:

wget "http://ws.ipgp.fr/fdsnws/dataselect/1/query?starttime=2021-09-15&endtime=2021-09-25&network=G&station=CCD&channel=LH%3F&nodata=404" -O mars-data.mseed

Via HTTP POST method

With this method, the request is built through a "post file" containing parameter=value couples and a list of data selectors by channel and time. This method is particularly useful for specifying a precise list of channels.

parameter1=value
parameter2=value
NETWORK STATION LOCATION CHANNEL STARTTIME ENDTIME
NETWORK STATION LOCATION CHANNEL STARTTIME ENDTIME
...

The request can be submitted using an HTTP client like wget or curl.

Example

Get velocimetric data (?H?) for all stations from regional networks GL, WI, MQ and selected stations from global network G for an earthquake occurring on March, 26 2021 at 04:51:39, using a longer time window for more distant stations of G network.

Create the post file postfile.txt containing:

nodata=404
G  HDC   * ?H? 2021-03-26T04:55:00 2021-03-26T05:15:00
G  UNM   * ?H? 2021-03-26T04:55:00 2021-03-26T05:15:00
G  MPG   * ?H? 2021-03-26T04:52:00 2021-03-26T05:15:00
G  FDFM  * ?H? 2021-03-26T04:51:00 2021-03-26T04:56:00
GL *     * ?H? 2021-03-26T04:51:00 2021-03-26T04:56:00
MQ *     * ?H? 2021-03-26T04:51:00 2021-03-26T04:56:00
WI *     * ?H? 2021-03-26T04:51:00 2021-03-26T04:56:00

And submit the request using wget:

wget "https://ws.ipgp.fr/fdsnws/dataselect/1/query?" --post-file=postfile.txt -O data.mseed

Description of the parameters

Note: submitting an empty query (e.g. /query?) will return ALL available data for ALL stations. This request might be very long to execute and the output file might be truncated, due to size constraints. (todo: à compléter après test)

Time constraints

parameter examples description default type
start[time] 2001‑12‑19
2012‑03‑23T12:34:01		 Start of the time series (included). any YYYY‑MM‑DD
YYYY‑MM‑DDThh:mm:ss
end[time] 2001‑12‑19
2012‑03‑23T12:34:01		 End of the time series (included). any YYYY‑MM‑DD
YYYY‑MM‑DDThh:mm:ss

Note: default time is 00:00:00 so 2001‑12‑19 is equivalent to 2001‑12‑19T00:00:00.

Channel options

Lists (comma-separated) and wildcards (*, ?) are accepted.

parameter examples description default type
net[work] PF
GL,MQ,WI		 Select one or more SEED network codes. any string
sta[tion] CAS
DHS,ILAM,BIM		 Select one or more SEED station codes. any string
loc[ation] 00
00,10		 Select one or more SEED location identifier. Use -- for "Blank" location IDs (ID's containing 2 spaces). any string
cha[nnel] HH?
BH?,LH?		 Select one or more SEED channel codes. any string

Miscellaneous

parameters examples description default type
format miniseed Specify output format for time series. Only miniseed is implemented. miniseed format
nodata 404 Specify which HTML Status code is returned when no data is found. 204 204 or 404

Feature notes

This webservice uses SeisComP3 as back-end software.

The following parameters, described in the fdsnws-dataselect specification, are not supported:

  • quality
  • minimumlength
  • longestonly

Resources