Receives xml messages from Earthquake Early Warning from ESE via activeMQ and the sceewlog ESE module. In order to receive xml messages from an ESE server, one needs to request appropriate access and permissions to the relevant EEW system operator.
conda create -n stomp stomp.py
conda activate stompCopy useractions-template.py to useractions.py. useractions-template.py is just an example. useractions.py is actually imported in the main client module and used for message processing.
git pull https://github.com/ATTAC-EEW-in-Central-America/ESE-client
cp ESE-client/useractions-template.py ESE-client/useractions.py./main.py -h should provide all required informations for appropriate usage, e.g.:
./main.py -H <hostname> -u <user> -p <password> -P <port> -t <topic> -c receiverYou might implement your own functionalities in response to an ESE xml alert in useractions.respond() (initially a copy of useractions-template.respond()). You might also implement response to heartbeat (sent every 5 seconds) in useractions.respond_heartbeat() (initially a copy of useractions-template.respond_heartbeat()).
Updates can be provided to this client. To get the latest version, open a terminal in the client folder and run:
git pullNo update will be provided for your
useractions.pythey will only be suggested inuseractions-template.py. Consider new features added touseractions-template.pyfor implementation in youruseractions.py.
There are two types of messages which are sent from the Earthquake Early Warning System (server side):
- Common Alerting Protocol 1.2 (CAP1.2)
- Heartbeat
The documentation about CAP1.2 says: The Common Alerting Protocol (CAP) is a simple but general format for exchanging all-hazard emergency alerts and public warnings over all kinds of networks. CAP allows a consistent warning message to be disseminated simultaneously over many different warning systems, thus increasing warning effectiveness while simplifying the warning task. In the project "Alerta Temprana de Terremotos de Centroamérica" (ATTAC) there is a dissemination system that receives the CAP1.2 XML message through ActiveMQ: this is the Digital TV Channel through an interface called eews2ewbs. One example of this XML file containing information about an earthquake, in both Spanish and English, is below:
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
<identifier>marn2023evgi</identifier>
<sender>MARN</sender>
<sent>2023-03-10T13:12:21.325421Z</sent>
<status>Actual</status>
<msgType>Alert</msgType>
<scope>Private</scope>
<info>
<language>en-US</language>
<category>Geo</category>
<event>Earthquake</event>
<urgency>Immediate</urgency>
<severity>Unknown</severity>
<certainty>Unknown</certainty>
<headline>MARN/Earthquake - Magnitude 4.8, Near Coast of Guatemala</headline>
<instruction>Drop, Cover and Hold on</instruction>
<parameter>
<valueName>magnitudeCreationTime</valueName>
<value>2023-03-10T13:12:21.325421Z</value>
</parameter>
<parameter>
<valueName>originTime</valueName>
<value>2023-03-10T13:11:36.571136Z</value>
</parameter>
<parameter>
<valueName>magnitude</valueName>
<value>4.810015202</value>
</parameter>
<parameter>
<valueName>latitude</valueName>
<value>13.86451741</value>
</parameter>
<parameter>
<valueName>longitude</valueName>
<value>-91.82912431</value>
</parameter>
<parameter>
<valueName>depth</valueName>
<value>52.77099609</value>
</parameter>
<parameter>
<valueName>status</valueName>
<value> solution</value>
</parameter>
<area>
<areaDesc>Near Coast of Guatemala</areaDesc>
</area>
</info>
<info>
<language>es-US</language>
<category>Geo</category>
<event>Sismo</event>
<urgency>Immediata</urgency>
<severity>Unknown</severity>
<certainty>Unknown</certainty>
<headline>MARN/Sismo - Magnitud 4.8, 49 km al SSE de Champerico, Guatemala</headline>
<instruction>Mantengase alejado de ventanas y objetos que puedan caer. Vaya a un lugar seguro y cubrase.</instruction>
<parameter>
<valueName>magnitudeCreationTime</valueName>
<value>2023-03-10T13:12:21.325421Z</value>
</parameter>
<parameter>
<valueName>originTime</valueName>
<value>2023-03-10T13:11:36.571136Z</value>
</parameter>
<parameter>
<valueName>magnitude</valueName>
<value>4.810015202</value>
</parameter>
<parameter>
<valueName>latitude</valueName>
<value>13.86451741</value>
</parameter>
<parameter>
<valueName>longitude</valueName>
<value>-91.82912431</value>
</parameter>
<parameter>
<valueName>depth</valueName>
<value>52.77099609</value>
</parameter>
<parameter>
<valueName>status</valueName>
<value> solution</value>
</parameter>
<area>
<areaDesc>Near Coast of Guatemala</areaDesc>
</area>
</info>
</alert>A heartbeat is sent from the server side each 5 seconds to notify the clients this is alive. It is a XML format message. An example is below:
<?xml version='1.0' encoding='UTF-8'?>
<hb originator="vssc3" sender="vssc3" xmlns="http://heartbeat.reakteu.org" timestamp="2023-03-10T20:19:02.140984Z"/>It contains the system that originates the heartbeat and the sender as well as the date and time in UTC in ISO 8601 format.