IRIS DMC FDSNWS dataselect Web Service Documentation

Description

The fdsdws-dataselect service provides access to time series data for specified channels and time ranges.

Data are selected using SEED time series identifiers (network, station, location & channel) in addition to time ranges. Data are returned in miniSEED format.

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

Below is a full list of service parameters and their usage.

Query Usage

/query? (date-range-options) [channel-options] [quality-options] [misc-options] [format-options] [nodata=404]

where

date-range-options	:: 	(start=<time>) (end=<time>)
channel-options		:: 	[net=<network>] [sta=<station>] [loc=<location>] [cha=<channel>]
quality-options		:: 	[quality=<D|R|Q|M|B>]
misc-options		::	[minimumlength=<seconds>] [longestonly=<true|false>]
format-options          ::      [format=<mseed>]

(..) required
[..] optional

Query parameters are joined by ampersands ”&”, without blank space (see the sample queries).

POST Usage

Alternately, instead of providing parameter-value pairs in the URL, a file containing a selection list can be POSTed to this service. This is the same method used with the (deprecated) ws-bulkdataselect webservice. For additional details, including an example selection file, visit this page’s help.

quality=<D|R|Q|M|B>
minimumlength=<seconds>
longestonly=<true|false>
<Network> <Station> <Location> <Channel> <StartTime> <EndTime>
...

Quality, minimumlength, and longestonly are optional. Wildcards are acceptable for Network, Station, Location, and Channel. Click here for time format details.

Sample Queries

Detailed Descriptions of each Query Parameter

parameters examples discussion default type
FDSN options
start[time] 2010-02-27T06:30:00 Specifies the desired start-time for miniSEED data day/time
end[time] 2010-02-27T10:30:00 Specify the end-time for the miniSEED data day/time
net[work] IU(…&network=IU) Select one or more network codes1 . Can be SEED codes or data center defined codes. any string
sta[tion] ANMO Select one or more SEED station codes1. any string
loc[ation] 00 Select one or more SEED location identifier1. Use -- for “Blank” location IDs (ID’s containing 2 spaces). any string
cha[nnel] BH1 Select one or more SEED channel codes1. any string
quality B Select data based on miniSEED data quality indicator. D, R, Q, M, B. M and B (default) are treated the same and indicate best available. If M or B are selected, the output data records will be stamped with an M. B quality
minimumlength 0.0 Limit results to continuous data segments of a minimum length specified in seconds. 0.0 Float
longestonlly false Limit results to the longest continuous segment per channel. false Boolean
nodata 404 Specify which HTML Status code is returned when no data is found.2 204 204 or 404
format mseed Specify the format of the data returned mseed mseed

1 Accepts wildcards and lists

2 By default, the service returns a HTTP response code 204, which means the request was successful, but no data (no content) was retrieved. However, because there was no “error”, no error message is generated and it may appear that the browser did nothing. To force an empty query response to display an error message, add nodata=404 to the URL.


WADL

Retrieve the WADL associated with this service:

application.wadl


Date and Time Formats

Year, Month, Day in Month — Time:

YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123

YYYY-MM-DD ex. 1997-01-31 a time of 00:00:00 is assumed

Where:

YYYY	:: four-digit year
MM	:: two-digit month (01=January, etc.)
DD	:: two-digit day of month (01 through 31)
T	:: date-time separator
hh	:: two digits of hour (00 through 23) (AM/PM NOT allowed)
mm	:: two digits of minute (00 through 59)
ss	:: two digits of second (00 through 59)
ssssss	:: one to six digits representing decimal fractions of a second, down to microseconds

Glob Expressions

Wildcards
The question mark ? represents any single character (exactly one), while the asterisk * represents zero or more characters.

Lists
Multiple items may also be retrieved using a comma separated list. For example BHZ,BHN,BHE

Restricted Data Access

For access to restricted data, requests should be sent to: service.iris.edu/fdsnws/dataselect/1/queryauth

Requests sent to this URL are authenticated via digest access authentication in order to establish the caller's credentials. For anonymous access, the user nobody@iris.edu and password anonymous may be used. This credential has identical data access permission as the regular submit path's: service.iris.edu/fdsnws/dataselect/1/query

1.1.1

wslive1.iris.washington.edu

FDSNWS dataselect web service