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)

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

Value

A list of three Stream objects is returned.

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 http://service.iris.edu/irisws/rotation/1/{rotation documentation}.) Error returns from the web service will stop evaluation and generate an error message.

References

The IRIS DMC rotation web service: