.. highlight:: rst

.. _sceewdump:

#########
sceewdump
#########

**Dumps EEW parameters from a given event ID or file.**


Description
===========

*sceewdump* is released under the GNU Affero General Public License (Free
Software Foundation, version 3 or later). It dumps EEW parameters from a given 
event ID or file.

.. note::

 *sceewdump* is a utility of :ref:`sceewlog` and intends to follow the same logic 
 while selecting preferred EEW solutions. However, the preference order for authors 
 is the only criterion currently implemented.

Example (setup databse parameter in :file:`sceewdump.cfg`):

.. code-block:: sh

 sceewdump -E smi:ch.ethz.sed/sc20d/Event/2022njvrzz  \
           -i ~/playback/2022njvrzz.xml \
           --xsl $SEISCOMP_ROOT/share/sceewlog/sc3ml_0.12__quakeml_1.2-RT_eewd.xsl \
           -a scvs,scfdfo



Configuration
=============

| :file:`etc/defaults/global.cfg`
| :file:`etc/defaults/sceewdump.cfg`
| :file:`etc/global.cfg`
| :file:`etc/sceewdump.cfg`
| :file:`~/.seiscomp/global.cfg`
| :file:`~/.seiscomp/sceewdump.cfg`

sceewdump inherits `global options <https://docs.gempa.de/seiscomp/current/apps/global.html>`_.




Command Line
============


Generic
-------


Verbosity
---------


Messaging
---------


Input
-----

.. option:: -a, --authors authors

   Author preferrence order \(e.g., \"scvs,scfinder\" ;
   last is preferred\).

.. option:: -x, --xsl

   Convert using xsl.

.. option:: -i, --input path

   Read event from XML file instead of database. Use \"\-\"
   to read from stdin.

.. option:: -f, --format format

   Input format to use \(xml [default], zxml \(zipped xml\),
   binary\). Only relevant with \"\-\-input\".


Dump
----

.. option:: -E, --event eventid

   Event id.

