NSF SAGE Facility IRISWS sacpz Web Service Documentation

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

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:

application.wadl


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.

IRISWS sacpz web service