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.945980
* LONGITUDE         : -106.457130
* 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)
* COMMENT           :
* SENSITIVITY       : 8.115970e+08 (M/S)
* A0                : 8.608300e+04
* **********************************
ZEROS    3
    +0.000000e+00    +0.000000e+00
    +0.000000e+00    +0.000000e+00
    +0.000000e+00    +0.000000e+00
POLES    5
    -5.943130e+01    +0.000000e+00
    -2.271210e+01    +2.710650e+01
    -2.271210e+01    -2.710650e+01
    -4.800400e-03    +0.000000e+00
    -7.319900e-02    +0.000000e+00
CONSTANT    6.986470e+13



...