getPsdMetrics {IRISMustangMetrics}

Retrieve measurements from the MUSTANG BSS

Description

The getPsdMetrics method of the IrisClient makes a request of the MUSTANG BSS (Backend Storage System) and returns a dataframe containing instrument corrected Power Spectral Density (PSD) measurements.

Usage

getPsdMetrics(obj, network, station, location, channel, starttime, endtime, url) 

Arguments

obj

an IrisClient object

network

a character string with the two letter seismic network code

station

a character string with the station code

location

a character string with the location code

channel

a character string with the three letter channel code

starttime

a POSIXct class specifying the starttime (GMT)

endtime

a POSIXct class specifying the endtime (GMT)

url

optional url of the BSS measurements service

Details

The default BSS measurement service when url is not specified is:

http://service.iris.edu/mustang/noise-psd/1/query?

Data returned from the BSS are converted into an R dataframe.

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

Value

A dataframe with the following columns:

target, starttime, endtime, frequency, power

Author(s)

Jonathan Callahan [e-mail]

See Also

getBssMetricList

Examples

  ## Not run: 
# Open a connection to IRIS DMC webservices (including the BSS)
iris <- new("IrisClient", debug=TRUE)

starttime <- as.POSIXct("2012-01-24", tz="GMT")
endtime <- as.POSIXct("2012-01-25", tz="GMT")

# Get the measurement XML
psdDF <- getPsdMetrics(iris,"AK","PIN","","BHZ", starttime,endtime)
  
## End(Not run)