Description
The ph5ws-evalresp webservice evaluates instrument channel response metadata held in the IRIS-DMC’s PH5 archive. The service outputs amplitude–phase Bode plots as well as ASCII text files.
Below is a full list of service parameters and their usage.
Query Usage
/query? (channel-options) [time-option] [frequency-options] [units-options] [plots-options] (output-options)
where
channel-options :: (net=<network>) (sta=<station>) (loc=<location>) (cha=<channel>) time-option :: [time=<time>] frequency-options :: [minfreq=<freq-Hz>] [maxfreq=<freq-Hz>] [nfreq=<number-of-frequencies>] [spacing=<lin|log>] units-options :: [units=<def|dis|vel|acc>] plot-options :: [width=<pixels>] [height=<pixels>] [annotate=<true|false>] output-options :: (output=<fap|cs|plot|plot-amp|plot-phase>) (..) required [..] optional
Query parameters are joined by ampersands “&”, without blank space (see the sample queries).
Sample Queries
- /ph5ws/evalresp/1/query?net=5A&sta=1155&loc=++&cha=DPZ&time=2013-11-17T06:00:00&output=fap
- …&output=cs
- …&output=plot
- …&output=plot&spacing=linear
- …&minfreq=0.002&maxfreq=200.0&output=plot
- …&output=plot-amp
- …&output=plot-phase
Detailed Descriptions of each Query Parameter
parameters | examples | discussion |
---|---|---|
net[work] | 5A | Required Seismic network name |
sta[tion] | 1 | Required Seismic station name |
loc[ation] | ++ | Required Location code. Use loc=-- for empty location codes |
cha[nnel] | DPZ | Required Channel Code |
time | 2018-03-12T18:05:50 | Evaluate the response at the given time. If not specified, the current time is used. See: Time Formats |
minfreq | 0.01 | The minimum frequency (Hz) at which response will be evaluated. Must be positive and less than the maxfreq value.Defaults to 0.00001 Hz (1/day ~ 0.000012 Hz) |
maxfreq | 10.0 | The maximum frequency (Hz) at which response will be evaluated. Must be positive and greater than the minfreq value.Defaults to the channel sample-rate or the frequency of sensitivity, whichever is larger. |
nfreq | 1000 | Number frequencies at which response will be evaluated. Must be a positive integer no greater than 10000. The instrument response is evaluated on a equally spaced logarithmic scale. Defaults to 200 |
units | acc | Optional — Outputs def — default units indicated in response metadata dis — converts to units of displacement vel — converts to units of velocity acc — converts to units of acceleration If units are not specified, then the units will default to those indicated in the response metadata. |
spacing | linear | Optional lin, linear — linear spacing of evaluated frequencies log, logarithmic — logarithmic spacing of evaluated frequencies If spacing is not specified, then logarithmic will be used. |
width | 1000 | The width of the generated plot. Defaults to 800. Can only be used with the output=plot , output=plot-amp and output=plot-phase options.Cannot be larger than 5000 and the product of width and height cannot be larger than 6,000,000 |
height | 1000 | The height of the generated plot. Defaults to 600. Can only be used with the output=plot , output=plot-amp and output=plot-phase optionsCannot be larger than 5000 and the product of width and height cannot be larger than 6,000,000 |
annotate | true | Can be either true or false . Defaults to true .Draws vertical lines at the Nyquist frequency (one half the sample rate). Draws a vertical line at the stage-zero frequency of sensitivity. Draws a horizontal line at the stage-zero gain. Can only be used with the output=plot , output=plot-amp and output=plot-phase options. |
output | plot | Required Option — Outputs fap — Three column ASCII (frequency, amplitude, phase) cs — Three column ASCII (frequency, real, imaginary) plot — Amplitude and phase plot plot-amp — Amplitude only plot plot-phase — Phase only plot |
WADL
Retrieve the WADL associated with this service:
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
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.