Overview
The IRIS Data Management Center's web services provide access to a variety of information, including
- Data and metadata from the IRIS DMC databases
- Time series processing services
- Common calculation services
Web services can be accessed in a number of different ways:
- Small requests can be handled through your browser.
- Dedicated clients are available for making more complex or larger queries.
- Automated or scripted requests can be made using programs such as wget or curl.
- A Java API is available for Java and MATLAB users.
A webservices mailing list (with archive) is available. Users of these services are encouraged to sign up for the mailing list to receive announcements of services changes and interruptions, beta releases and to take part in discussions related to the services or ask for help.
For some additional background please read our newsletter article.
Services
Request Tools
| Service | Retrieves this... | In this format |
|---|---|---|
| ws-event | contributed earthquake origin and magnitude estimates | QuakeML |
| ws-station | network, station, channel, response metadata | StationXML |
| ws-dataselect | single channel of time series data in miniSEED format. Use this to pass data to other workflow services | miniSEED, ICAB |
| ws-timeseries | similar to ws-dataselect with additional options for processing and reformatting | ASCII, WAV, miniSEED, SAC, PNG, ICAB |
| ws-bulkdataselect | multiple channels of time series data | miniSEED |
| ws-resp | channel response information | SEED RESP, ICAB |
| ws-sacpz | instrument response information (per channel) | Poles and Zeroes in ASCII |
| ws-availability | information about what time series data is available from the DMC | XML Query parameters for ws-bulkdataselect, ws-dataselect, or ws-timeseries |
| ws-evalresp | instrument response information evaluated from IRIS metadata | ASCII : frequency-amplitude-phase ASCII : complex-spectra Bode style plots |
| ws-virtualnetwork | list of stations in a virtual network | XML, CVS, XLS |
Calculation Tools
| Service | Calculates this... | In this format |
|---|---|---|
| ws-traveltime | travel times and ray parameters for seismic phases using a 1-D spherical earth model | ASCII |
| ws-distaz | distance, azimuth and back-azimuth between two locations | XML or JSON |
| ws-flinnengdahl | a Flinn-Engdahl region code or name for a latitude, longitude pair | ASCII : region code ASCII : name |
ICAB Processing Tools
These services operate on an ICAB token produced by the ws-resp, ws-dataselect, or ws-timeseries services.
| Service | Does this... | Outputting this |
|---|---|---|
| ws-ms2ascii | converts into a simple ascii format | ASCII |
| ws-plotter | makes simple plots of timeseries data. | PNG image |
| ws-tracedsp | performs digital signal processing | miniSEED, SAC |
Web Service Clients
Several web service clients are available for download. These include simple command-line clients, toolkits and development libraries that access the DMC's web services.
