Skip to content

GeoNet/fdsn

Repository files navigation

FDSN

Federation of Digital Seismic Networks (FDSN) Web Services (FDSN-WS) http://www.fdsn.org/webservices/

Refer to notes in cmd/*/deploy/DEPLOY.md for specific deployment requirements.

Applications

fdsn-ws

Provides FDSN web services.

Dataselect

FDSN dataselect has been implemented, querying and serving data from miniseed files off an Amazon S3 bucket.

This example uses Curl to download data from a single query to the file test.mseed:

curl "http://localhost:8080/fdsnws/dataselect/1/query?network=NZ&station=CHST&location=01&channel=LOG&starttime=2017-01-09T00:00:00&endtime=2017-01-09T23:00:00" -o test.mseed

This example uses multiple queries using POST, in this case saving to test_post.mseed:

curl -v --data-binary @post_input.txt http://localhost:8080/fdsnws/dataselect/1/query -o test_post.mseed

The contents of post_input.txt:

NZ ALRZ 10 EHN 2017-01-09T00:00:00 2017-01-09T02:00:00
NZ ALRZ 10 AC* 2017-01-02T00:00:00 2017-01-10T00:00:00
NZ ALRZ 10 B?  2017-01-09T00:00:00 2017-01-10T00:00:00

fdsn-quake-consumer

Receives notifications for SeisComPML (SC3ML) event data uploads to S3 and stores the SC3ML in the DB.

The following versions of SC3ML can be handled (there is no difference between the quake content for these versions but they are handled with separate XSLT to be consistent with upstream changes):

  • 0.7
  • 0.8
  • 0.9

The only version of QuakeML created and stored is 1.2

fdsn-holdings-consumer

Receives notifications for miniSEED file uploads to S3, indexes the files, and saves the results to the holdings DB.

Test tool

A test bash script fdsn-batch-test.sh which loads URLs from fdsn-test-urls.txt, can used to test against both FDSN and FDSN-NRT web service.

fdsn-batch-test.sh

./fdsn-batch-test.sh {optional_test_fdsn_service}

Example: ./fdsn-batch-test.sh https://test.geonet.org.nz.

When {optional_test_fdsn_service} is omitted, the script will test against https://service.geonet.org.nz and https://service-nrt.geonet.org.nz. When {optional_test_fdsn_service} is present, the script tests against that service with the same URLs defined in the txt file - note the time range will be based on NRT (20 minutes ago).

fdsn-test-urls.txt

Update fdsn-test-urls.txt to change the URLs to test.

For tests expecting http response status code other than 200, append ;;{expected_http_code} after the URL, for example:

http://service.geonet.org.nz/fdsnws/dataselect/1/query?network=NZ&sta=RBCT&channel=????&starttime=2018-05-15T23:45:00&endtime=2018-05-15T23:45:10;;204

The above ;;204 suffix makes test script to check whether the responsed http status is 204.