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”/clients/. 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? (channel-constraints) [temporal-constraints]
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).
Detailed Descriptions of each Query Parameter
These options allow you to specify station|network|channel|location. Locations and channels both accept
|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:
|cha[nnel]||BH1||SEED channel code mask. This parameter accepts wildcards.|
If no times are specified, then the current time is assumed. Otherwise, either use
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.
|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.|
Retrieve the WADL associated with this service:
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
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
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.