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 EarthScope (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

...