Connecting clients

Clients connect to OWS like to any Winston Wave Server: the address of the computer OWS runs on, and port 16032 (or your LISTEN_PORT). Stations, channels and times are the ones in your SeedLink server and archive.

Swarm

  1. In Swarm’s data source list, add a new data source.

  2. Choose the type Winston Wave Server.

  3. Enter the OWS computer’s address and port 16032, and a name of your choice.

  4. Open the new data source: it lists your stations and channels. Open a channel’s helicorder or wave view.

The helicorder and wave views show live data (from SeedLink) and history (from the archive) together. Swarm also works with the type Earthworm Wave Server on the same address and port; Winston is recommended.

Earthworm

OWS answers the Earthworm wave server commands (MENU, GETSCNLRAW), so Earthworm programs that read from a wave server can use it. To list the channels:

getmenu ows-computer:16032

For Earthworm users, OWS replaces a Winston Wave Server; point your clients at OWS’s address and port instead.

ObsPy

Use ObsPy’s Earthworm client:

from obspy import UTCDateTime
from obspy.clients.earthworm import Client

client = Client("ows-computer", 16032, timeout=20)

# every channel: (network, station, location, channel, start, end)
for channel in client.get_availability():
    print(channel)

# ten minutes of data from one hour ago
t = UTCDateTime() - 3600
st = client.get_waveforms("AM", "R0CA2", "00", "EHZ", t, t + 600)
print(st)
st.plot()

Replace ows-computer with the OWS computer’s address and the codes with one of your channels. For channels without a location code, use "".

Other clients

Any client of the Winston Wave Server protocol can use OWS, as far as it uses the commands OWS supports (Protocol reference).