SAGE Facility Web Services

These services may be used under SAGE Facility Terms of Service in accordance with our Usage Guidelines. Usage of the services and data in publications should cite the services according to our citation instructions and data by network.

Service Implementations

FDSNWS

Service Interface Version Summary Return options

station

v.1

metadata for time series stored in SEED format

dataselect

v.1

time series data in miniSEED and other formats

miniSEED
SAC zip
GeoCSV

availability

v.1

Service for returning time series data availability

  • Text
  • JSON
  • GEOCSV
  • Request

event

v.1

Retired service

Retired service

IRISWS

Service Interface Version Summary Return options

fedcatalog

v.1

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

text, request

nrl

v.1

A service for integrating with the Nominal Response Library

json, xml, StationXML, StationXML-Response, SEED RESP

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

mars-event

v.1

Martian seismic events (marsquakes) from the NASA InSight mission to Mars

rrds

v.1

A service for generating Research-Ready Data Sets

request
report
verbosereport

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

metadatachange

v.1

changes made to SEED metadata

XML

MUSTANG

Service Interface Version Summary Return options

measurements

v.1

The main MUSTANG web service returning measurements for metrics relating to station data quality.

  • XML (default)
  • text
  • CSV
  • JSON
  • JSONP

noise-psd

v.1

Returns Power Spectral Density (PSD) estimates of seismic data and can generate aggregate plots.

  • Text – CSV
  • XML
  • Plot (PNG)

noise-pdf

v.1

Returns Probability Density Functions (PDFs) in frequency `bins` and can generate aggregate plots.

  • Text – CSV
  • XML
  • Plot (PNG)

noise-spectrogram

v.1

Returns seismic spectrogram images based on daily PDF mode values

  • Plot (PNG)

noise-pdf-browser

v.1

Returns browseable views of MUSTANG PDF plots and spectrogram plots

  • Text
  • JSON
  • HTML

noise-mode-timeseries

v.1

Returns PDF daily modes and mode timeline plots

  • Text – CSV
  • XML
  • Plot (PNG)

metrics

v.1

The metrics web service returns a description of available metrics in a variety of formats

  • XML
  • HTML
  • XSD
  • JSON
  • JSONP

targets

v.1

The targets web service returns a list of stations and channels for a given metric.

  • Text

PH5WS

Service Interface Version Summary Return options

station

v.1

metadata for time series data stored in PH5 format

dataselect

v.1

active and passive source time series for data stored in PH5 format

event

v.1

active source event metadata for time series data stored in PH5 format

availability

v.1

Service for returning time series data availability

  • Text
  • JSON
  • GEOCSV
  • Request

evalresp

v.1

instrument response information evaluated from IRIS metadata

  • ASCII : frequency-amplitude-phase
  • ASCII : complex-spectra
  • Bode style plots

resp

v.1

channel response information

SEED RESP

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.
  • Automated or scripted requests can be made using programs such as wget or curl.
  • A Java API is available for Java and MATLAB users.

Subscribe to the Earthscope data-announcements 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.

These services may be used under SAGE Facility Terms of Service in accordance with our Usage Guidelines. Usage of the services and data in publications should cite the services according to our citation instructions and data by network.

Real time data

All open data arriving in (near) real time at the SAGE Facility 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.