NSF SAGE Facility MUSTANG noise-psd Web Service Documentation

Description

The noise-psd web service returns Power Spectral Density (PSD) estimates for seismic channels.

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

Query Usage

/query? (channel-options) (date-range-options) [plot-options] (correct-option) (format-option) [nodata-option]

Where:

channel-options    :: (net[work]=<network>&sta[tion]=<station>&loc[ation]=<location>&cha[annel]=<channel>) | 
                      (target=<nslcq>[,<nslcq>...])
date-range-options :: (starttime=<time>&endtime=<time>) | (time=<time>)
plot-options       :: [plot.height=<pixel-heigth>] [plot.width=<pixel-width>] [plot.model=<show|hide>] 
                      [plot.title=<title|hide>] [plot.subtitle=<title|hide>] 
                      [plot.period.min=<value>] [plot.period.max=<value>] 
                      [plot.power.min=<value>] [plot.power.max=<value>] 
correct-option     :: [correct=<true|false>]
format-option      :: [format=<plot|text|xml>]
nodata-option      :: [nodata=<404|204>]

(..) required
[..] optional

Sample Queries

Comma Separated Values (csv)
../query?target=IU.ANMO.00.BHZ.M&starttime=2013-10-22T00:00:00&endtime=2013-10-22T23:59:59&format=text

XML
../query?target=IU.ANMO.00.BHZ.M&starttime=2013-10-22T00:00:00&endtime=2013-10-22T23:59:59&format=xml

Plot
../query?target=IU.ANMO.00.BHZ.M&starttime=2013-10-22T00:00:00&endtime=2013-10-22T23:59:59&format=plot

Plot with Options

Detailed Descriptions of each Query Parameter

parameter examples discussion default type
starttime 2010-12-19 Limit PSD segments starting between starttime (inclusive) and endtime (exclusive) day/time
endtime 2010-12-20 Limit PSD segments starting between starttime (inclusive) and endtime (exclusive) day/time
time 2010-12-20T12:23:00 Limit PSD segments that start (inclusive) and end (exclusive) around “time” day/time
net[work] IU Select Network code. (can be glob wildcard) string
sta[tion] ANMO Select station code. (can be glob wildcard) string
loc[ation] 00 Select location code. Use -- for empty location. (can be glob wildcard) string
cha[nnel] BH? Select channel code. (can be glob wildcard) string
quality * Select quality code. M for data from our miniSEED archive. D for data from our PH5 archive. (can be glob wildcard) string
correct true true for remove instrument response. false for do not remove response. true boolean
target IU.ANMO.00.BHZ.M Network.Station.Location.Channel.Quality. Can be comma separated list or multiple target parameters string
format plot plot, xml, or text string
nodata 404 Http response codes for no data found 404, 204 404 (subject to change) 204, 404
plot.height 7500 Height of plot in pixels 500 positive integer
plot.width 1000 Width of plot in pixels 700 positive integer
plot.title My+Title Alternative to auto generated title. hide for no title. from target list url encoded string
plot.subtitle My+Subtitle Alternative to auto generated title. hide for no subtitle from date range url encoded string
plot.period.min 0.1 Minimum period of plot. Must be given with plot.period.max auto from data positive number
plot.period.max 50 Maximum period of plot. Must be given with plot.period.min auto from data positive number
plot.power.min -190 Minimum power of plot. Must be given with plot.power.max auto from data integer
plot.power.max -120 Maximum power of plot. Must be given with plot.power.min auto from data integer
plot.model hide Show or hide the Peterson high and low noise models. When ‘&correct=false’ is specified, the noise models will not be shown. show show, hide

Wildcards

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


Problems with this service?

Please send an email report of which service you were using, your URL query, and any error feedback to:
[email protected]
We will address your issue as soon as possible.

MUSTANG noise-psd web service