NSF SAGE Facility MUSTANG noise-spectrogram Web Service Documentation

Description

The noise-spectrogram web service returns spectrograms for seismic channels based on PDF daily mode values.

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

Query Usage

/query? (channel-options) [date-range-options] [power-output-options] [plot-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   :: [start[time]=<time>]&[end[time]=<time>]

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

plot-options        :: [plot.height=<pixel-height>][plot.width=<pixel-width>] 
                       [plot.horzaxis=<time|freq|frequency>]

                       [plot.color.palette=<rainbow|RdYlBu|RdBu|BrBG|YlGnBu|viridis|OrRd>]
                       [plot.color.invert=<true|false>]

                       [plot.powerscale.autorange=<value 0 to 1>]|[plot.powerscale.range=<min,max>]
                       [plot.powerscale.height=<value>][plot.powerscale.width=<value>]
                       [plot.powerscale.show=<true|false>][plot.powerscale.x=<value>][plot.powerscale.y=<value>]
                       [plot.powerscale.orientation=<horizontal|horz|vertical|vert>]

                       [plot.title=<title|hide>][plot.subtitle=<title|hide>] 
                       [plot.titlefont.size=<value>][plot.subtitlefont.size=<value>] 
                       [plot.axisfont.size=<value>][plot.labelfont.size=<value>]

                       [plot.time.matchrequest=<true|false>][plot.time.format=<time-format>][plot.time.label=<text|hide>]
                       [plot.time.tickunit=<auto|day|month|year>][plot.time.invert=<true|false>]

                       [plot.frequency.label=<text|hide>][plot.frequency.invert=<true|false>]
                       [plot.frequency.range=<min,max>]

format-option      :: [format=<plot>]
nodata-option      :: [nodata=<404|204>]

(..) required
[..] optional

Sample Queries

Plot
../query?target=IU.ANMO.00.BHZ.M

Make frequency the horizontal axis instead of time:
../query?target=IU.ANMO.00.BHZ.M&plot.horzaxis=freq

Output Differenced to Peterson Low Noise Model:
../query?target=IU.ANMO.00.BHZ.M&output=dlnm

Output Differenced to Median Values of Daily Modes:
../query?target=IU.ANMO.00.BHZ.M&output=powerdmedian

Fixed Color Scale -170 to -110 [dB]:
../query?target=IU.ANMO.00.BHZ.M&plot.powerscale.range=-170,-110

Use Colors Accessible to Colorblind Users:
../query?target=IU.ANMO.00.BHZ.M&plot.color.palette=RdYlBu

Create A Plot That Can Be Printed in Grayscale (and Photocopied):
../query?target=IU.ANMO.00.BHZ.M&plot.color.palette=OrRd

Detailed Descriptions of each Query Parameter

parameter examples discussion default type
star[ttime] 2010-12-19 Limit to PSD data starting between starttime (inclusive) and endtime (exclusive) earliest available day
end[time] 2010-12-20 Limit to PSD data starting between starttime (inclusive) and endtime (exclusive) latest available day
net[work] IU Select Network code. string
sta[tion] ANMO Select station code. string
loc[ation] 00 Select location code. Use -- for empty location. string
cha[nnel] BHZ Select channel code. string
quality M Select quality code. M for data from our miniSEED archive. D for data from our PH5 archive. (can be glob wildcard) string
target IU.ANMO.00.BHZ.M Network.Station.Location.Channel.Quality. Single targets only. string
output how to display power see help
power (default) show power
powerdmedian power relative to the median per frequency power level
powerdhnm power relative to the High Noise Model
powerdlnm power relative to the Low Noise Model
powerdnm 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
plot.height 1000 Height of plot in pixels 500 positive integer
plot.width 1000 Width of plot in pixels 1000 positive integer
plot.title My+Title Alternative to auto-generated title. hide for no title From selected target url encoded string
plot.subtitle My+Subtitle Subtitle. hide for no subtitle hide url encoded string
plot.titlefont.size 12 Sets the title font size Auto positive integer
plot.subtitlefont.size 12 Sets the subtitle font size Auto positive integer
plot.frequency.label Hz The frequency axis label text. hide for no label “Frequency (Hz)” url encoded string
plot.frequency.axis hide Controls whether the frequency axis is shown. show show, hide
plot.labelfont.size 18 Manually set the font size of axis labels auto positive integer
plot.horzaxis freq Set plot orientation. The horizontal axis can be either time or freq[uency] time time, freq
plot.color.palette Color scheme to use for plot and power scale rainbow string
rainbow (default) cpt-city rainbow palette
RdYlBu ColorBrewer RdYlBu palette
RdBu Colorbrewer RdBu palette
BrBG Colorbrewer BrBG palette
YlGnBu ColorBrewer YlGnBu palette
viridis Matplotlib viridis palette
OrRd ColorBrewer OrRd palette
plot.color.invert true Inverts the color palette false true, false
plot.powerscale.autorange 0.9 A number from 0 to 1. Determines range of data mapped to color scale based on percentile. Mutually exclusive with plot.powerscale.range 0.95 float
plot.powerscale.range -180,-110 Range of power values to be mapped to color scale. Mutually exclusive with plot.powerscale.autorange two comma separated values
plot.powerscale.height 20 Height, in pixels, of the color power scale including text 12 number
plot.powerscale.width 200 Width, in pixels, of the color power scale including text 150 number
plot.powerscale.x 20 Horizontal positon of the color power scale in pixels. Negative values measure from the right side of image 5 number
plot.powerscale.y 20 Vertical positon of the color power scale in pixels. Negative values measure from the bottom of image 5 number
plot.powerscale.orientation vert Determines the orientation of the color power scale horz horz, vert
plot.powerscale.show true Show or hide color scale true true, false
plot.time.label Date+Range The label of the time axis. Use hide to not show DATERANGE url encoded string
plot.time.matchrequest false If true, the plot will match the date range of the request. If false, the plot will match the date range of the data true true, false
plot.time.format yyyy-MM-dd Custom date format for time axis string
plot.time.tickunit year How often time tick units are drawn. auto auto, day, month, year
plot.time.invert true Flips the time axis false true, false
plot.frequency.label Hz The label of the frequency axis. Use “hide” to not show Frequency (Hz) url encoded string
plot.frequency.range 0.01,1 Set the displayed range of the frequency axis. Defaults to the full frequency range of the data two comma separated values
plot.frequency.invert true Flip the frequency axis false true, false
format plot Only supports format plot plot string
nodata 404 Http response codes for no data found 404, 204 404 (subject to change) 204, 404

Date Formats

Year, Month, Day in Month:

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)

Problems with this service?

Please send an email report of which service you were using, your URL query, and any error feedback to:
data-help@earthscope.org
We will address your issue as soon as possible.

MUSTANG noise-spectrogram web service