createBssUrl: Create URL to retrieve measurements from the MUSTANG BSS

In IRISMustangMetrics: Statistics and Metrics for Seismic Data

Create URL to retrieve measurements from the MUSTANG BSS

Description

The createBssUrl method of the IrisClient returns a URL that can be used to make a request of the MUSTANG BSS (Backend Storage System).

Usage

createBssUrl(obj, network, station, location, channel, 
             starttime, endtime, metricName, ...)

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
channel	character string with the three letter channel code
starttime	POSIXct class specifying the starttime (GMT)
endtime	POSIXct class specifying the endtime (GMT)
metricName	character string containing one or more comma separated metric names
...	optional arguments constraint a character string containing value constraints url optional url of the BSS measurements service

Details

A blank location code should be specified as location="--"; Using location="" will return all location codes.

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

https://service.earthscope.org/mustang/measurements/1/query?

Value

A character string containing a BSS request URL

Author(s)

Jonathan Callahan [e-mail]

See Also

getSingleValueMetrics

Examples

# Open a connection to EarthScope webservices (including the BSS)
iris <- new("IrisClient", debug=TRUE)

starttime <- as.POSIXct("2013-06-01", tz="GMT")
endtime <- starttime + 30*24*3600
metricName <- "sample_max,sample_min,sample_mean"

# Get the measurement dataframe
url <- createBssUrl(iris,"IU","ANMO","00","BHZ",
                    starttime,endtime,metricName)

# This URL can be pasted into a web browser to see the BSS return values

IRISMustangMetrics documentation built on April 4, 2025, 2:03 a.m.