IRIS DMC Web Services

Services implementation: IRISWS

Request tools

Service interface Version Summary Return options

fedcatalog

v.1

A service for federating requests for channel metadata across multiple data centers

text, request

syngine

v.1

A service for synthetic seismograms

SACZIP and miniSEED

timeseries

v.1

similar to ws-dataselect with additional options for processing and reformatting

ASCII, WAV, miniSEED, SAC, PNG

timeseriesplot

v.1

A charting webservice offering timeseries graphic display in single-line or helicorder styles

image: PNG (default) or JPEG

rotation

v.1

rotate waveform data into alternate coordinate system
  • zipped (various)
  • png

sacpz

v.1

instrument response information (per channel)

Poles and Zeroes in ASCII

resp

v.1

channel response information

SEED RESP

evalresp

v.1

instrument response information evaluated from IRIS metadata
  • ASCII : frequency-amplitude-phase
  • ASCII : complex-spectra
  • Bode style plots

virtualnetwork

v.1

list of stations in a virtual network
  • XML
  • CVS

availability

v.1

Service for returning miniseed data availability
  • Text
  • JSON
  • GEOCSV
  • Sync

metadatachange

v.1

changes made to SEED metadata

XML

Calculation tools

Service interface Version Summary Return options

traveltime

v.1

travel times and ray parameters for seismic phases using a 1-D spherical earth model

ASCII

flinnengdahl

v.2

a Flinn-Engdahl region code or name for a latitude, longitude pair
  • ASCII : region code
  • ASCII : name
  • ASCII : both

distaz

v.1

distance, azimuth and back-azimuth between two locations

XML

Overview

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.
  • Various schemas are available for download.
  • Automated or scripted requests can be made using programs such as http://wget or http://curl.
  • A Java API is available to provide access to some of these services for Java and MATLAB users.

A http://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.

Usage Guidelines

Real time data

All open data arriving in (near) real time at the IRIS DMC are available from the DMC’s SeedLink server.

The web services should not be used to retrieve continuous, real time data via repeated polling. Instead, the SeedLink server should be used when continuous data streams are needed.