Description
The IRIS SACPZ web service returns the poles and zeros of the selected instrument responses in SAC ASCII format.
Metadata may be selected based on network, station, location or channel names in addition to time.
Web service clients that use ws-sacpz can be found at the Clients list. In particular the FetchData script will request SAC Poles and Zeros from ws-sacpz and write them to channel-specific files.
Below is a full list of service parameters and their usage.
Query Usage
/query? (channel-constraints) [temporal-constraints]
where
channel-constraints :: (station=<STATION>) (network=<NETWORK>) (channel=<CHANNEL>) (location=<LOCATION>) temporal-constraints :: [time=<time>] OR [starttime=<time>] [endtime=<time>] (..) required [..] optional
Query parameters are joined by ampersands “&”, without blank space (see the sample queries).
Sample Queries
- …/query?net=IU&sta=ANMO&loc=*&cha=BH?
- …/query?net=IU&sta=ANMO&loc=00&cha=BHZ&time=2008-11-25T13:05:00
- …/query?net=AV&sta=OKSO&loc=—&cha=BH?&starttime=2011-03-21T00:00:00
Detailed Descriptions of each Query Parameter
parameter | examples | discussion |
---|---|---|
Channel Options Required These options allow you to specify station|network|channel|location. Locations and channels both accept ? and * wildcards. The question mark represents any single character (exactly one), while the asterisk represents zero or more characters.Examples ...net=IU&sta=ANMO&loc=00&cha=BH?&&level=chan ...network=IU&station=ANMO&location=*&channel=BHZ&... |
||
net[work] | IU | SEED network code |
sta[tion] | ANMO | SEED station code |
loc[ation] | 00 | SEED location code mask. This parameter accepts wildcards. Substitute dash characters for white space, ex: loc=-- . |
cha[nnel] | BH1 | SEED channel code mask. This parameter accepts wildcards. |
Temporal constraints If no times are specified, then the current time is assumed. Otherwise, either use time to specify a specific moment in time, or either/both of starttime and endtime to place boundaries on the times of interest.For additional information about allowed time formats, see Time Formats |
||
time | 2011-03-21T13:53:01 | Extract the poles and zeros for the given time. time cannot be used with starttime or endtime parameters |
start[time] | 2011-03-21T00:00:00 | Specify the responses that cover the time period after (and including) this time |
end[time] | 2011-03-21T01:00:00 | Specify responses that cover the time period prior to this time. |
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
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.
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.