getRotation: Retrieve rotated seismic data from IRIS DMC

In IRISSeismic: Classes and Methods for Seismic Data Analysis

Retrieve rotated seismic data from IRIS DMC

Description

The getRotation method makes a request of the IRIS DMC rotation web service and returns a list of 3 Stream objects.

Usage

getRotation(obj, network, station, location, channelSet, 
              starttime, endtime, processing)

Arguments

obj	IrisClient object
network	character string with the two letter seismic network code
station	character string with the station code
location	character string with the location code
channelSet	the first two characters of the selected source channels
starttime	POSIXct class specifying the starttime (GMT)
endtime	POSIXct class specifying the endtime (GMT)
processing	optional character string with processing commands

Details

The rotation web service returns a triplet of seismic Streams, rotated according to the processing commands.

If the location argument contains an empty string to specify a 'blank' location code, a location code of "--" will be used in the dataselect request URL.

The processing parameter can be used to specify any type of processing supported by the rotation webs service. This string must begin with an ampersand and be ready to be appended to the request url, e.g. processing="&components=ZRT&azimuth=23.1". This gives the user complete control over the number and order of processing commands. (See rotation documentation.)

Error returns from the web service will stop evaluation and generate an error message.

Value

A list of three Stream objects is returned.

Author(s)

Jonathan Callahan [e-mail]

References

The IRIS DMC rotation web service:

https://service.iris.edu/irisws/rotation/1/

See Also

IrisClient-class

IRISSeismic documentation built on Oct. 16, 2022, 1:09 a.m.