IRIS DMC MUSTANG noise-psd Web Service Documentation

Description

The noise-psd web service returns Power Spectral Density 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 SEED Network code. (can be glob wildcard) string
sta[tion] ANMO Select SEED station code. (can be glob wildcard) string
loc[tion] 00 Select SEED location code.(can be glob wildcard). Use — for empty string
cha[nnel] BH? Select SEED channel code. (can be glob wildcard) string
quality * Select SEED channel code. (can be glob wildcard) string
corrected true true for remove instrument response. false for do no remove response. true boolean
target IU.ANMO.00.BHZ.M 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 show show, hide

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. These wildcards work when specifying a target, but not when specifying a SNCLQ filter.

MUSTANG noise-psd web service