The portable-fdsnws-dataselect user guide

  1. Overview
  2. Installing the server
  3. Running the server
  4. Preparing your data for use with server

Overview

The portable-fdsnws-dataselect server is an implementation of the International FDSN’s fdsnws-dataselect web service specification. In a nutshell, this server can be used to provide access to a repository of miniSEED formatted data using a standardized web service.

The server requires a data index, as created by mseedindex to serve data from a repository.

Installing the server

Requirements: Python 3.9 or higher.

Install from PyPI using pip:

pip install portable-fdsnws-dataselect

To upgrade to a future release:

pip install -U portable-fdsnws-dataselect

Running the server

First create a server configuration file. The portable-fdsnws-dataselect command will print an example configuration file if the -s option is specified. To get started:

portable-fdsnws-dataselect -s > server.ini

Next edit the server.ini file, changing values to match your configuration, in particular:

  • The path option in the [index_db] section must point to your SQLite database file
  • The datapath_replace option in the same section might be needed to modify the data file paths if the index table in the database does not match the actual data path.

Finally, run the server specifying the config file:

portable-fdsnws-dataselect server.ini

You should then be able to see the service interface documentation using a web browser with an address like http://ServerHost:ServerPort/, e.g. http://localhost:8080/.

Make sure to look into the server log file (specified in the config file) for errors if things are not working as expected.

Preparing your data for use with server

Use the program mseedindex to create a SQLite database containing an index of the miniSEED data you wish to make available through your server. Instructions are available in the Wiki for mseedindex.

This software is a product of the EarthScope Data Services

The source code repository is here: https://github.com/earthscope/portable-fdsnws-dataselect