IRIS DMC MUSTANG noise-mode-timeseries Web Service Documentation

Description

The noise-mode-timeseries web service returns Probability Density Function daily mode estimates for individual seismic channels measured at discrete frequencies as a function of time.

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

Query Usage

/query? (channel-options) [date-range-options] [power-output-options] [plot-options] [text-options] [xml-options] [frequency-options] (format-option) [nodata-option]

Where:

channel-options     :: (net[work]=<network>&sta[tion]=<station>&loc[ation]=<location>&cha[annel]=<channel>) | 
                       (target=<nslcq>)
date-range-options   :: [starttime=<time>]&[endtime=<time>]

power-output-options :: [output=<power|powerdhnm|powerdlnm|powerdnm>] 
                        [noisemodel.byperiod=<pipe-separated-list>]
                        [noisemodel.byfrequency=<pipe-separated-list>]

plot-options        :: [plot.height=<pixel-height>] [plot.width=<pixel-width>] 
                       [plot.title=<title|hide>] [plot.subtitle=<title|hide>] 
                       [plot.power.min=<value>] [plot.power.max=<value>] 
                       [plot.power.label=<show|hide>][plot.legend=<show|hide>]
                       [plot.titlefont.size=<value>][plot.subtitlefont.size=<value>]
                       [plot.powerlabelfont.size=<value>][plot.poweraxisfont.size=<value>]
                       [plot.timeaxisfont.size=<value>][plot.legendfont.size=<value>]

frequency-options  :: [frequencies=<freq1,freq1...>|<all>|<[range-start,range-end]>] |
                      [periods=<period1,period2,...>|<all>|<[range-start,range-end]>]

text-options       :: [text.style=<list|table>][text.units=<hertz|seconds>]
xml-options        :: [xml.style=<byday|byperiod|byfrequency|flat>][xml.units=<hertz|seconds>]
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=2010-01-01&endtime=2014-01-01&format=text

Plot
../query?target=IU.ANMO.00.BHZ.M&starttime=2010-01-01&endtime=2014-01-01&format=plot

Plot with Options

Text with Options

XML with Options

Select specific Frequencies and Periods

Detailed Descriptions of each Query Parameter

parameter examples discussion default type
starttime 2010-12-19 Limit to data starting between starttime and endtime 1980-01-01 day/time
endtime 2010-12-20 Limit to data starting between starttime and endtime 2050-01-01 day/time
net[work] IU Select SEED Network code. string
sta[tion] ANMO Select SEED station code. string
loc[tion] 00 Select SEED location code. Use — for empty string
cha[nnel] BHZ Select SEED channel code. string
quality M Select SEED channel code. string
target IU.ANMO.00.BHZ.M 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 1000 Height of plot in pixels 750 positive integer
plot.width 1500 Width of plot in pixels 1100 positive integer
plot.title My+Title Alternative to auto generated title. “hide” for no title. “Daily PDF Mode Timelines” url encoded string
plot.subtitle My+Subtitle Alternative to auto generated title. “hide” for no subtitle “target : date range” url encoded string
plot.power.min -190 Minimum power of plot. Must be given with plot.power.max auto from data integer
plot.power.max 0 Maximum power of plot. Must be given with plot.power.min auto from data integer
plot.legend hide show or hide the legend show show, hide
plot.titlefont.size 32 set font size of title 18 integer
plot.subtitlefont.size 25 set font size of sub-title 12 integer
plot.powerlabelfont.size 32 set font size of label on left side 14 integer
plot.poweraxisfont.size 20 set font size of vertical axis 12 integer
plot.timeaxisfont.size 20 set font size of horizontal axis 12 integer
plot.legendfont.size 20 set font size of legend 12 integer
text.style table list style or table style list list, table
text.units seconds show frequencies or periods hertz hertz, seconds
xml.style flat results grouping. for no grouping, use ‘flat’ byday byday, byfrequency, byperiod, flat
xml.units seconds show frequencies or periods hertz hertz, seconds
frequencies 0.01,0.001 comma separated list of frequencies. “all” for all frequencies auto-selected csv numbers
periods 10, 100 comma separated list of periods. “all” for all periods auto-selected csv numbers
output how to display power see help
power (default) show power
powerdhnm show power relative to the High Noise Model
powerdlnm show power relative to Low Noise Model
powerdnm show power relative to both Noise Models. Positive values designate powers above both noise models, negative values designate powers below both noise models and zero values designate powers between both noise models
noisemodel.byperiod User specified noise model by period see help
noisemodel.byfrequency User specified noise model by frequency see help

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

Requests that return no result

By default, FDSN services return an HTTP code of 204 when a request is “successful”, but there were no matching results. This behavior allows automated systems to know the difference between a successful request (with no data) from an incorrect request (bad parameter names, invalid URL, etc). Since no content is returned, the page on the web browser will not change. To force the service to return a 404, add the query parameter nodata=404.

MUSTANG noise-mode-timeseries web service