Synopsis

fdsnstation [-vV] [--help] [--includeavailability] [--includerestricted] [--matchtimeseries] [--printurl] [--raw] [--schema] [--validate] [-b=<startTime>] [--baseurl=<baseURL>] [--box=w/e/s/n] [--donut=lat/lon/min/max] [-e=<endTime>] [--endafter=<endAfter>] [--endbefore=<endBefore>] [--host=<host>] [-L=<level>] [--lat=<latitude>] [--lon=<longitude>] [--maxlat=<maxLatitude>] [--maxlon=<maxLongitude>] [--maxradius=<maxRadius>] [--minlat=<minLatitude>] [--minlon=<minLongitude>] [--minradius=<minRadius>] [--nodata=<nodata>] [-o=<outputFile>] [--port=<port>] [--startafter=<startAfter>] [--startbefore=<startBefore>] [--updatedafter=<updatedAfter>] [-c=<channel>[,<channel>…​]]…​ [-l=<location>[,<location>…​]]…​ [-n=<network>[,<network>…​]]…​ [-s=<station>[,<station>…​]]…​

Description

example client to query a remote FDSN Station web service

Times are ISO8601 formatted strings, like yyyy-MM-ddTHH:mm:ss, and may be shortened to include only the significant fields. The remaining fields will be filled in as either zero or max value depending on the use. For example 2006-11-19 or 2006-11-19T06:34:21. The special strings now and yesterday may also be used.

View source code here.

Options

-b, --start, --starttime=<startTime>

Limit to metadata epochs starting on or after the specified start time.

--baseurl=<baseURL>

Base URL for queries, ie everything before the '/<service>/<version>/<query>?'

--box=w/e/s/n

constraining box as west/east/south/north

-c, --cha, --channel=<channel>[,<channel>…​]

Select one or more SEED channel codes. Multiple codes are comma-separated.

--donut=lat/lon/min/max

constraining donut as lat/lon/minRadius/maxRadius

-e, --end, --endtime=<endTime>

Limit to metadata epochs ending on or before the specified end time.

--endafter=<endAfter>

Limit to metadata epochs ending after specified time.

--endbefore=<endBefore>

Limit to metadata epochs ending before specified time.

--help

display a help message

--host=<host>

host to connect to, defaults to service.iris.edu

--includeavailability

Specify if results should include information about time series data availability.

--includerestricted

Specify if results should include information for restricted stations.

-l, --loc, --location=<location>[,<location>…​]

Select one or more SEED location identifiers. Multiple identifiers are comma-separated. As a special case — (two dashes) will be translated to a string of two space characters to match blank location IDs.

-L, --level=<level>

Specify the level of detail for the results.

--lat, --latitude=<latitude>

Specify the latitude to be used for a radius search.

--lon, --longitude=<longitude>

Specify the longitude to the used for a radius search.

--matchtimeseries

Limit to metadata where selection criteria matches time series data availability.

--maxlat, --maxlatitude=<maxLatitude>

Limit to stations with a latitude smaller than the specified maximum.

--maxlon, --maxlongitude=<maxLongitude>

Limit to stations with a longitude smaller than the specified maximum.

--maxradius=<maxRadius>

Limit results to stations within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.

--minlat, --minlatitude=<minLatitude>

Limit to stations with a latitude larger than the specified minimum.

--minlon, --minlongitude=<minLongitude>

Limit to stations with a longitude larger than the specified minimum.

--minradius=<minRadius>

Limit results to stations within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters.

-n, --net, --network=<network>[,<network>…​]

Select one or more network codes. Can be SEED network codes or data center defined codes. Multiple codes are comma-separated.

--nodata=<nodata>

nodata http return code

-o, --output=<outputFile>

File for outputing result

--port=<port>

port to connect to, defaults to 80

--printurl

Construct and print URL and exit

--raw

Output the raw data to stdout

-s, --sta, --station=<station>[,<station>…​]

Select one or more SEED station codes. Multiple codes are comma-separated.

--schema

prints schema

--startafter=<startAfter>

Limit to metadata epochs starting after specified time.

--startbefore=<startBefore>

Limit to metadata epochs starting before specified time.

--updatedafter=<updatedAfter>

Limit to metadata updated after specified date; updates are data center specific.

-v, --verbose

Verbose

-V, --version

Print version and exit

--validate

Validate XML against schema

Examples

Ask for station from CO or N4 in a box around South Carolina that are active in 2019.

> fdsnstation --box -83/-79/31/35 --level station -n CO,N4 -b 2019 -e 2019
CO 1987-01-01T00:00:00.0000 South Carolina Seismic Network (SCSN)
    CO.BIRD 34.645/-80.4615 Birdtown, Kershaw, SC, USA 2010-08-25T00:00:00.0000
    CO.C1SC 32.798/-79.959 The Citadel,Charleston,SC 2012-10-08T19:00:00.0000
    CO.CASEE 34.993/-82.9317 Lake Jocassee, SC, USA 2009-12-07T00:00:00.0000
    CO.CSB 32.98698/-80.07155 Charleston Southern University, Charleston, SC, USA 2009-04-13T00:00:00.0000
    CO.HAW 33.3612/-81.6097 Hawthorne Fire Tower, SC, USA 2010-03-11T00:00:00.0000
    CO.HODGE 34.2315/-82.2586 Hodges, SC, USA 2010-03-25T00:00:00.0000
    CO.JSC 34.2818/-81.25966 Jenkinsville, South Carolina 2009-04-13T00:00:00.0000
    CO.PAULI 34.82097/-81.8144 Pauline, SC, USA 2011-04-26T00:00:00.0000
    CO.SUMMV 33.0658/-80.2738 Summerville Airport, SC, USA 2015-04-21T00:00:00.0000
    CO.TEEBA 32.8975/-80.1911 Mateeba, Summerville SC 2018-04-25T00:00:00.0000
N4 2013-01-01T00:00:00.0000 Central and Eastern US Network (CEUSN)
    N4.257A 31.9746/-81.0261 Skidaway Island, Savannah, GA, USA 2014-01-21T00:00:00.0000
    N4.X58A 34.5548/-79.3388 Rowland, NC, USA 2013-02-01T00:00:00.0000
    N4.Y57A 34.017/-80.3915 Sumter, SC, USA 2013-02-01T00:00:00.0000
    N4.Y58A 33.9057/-79.6665 Scranton, SC, USA 2013-02-01T00:00:00.0000