getRotation: 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)

Value

A list of three Stream objects is returned.

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

Author

Jonathan Callahan jonathan@mazamascience.com

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.

References

The IRIS DMC rotation web service:

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