obspy.clients.iris.client.Client.sacpz

Client.sacpz(network, station, location='*', channel='*', starttime=None, endtime=None, filename=None, **kwargs)[source]

Low-level interface for sacpz Web service of IRIS (http://service.iris.edu/irisws/sacpz/) - release 1.1.1 (2012-1-9).

This method provides access to instrument response information (per-channel) as poles and zeros in the ASCII format used by SAC and other programs. Users can query for channel response by network, station, channel, location and time.

Parameters

  • network (str) – Network code, e.g. 'IU'.

  • station (str) – Station code, e.g. 'ANMO'.

  • location (str, optional) – Location code, e.g. '00', wildcards allowed. Defaults to '*'.

  • channel (str, optional) – Channel code, e.g. 'BHZ', wildcards allowed. Defaults to '*'.

  • starttime (UTCDateTime, optional) – Start date and time.

  • endtime (UTCDateTime, optional) – End date and time. Requires starttime parameter.

  • filename (str, optional) – Name of a output file. If this parameter is given nothing will be returned. Default is None.

Return type

str or None

Returns

String with SAC poles and zeros information if no filename is given.

Example

>>> from obspy.clients.iris import Client
>>> from obspy import UTCDateTime
>>> client = Client()
>>> dt = UTCDateTime("2005-01-01")
>>> sacpz = client.sacpz("IU", "ANMO", "00", "BHZ", dt)
>>> print(sacpz.decode())  
* **********************************
* NETWORK   (KNETWK): IU
* STATION    (KSTNM): ANMO
* LOCATION   (KHOLE): 00
* CHANNEL   (KCMPNM): BHZ
* CREATED           : ...
* START             : 2002-11-19T21:07:00
* END               : 2008-06-30T00:00:00
* DESCRIPTION       : Albuquerque, New Mexico, USA
* LATITUDE          : 34.945981
* LONGITUDE         : -106.457133
* ELEVATION         : 1671.0
* DEPTH             : 145.0
* DIP               : 0.0
* AZIMUTH           : 0.0
* SAMPLE RATE       : 20.0
* INPUT UNIT        : M
* OUTPUT UNIT       : COUNTS
* INSTTYPE          : Geotech KS-54000 Borehole Seismometer
* INSTGAIN          : 1.935000e+03 (M/S)
* ...
* **********************************
ZEROS      3
   +0.000000e+00   +0.000000e+00
   +0.000000e+00   +0.000000e+00
   +0.000000e+00   +0.000000e+00
POLES      5 ...
CONSTANT   6.985619e+13

...