How to use sceewenv standalone (from the docker package)

[FMassin]

Pre-requisite

Set these up once:

1. Get docker: https://docs.docker.com/get-docker/
2. Create a personal access token in https://github.com/settings/tokens with "read packages” permission and no expiration date.
3. Login the GitHub registry, e.i.,:

   export CR_PAT=<your token>
   echo $CR_PAT | docker login ghcr.io -u <your github user name> --password-stdin

Get your container running

Every time you need to update the image:

1. Get the docker image:

   docker pull ghcr.io/sed-eew/sed-eew-seiscomp-contributions

2. Run a container on the docker host based on previous image:

   docker run -d --name sed-eew -p 9999:22 -v ~/docker-data:/home/sysop/docker-data ghcr.io/sed-eew/sed-eew-seiscomp-contributions

3. Once the container has been ran, if you just need to restart docker or the docker host: docker start sed-eew
4. Start the SeisComP message system:

   docker exec -u 0 -it sed-eew /etc/init.d/mysql start
   docker exec -u sysop -it sed-eew /opt/seiscomp/bin/seiscomp start scmaster

Data processing

The following assumes that:

• you use directory ~/docker-data/ as a exchange volume between the container and your host,
• data.mseed as the seismic data you want to process (include at least 60s of noise before the event onset),
• and metadata.fdsnxml as the related fdsnxml station metadata.

Then:

1. Copy data to container:

   cp metadata.fdsnxml  data.mseed ~/docker-data/

2. Convert metadata:

   docker exec -u sysop -it sed-eew /opt/seiscomp/bin/seiscomp exec import_inv fdsnxml docker-data/metadata.fdsnxml docker-data/metadata.xml

3. And process data (requires data packets in sorted order):

   docker exec -u sysop -it sed-eew /bin/sh -c '/opt/seiscomp/bin/seiscomp exec scmssort -E -u docker-data/data.mseed > docker-data/data.sorted.mseed'
   docker exec -u sysop -it sed-eew /bin/sh -c '/opt/seiscomp/bin/seiscomp exec sceewenv --inventory-db file://docker-data/metadata.xml -I file://docker-data/data.sorted.mseed --dump --debug > docker-data/envelope.mseed'

The output envelopes can be found in your host at ~/docker-data/envelope.mseed.

Output

The location code (2 char string before 3 char string channel code) indicates output types:

• E(A,V,D): envelope (acceleration, velocity, displacement) with (default) 1 s sample per second
• P(A,V,D): pre-processed (acceleration, velocity, displacement) data with original sampling rate

Envelope and pre-processed data from vertical channel keep their original channel code unchanged. Channel codes with orientation X (last character) relate to the Euclidian combination of both horizontal channels.

Configuration

Preprocessing include tapering. So amplitudes are not correct within the tapering window, which is 60s long by default (used at all SED testing sites), but it might be adjusted if required (e.g., triggered records). By default, there should be more than 60s of noise before the first arrival. The configuration GUI (scconfig) panel for sceewenv provides help for all parameters.