The qml2hypo71phs.py code is included into the present docker.
The docker is used to parse a full QuakeML (xml) file containing information on hypocenter and related arrival times picks, and convert all to hypo71 phase input file.
Beyond column 78 (^) of the output file, additional information are included on each phase line about station, network and event.
The following line is taken from the example output:
VOBA P 0Z210203152652.99 55.00 S 1 40.85 HNZIV-- EVID:26031941,ORID:86811231,V:100
^
channel: 79-81
network: 82-83
location: 84-85
eventid,originid,originversion: 90-> free format comma separated list. These information allow to interact back with the QuakeML file.
The source code has a specific usage to which the docker has its simplified interface, so the user does not need to know it.
Anyway, only for information completeness here it is:
usage: qml2hypo71phs.py [-h] [--qmlin QMLIN] [--eventid EVENTID] [--version VERSION] [--conf CONF] [--agency AGENCY]
optional arguments:
-h, --help show this help message and exit
--qmlin QMLIN Full path to qml event file
--eventid EVENTID INGV event id
--version VERSION Agency coding origin version type (default: preferred) preferred,all, or an integer for known version
numbers
--conf CONF needed with --eventid agency webservices routes list type (default: ./ws_agency_route.conf)
--agency AGENCY needed with --eventid agency to query for (see routes list in .conf file) type (default: ingv)
To obtain qml2hypo71phs docker image, you have two options:
Get the last built image from DockerHub repository:
$ docker pull ingv/qml2hypo71phs
First, clone the git repository
$ git clone https://github.com/INGV/qml2hypo71phs.git
$ cd qml2hypo71phs
$ docker build --tag ingv/qml2hypo71phs .
in case of errors, try:
$ docker build --no-cache --pull --tag ingv/qml2hypo71phs .
To run the container, use the command below; the -v
option is used to "mount" working directory into container:
$ docker run --rm --user $(id -u):$(id -g) -v $(pwd)/example:/opt/input ingv/qml2hypo71phs
example:
$ docker run --rm --user $(id -u):$(id -g) -v $(pwd)/example:/opt/input ingv/qml2hypo71phs --qmlin /opt/input/quakeml.xml
To override the ENTRYPOINT
directive and enter into the Docker container, run:
$ docker run --rm -it --user $(id -u):$(id -g) --entrypoint=bash qml2hypo71phs
Get last Docker image from DockerHub repository:
$ docker pull ingv/qml2hypo71phs
Thanks to your contributions!
Here is a list of users who already contributed to this repository:
(c) 2021 Raffaele Distefano raffaele.distefano[at]ingv.it
(c) 2021 Valentino Lauciani valentino.lauciani[at]ingv.it
Istituto Nazionale di Geofisica e Vulcanologia, Italia