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.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
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 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] | BHZ | Select SEED channel code. (can be glob wildcard) | string | |
quality | M | Select SEED channel code. (can be glob wildcard) | string | |
target | IU.ANMO.00.BHZ.M | can be comma separated list or multiple target parameters | 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)” | usr encoded string |
plot.frequency.axis | hide | Controls whether the frequency axis is shown. “hide” or “show”. | show | show, hide |
plot.labelfont.size | 18 | Manually set the font size of axis labels | auto | positive integer |
plot.horzaxis | freq, time | Set plot orientation. The horizontal axis can be either time or freq[uency] | time | time, freq |
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 | boolean |
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. One of auto, day, month, year | auto | string |
plot.time.invert | true | Flips the time axis | false | boolean |
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 | number,number | |
plot.frequency.invert | true | Flip the frequency axis | false | boolean |
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)