seisplotjs.irisfedcatalog 3.0.0-alpha.0

seisplotjs.irisfedcatalog

3.0.0-alpha.0

SERVICE_VERSION
SERVICE_NAME
IRIS_HOST
TARGET_DATASELECT
TARGET_STATION
FAKE_EMPTY_TEXT
FedCatalogDataCenter ▸
- Instance members
- #dataCenter
- #services
- #stationService
- #dataSelectService
- #postLines
- #stationQuery
- #dataSelectQuery
- #networkList
- #sddList
FedCatalogResult ▸
- Instance members
- #params
- #queries
FedCatalogQuery ▸
- Static members
- .fromStationQuery

Need help reading this?

SERVICE_VERSION

src/irisfedcatalog.ts

Major version of the IRIS web service supported here. Currently is 1.

SERVICE_VERSION

Type: number

SERVICE_NAME

src/irisfedcatalog.ts

Service name as used in the FDSN DataCenters registry, http://www.fdsn.org/datacenters

SERVICE_NAME

IRIS_HOST

src/irisfedcatalog.ts

IRIS_HOST

Type: string

TARGET_DATASELECT

src/irisfedcatalog.ts

TARGET_DATASELECT

Type: string

TARGET_STATION

src/irisfedcatalog.ts

TARGET_STATION

Type: string

FAKE_EMPTY_TEXT

src/irisfedcatalog.ts

a fake, completely empty stationxml document in case of no data.

FAKE_EMPTY_TEXT

Type: string

FedCatalogDataCenter

src/irisfedcatalog.ts

Represents the part of the results of a fedcatalog query for a single datacenter, a section of the larger FedCatalogResult.

new FedCatalogDataCenter()

Instance Members

▸ dataCenter

src/irisfedcatalog.ts

dataCenter

Type: string

▸ services

src/irisfedcatalog.ts

services

Type: Map<string, string>

▸ stationService

src/irisfedcatalog.ts

stationService

Type: string

▸ dataSelectService

src/irisfedcatalog.ts

dataSelectService

Type: string

▸ postLines

src/irisfedcatalog.ts

postLines

Type: Array<string>

▸ stationQuery

src/irisfedcatalog.ts

stationQuery

Type: (StationQuery | null)

▸ dataSelectQuery

src/irisfedcatalog.ts

dataSelectQuery

Type: (DataSelectQuery | null)

▸ networkList

src/irisfedcatalog.ts

networkList

Type: (Promise<Array<Network>> | null)

▸ sddList

src/irisfedcatalog.ts

sddList

Type: (Promise<Array<SeismogramDisplayData>> | null)

FedCatalogResult

src/irisfedcatalog.ts

Represents the results of a fedcatalog query.

new FedCatalogResult()

Instance Members

▸ params

src/irisfedcatalog.ts

params

Type: Map<string, string>

▸ queries

src/irisfedcatalog.ts

queries

Type: Array<FedCatalogDataCenter>

FedCatalogQuery

src/irisfedcatalog.ts

Query to a IRIS FedCatalog web service.

new FedCatalogQuery(host: string?)

Extends FDSNCommon

Parameters

host (string?) optional host to connect to, defaults to IRIS

http://service.iris.edu/irisws/fedcatalog/1/

Static Members

▸ fromStationQuery(stationQuery)

src/irisfedcatalog.ts

Constructs a station FedCatalogQuery using the parameters in a StationQuery.

fromStationQuery(stationQuery: StationQuery): FedCatalogQuery

Parameters

stationQuery (StationQuery) query to pull parameters from

Returns

FedCatalogQuery: fedcatalog query

Instance Members

▸ fedCatResult

src/irisfedcatalog.ts

fedCatResult

Type: (Promise<FedCatalogResult> | null)

▸ specVersion(value?)

src/irisfedcatalog.ts

Gets/Sets the version of the fdsnws spec, 1 is currently the only value. Setting this is probably a bad idea as the code may not be compatible with the web service.

specVersion(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getSpecVersion()

src/irisfedcatalog.ts

getSpecVersion(): string

Returns

string

▸ protocol(value?)

src/irisfedcatalog.ts

Gets/Sets the protocol, http or https. This should match the protocol of the page loaded, but is autocalculated and generally need not be set.

protocol(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getProtocol()

src/irisfedcatalog.ts

getProtocol(): (string | undefined)

Returns

(string | undefined)

▸ host(value?)

src/irisfedcatalog.ts

Gets/Sets the remote host to connect to.

host(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getHost()

src/irisfedcatalog.ts

getHost(): (string | undefined)

Returns

(string | undefined)

▸ port(value?)

src/irisfedcatalog.ts

Gets/Sets the remote port to connect to.

port(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getPort()

src/irisfedcatalog.ts

getPort(): (number | undefined)

Returns

(number | undefined)

▸ nodata(value?)

src/irisfedcatalog.ts

Gets/Sets the nodata parameter, usually 404 or 204 (default), controlling the status code when no matching data is found by the service.

nodata(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getNodata()

src/irisfedcatalog.ts

getNodata(): (number | undefined)

Returns

(number | undefined)

▸ targetService(value?)

src/irisfedcatalog.ts

Get/Set the targetservice query parameter.

targetService(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getTargetService()

src/irisfedcatalog.ts

getTargetService(): (string | undefined)

Returns

(string | undefined)

▸ networkCode(value?)

src/irisfedcatalog.ts

Get/Set the network query parameter.

networkCode(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getNetworkCode()

src/irisfedcatalog.ts

getNetworkCode(): (string | undefined)

Returns

(string | undefined)

▸ stationCode(value?)

src/irisfedcatalog.ts

Get/Set the station query parameter.

stationCode(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getStationCode()

src/irisfedcatalog.ts

getStationCode(): (string | undefined)

Returns

(string | undefined)

▸ locationCode(value?)

src/irisfedcatalog.ts

Get/Set the location code query parameter.

locationCode(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getLocationCode()

src/irisfedcatalog.ts

getLocationCode(): (string | undefined)

Returns

(string | undefined)

▸ channelCode(value?)

src/irisfedcatalog.ts

Get/Set the channel query parameter.

channelCode(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getChannelCode()

src/irisfedcatalog.ts

getChannelCode(): (string | undefined)

Returns

(string | undefined)

▸ startTime(value?)

src/irisfedcatalog.ts

Get/Set the starttime query parameter.

startTime(value: (DateTime | string)?): FedCatalogQuery

Parameters

value ((DateTime | string)?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getStartTime()

src/irisfedcatalog.ts

getStartTime(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ endTime(value?)

src/irisfedcatalog.ts

Get/Set the endtime query parameter.

endTime(value: (DateTime | string)?): FedCatalogQuery

Parameters

value ((DateTime | string)?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getEndTime()

src/irisfedcatalog.ts

getEndTime(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ timeRange(se)

src/irisfedcatalog.ts

Sets startTime and endTime using the given time window

timeRange(se: Interval): FedCatalogQuery

Parameters

se (Interval) time window

Returns

FedCatalogQuery: this

▸ timeWindow(se)

src/irisfedcatalog.ts

timeWindow(se: Interval): FedCatalogQuery

Deprecated: This is deprecated.

Parameters

se (Interval) [description]

Returns

FedCatalogQuery: [description]

▸ startBefore(value?)

src/irisfedcatalog.ts

Get/Set the startbefore query parameter.

startBefore(value: (DateTime | string)?): FedCatalogQuery

Parameters

value ((DateTime | string)?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getStartBefore()

src/irisfedcatalog.ts

getStartBefore(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ endBefore(value?)

src/irisfedcatalog.ts

Get/Set the endbefore query parameter.

endBefore(value: (DateTime | string)?): FedCatalogQuery

Parameters

value ((DateTime | string)?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getEndBefore()

src/irisfedcatalog.ts

getEndBefore(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ startAfter(value?)

src/irisfedcatalog.ts

Get/Set the startafter query parameter.

startAfter(value: (DateTime | string)?): FedCatalogQuery

Parameters

value ((DateTime | string)?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getStartAfter()

src/irisfedcatalog.ts

getStartAfter(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ endAfter(value?)

src/irisfedcatalog.ts

Get/Set the endafter query parameter.

endAfter(value: (DateTime | string)?): FedCatalogQuery

Parameters

value ((DateTime | string)?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getEndAfter()

src/irisfedcatalog.ts

getEndAfter(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ minLat(value?)

src/irisfedcatalog.ts

Get/Set the minlat query parameter.

minLat(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMinLat()

src/irisfedcatalog.ts

getMinLat(): (number | undefined)

Returns

(number | undefined)

▸ maxLat(value?)

src/irisfedcatalog.ts

Get/Set the maxlon query parameter.

maxLat(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMaxLat()

src/irisfedcatalog.ts

getMaxLat(): (number | undefined)

Returns

(number | undefined)

▸ minLon(value?)

src/irisfedcatalog.ts

Get/Set the minlon query parameter.

minLon(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMinLon()

src/irisfedcatalog.ts

getMinLon(): (number | undefined)

Returns

(number | undefined)

▸ maxLon(value?)

src/irisfedcatalog.ts

Get/Set the maxlon query parameter.

maxLon(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMaxLon()

src/irisfedcatalog.ts

getMaxLon(): (number | undefined)

Returns

(number | undefined)

▸ latitude(value?)

src/irisfedcatalog.ts

Get/Set the latitude query parameter.

latitude(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getLatitude()

src/irisfedcatalog.ts

getLatitude(): (number | undefined)

Returns

(number | undefined)

▸ longitude(value?)

src/irisfedcatalog.ts

Get/Set the longitude query parameter.

longitude(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getLongitude()

src/irisfedcatalog.ts

getLongitude(): (number | undefined)

Returns

(number | undefined)

▸ minRadius(value?)

src/irisfedcatalog.ts

Get/Set the minradius query parameter.

minRadius(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMinRadius()

src/irisfedcatalog.ts

getMinRadius(): (number | undefined)

Returns

(number | undefined)

▸ maxRadius(value?)

src/irisfedcatalog.ts

Get/Set the maxradius query parameter.

maxRadius(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMaxRadius()

src/irisfedcatalog.ts

getMaxRadius(): (number | undefined)

Returns

(number | undefined)

▸ includeRestricted(value?)

src/irisfedcatalog.ts

Get/Set the includerestricted query parameter.

includeRestricted(value: boolean?): FedCatalogQuery

Parameters

value (boolean?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getIncludeRestricted()

src/irisfedcatalog.ts

getIncludeRestricted(): (boolean | undefined)

Returns

(boolean | undefined)

▸ includeAvailability(value?)

src/irisfedcatalog.ts

Get/Set the includeavailability query parameter.

includeAvailability(value: boolean?): FedCatalogQuery

Parameters

value (boolean?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getIncludeAvailability()

src/irisfedcatalog.ts

getIncludeAvailability(): (boolean | undefined)

Returns

(boolean | undefined)

▸ format(value?)

src/irisfedcatalog.ts

Get/Set the format query parameter.

format(value: string?): FedCatalogQuery

Parameters

value (string?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getFormat()

src/irisfedcatalog.ts

getFormat(): (string | undefined)

Returns

(string | undefined)

▸ updatedAfter(value?)

src/irisfedcatalog.ts

Get/Set the updatedafter query parameter.

updatedAfter(value: DateTime?): FedCatalogQuery

Parameters

value (DateTime?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getUpdatedAfter()

src/irisfedcatalog.ts

getUpdatedAfter(): (DateTime | undefined)

Returns

(DateTime | undefined)

▸ matchTimeseries(value?)

src/irisfedcatalog.ts

Get/Set the matchtimeseries query parameter.

matchTimeseries(value: boolean?): FedCatalogQuery

Parameters

value (boolean?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getMatchTimeseries()

src/irisfedcatalog.ts

getMatchTimeseries(): (boolean | undefined)

Returns

(boolean | undefined)

▸ timeout(value?)

src/irisfedcatalog.ts

Get/Set the timeout in seconds for the request. Default is 30.

timeout(value: number?): FedCatalogQuery

Parameters

value (number?) optional new value if setting

Returns

FedCatalogQuery: new value if getting, this if setting

▸ getTimeout()

src/irisfedcatalog.ts

getTimeout(): (number | undefined)

Returns

(number | undefined)

▸ isSomeParameterSet()

src/irisfedcatalog.ts

Checks to see if any parameter that would limit the data returned is set. This is a crude, coarse check to make sure the client doesn't ask for EVERYTHING the server has.

isSomeParameterSet(): boolean

Returns

boolean: true if some parameter set

▸ queryNetworks()

src/irisfedcatalog.ts

Queries the remote web service for networks.

queryNetworks(): Promise<Array<Network>>

Returns

Promise<Array<Network>>: a Promise to an Array of Network objects.

▸ queryStations()

src/irisfedcatalog.ts

Queries the remote web service for stations. The stations are contained within their respective Networks.

queryStations(): Promise<Array<Network>>

Returns

Promise<Array<Network>>: a Promise to an Array of Network objects.

▸ queryChannels()

src/irisfedcatalog.ts

Queries the remote web service for channels. The Channels are contained within their respective Stations which are in Networks.

queryChannels(): Promise<Array<Network>>

Returns

Promise<Array<Network>>: a Promise to an Array of Network objects.

▸ queryResponses()

src/irisfedcatalog.ts

Queries the remote web service for responses. The Responses are contained within their respective Channels, which are in Stations which are in Networks.

queryResponses(): Promise<Array<Network>>

Returns

Promise<Array<Network>>: a Promise to an Array of Network objects.

▸ queryFdsnStation(level)

src/irisfedcatalog.ts

Queries the remote station web service at the given level.

queryFdsnStation(level: string): Promise<Array<Network>>

Parameters

level (string) the level to query at, networ, station, channel or response.

Returns

Promise<Array<Network>>: a Promise to an Array of Network objects.

▸ setupQueryFdsnStation(level)

src/irisfedcatalog.ts

setupQueryFdsnStation(level: string): Promise<FedCatalogResult>

Parameters

level (string)

Returns

Promise<FedCatalogResult>

▸ setupForFdnsDataSelect(fedCatalogResult)

src/irisfedcatalog.ts

For each item in a parsed result returned from a FedCat service, create a DataSelectQuery with host and port, or url filled in correctly, ready to be called with the result lines.

setupForFdnsDataSelect(fedCatalogResult: FedCatalogResult): FedCatalogResult

Parameters

fedCatalogResult (FedCatalogResult) result from a FedCat web service

Returns

FedCatalogResult: result with dataSelectQuery added to each item

▸ queryFdsnDataselect()

src/irisfedcatalog.ts

queryFdsnDataselect(): Promise<Array<SeismogramDisplayData>>

Returns

Promise<Array<SeismogramDisplayData>>

▸ postFdsnDataselectForFedCatResult(fedCatalogResult)

src/irisfedcatalog.ts

postFdsnDataselectForFedCatResult(fedCatalogResult: FedCatalogResult): Promise<Array<SeismogramDisplayData>>

Parameters

fedCatalogResult (FedCatalogResult)

Returns

Promise<Array<SeismogramDisplayData>>

▸ postQuerySeismograms(sddList)

src/irisfedcatalog.ts

query the fed cat server for dataselect using post, which allows for multiple channel-timeranges at once. This assumes that there are not multiple time ranges for the same channel as the results, encapsulated as SeismogramDisplayData objects, are returned one seismogram per channel, which may contain gaps. The original channel and timerange are also populated with each result.

postQuerySeismograms(sddList: Array<SeismogramDisplayData>): Promise<Array<SeismogramDisplayData>>

Parameters

sddList (Array<SeismogramDisplayData>) array of SeismogramDisplayData objects that will be filled in with the resulting seismogram

Returns

Promise<Array<SeismogramDisplayData>>: Promise to the input Array of SeismogramDisplayData objects, each with the seismogram containing the data returned from the server

▸ postQueryRaw(sddList, targetService)

src/irisfedcatalog.ts

postQueryRaw(sddList: Array<SeismogramDisplayData>, targetService: string): Promise<FedCatalogResult>

Parameters

sddList (Array<SeismogramDisplayData>)

targetService (string)

Returns

Promise<FedCatalogResult>

▸ postQueryRawWithBody(body)

src/irisfedcatalog.ts

postQueryRawWithBody(body: string): Promise<FedCatalogResult>

Parameters