.. highlight:: rst

.. _scesv:

#####
scesv
#####

**Event summary view.**


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

scesv is the summary display of the event parameters. It shows the primary information
about the current event including location, time, strength, type and processing status.
Additional to the current event older events can also be chosen from the eventlist in the
events tab.

The two tabs of scesv are

* Events tab showing the list of loaded events, compare Fig. :ref:`fig-events`
* Summary tab with the details of the selected event, see Fig. :ref:`fig-summary`.


.. _scesv-events-tab:

Events Tab
==========

The Events tab shows the eventlist of the time span defined on the bottom side of
the window. A the Events tab is also available for other GUIs, such as :ref:`scolv`
it can be configured in the global module configuration.
The :ref:`description of the Events tab in scolv <scolv-events-tab>` provides more
details.

.. _fig-events:

.. figure:: media/scesv/scesv-events.png
   :width: 16cm
   :align: center

   Eventlist tab

   Tab1-2: Summary/Events tab, EventList: list of the last events with summarized information,
   List options: Show fake events, Reading 1: spinbox to limit timespan of displayed events (in days),
   Reading 2: spinboxes to limit timespan of displayed events (specified dates), Status: connection status

.. note::

   As for :ref:`scolv` filtering of the event list and custom information can be
   added to the event list by configuration. Read the scolv documentation on
   :ref:`event filtering <scolv-events-filtering>` and :ref:`custom action <scolv-custom-actions>`
   for the details.


.. _scesv-summary-tab:

Summary Tab
===========

The most recent (default) or the event selected from the event list is shown in
the Summary tab, see Fig. :ref:`fig-summary`.
Here the information are highlighted in four sections:

====================  =====================================================
section               description
====================  =====================================================
Time                  Orign time in UTC and relative to now
Region                A map of the region and location with the event and stations
Magnitude             Different magnitude types, the values and counts
Hypocenter            Origin information with location, depth, azimuthal gap etc.
====================  =====================================================

.. _fig-summary:

.. figure:: media/scesv/scesv-summary.png
   :width: 16cm
   :align: center

   Summary tab

   Tab1-2: Summary/Events tab, Origin Time: origin time in UTC and relative to now, Map: map with region
   and location and stations, Magnitude: different magnitude types with values and counts,
   Origin Info: hypocenter information with position, phase count and azimuthal gap,
   Event: earthquake location, Station: station with ray-path, Details: "Show Details" button to open
   detailed information in :ref:`scolv`, Event Type: event type combo box to set event type, Status: connection status


Hotkeys
=======

=================  =======================================
Hotkey             Description
=================  =======================================
:kbd:`F1`          Open |scname| documentation
Shift + :kbd:`F1`  Open scesv documentation
:kbd:`F2`          Setup connection dialog
:kbd:`F6`          Show propagation of P and S wave
:kbd:`F7`          Show focal mechanism by beach ball
Shift + :kbd:`F7`  Show focal mechanism by beach ball
:kbd:`F8`          Toggle auto update
:kbd:`F9`          Show raypaths and associated stations
:kbd:`F10`         Toggle tabs
:kbd:`F11`         Toggle fullscreen
Mouse wheel        Zoom map in/out
Double click       Center map
=================  =======================================


.. _scesv_configuration:

Module Configuration
====================

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

scesv inherits :ref:`global options<global-configuration>`.



.. confval:: loadEventDB

   Default: ``1``

   Type: *double*

   Unit: *days*

   Number of days before current time to preload events from
   database when starting scesv.


.. confval:: showLastAutomaticSolution

   Default: ``false``

   Type: *boolean*

   If enabled, the last automatic solution is displayed next to the
   current solution in the summary panel. If the last automatic
   solution differs from the current solution it is displayed
   in red. If both solutions match it is displayed in gray.


.. confval:: showOnlyMostRecentEvent

   Default: ``true``

   Type: *boolean*

   If enabled, only the most recent event is shown even if an update of
   an older event is being received.


.. confval:: recenterMap

   Default: ``true``

   Type: *boolean*

   If enabled, the map is centered around the most recent event event.


.. confval:: enableFixAutomaticSolutions

   Default: ``false``

   Type: *boolean*

   If enabled, an additional button is displayed which allows to
   switch back the latest automatic solution. This button triggers
   an command for scevent to prioritize automatic solutions until
   the next manual solution is available.


.. confval:: visibleMagnitudes

   Default: ``M,MLv,mb,mB,Mw(mB)``

   Type: *list:string*

   A list of magnitude types to be displayed.


.. confval:: button0

   Type: *string*

   Label of button0 which triggers script0.


.. confval:: button1

   Type: *string*

   Label of button1 which triggers script1.


.. confval:: ignoreOtherEvents

   Default: ``true``

   Type: *boolean*

   If the event type is either \"other\" or
   \"not existing\" and this flag is true then the
   event will not be shown.


.. confval:: scripts.script0

   Type: *file*

   Path to a script executed when button0 is clicked.


.. confval:: scripts.script1

   Type: *file*

   Path to a script executed when button1 is clicked.


.. confval:: scripts.script0.exportMap

   Default: ``false``

   Type: *boolean*

   If enabled, the current map is exported to file.
   The filename is appended to the parameter list of script0.
   The script has to take ownership of the file.


.. confval:: scripts.script0.oldStyle

   Default: ``true``

   Type: *boolean*

   If enabled, the parameter list of script0 is event ID,
   arrival count, magnitude, description.
   
   If disabled, the parameter list of script0 is event ID,
   preferredOriginID, preferredMagnitudeID,
   preferredFocalMechanismID.


.. confval:: scripts.script1.exportMap

   Default: ``false``

   Type: *boolean*

   If enabled, the current map is exported to file.
   The filename is appended to the parameter list of script1.
   The script has to take ownership of the file.


.. confval:: scripts.script1.oldStyle

   Default: ``true``

   Type: *boolean*

   If enabled, the parameter list of script1 is event ID,
   arrivalCount, magnitude, description.
   
   If disabled, the parameter list of script1 is event ID,
   preferredOriginID, preferredMagnitudeID,
   preferredFocalMechanismID.


.. confval:: summary.borders

   Default: ``false``

   Type: *boolean*

   Draw borders in the summary panel.


.. note::
   **display.\***
   *Adjust content or display custom information in the Summary tab.*



.. confval:: display.lonmin

   Default: ``-180``

   Type: *double*

   Unit: *deg*

   Minimum longitude of initially displayed map region.


.. confval:: display.lonmax

   Default: ``180``

   Type: *double*

   Unit: *deg*

   Maximum longitude of initially displayed map region.


.. confval:: display.latmin

   Default: ``-90``

   Type: *double*

   Unit: *deg*

   Minimum latitude of initially displayed map region.


.. confval:: display.latmax

   Default: ``90``

   Type: *double*

   Unit: *deg*

   Maximum latitude of initially displayed map region.


.. note::
   **display.event.\***
   *Event information*



.. confval:: display.event.comment.id

   Type: *string*

   ID of the event comment to be considered.


.. confval:: display.event.comment.default

   Type: *string*

   Value to be shown in case no valid event comment is
   found.


.. confval:: display.event.comment.label

   Type: *string*

   Label of the value to be shown.


.. note::
   **display.origin.\***
   *Origin information*



.. note::
   **display.origin.comment.\***
   *Display origin comments.*



.. confval:: display.origin.comment.id

   Type: *string*

   ID of the origin comment to be considered.


.. confval:: display.origin.comment.default

   Type: *string*

   Value to be shown in case no valid origin comment is
   found.


.. confval:: display.origin.comment.label

   Type: *string*

   Label of the value to be shown.


.. note::
   **poi.\***
   *Display information related to a point of interest (POI)*
   *read from the cities XML file.*



.. confval:: poi.maxDist

   Default: ``20``

   Type: *double*

   Unit: *deg*

   Maximum distance in degrees of a POI to be taken into account.


.. confval:: poi.minPopulation

   Type: *double*

   The minimum population of a POI to be taken into account.


.. confval:: poi.message

   Type: *string*

   Message conversion string that converts a POI into the text
   displayed under the region label. There are different
   placeholders that can be used: \@dist\@, \@dir\@, \@poi\@ and \@region\@.



Command-Line Options
====================

.. program:: scesv

:program:`scesv [options]`


Generic
-------

.. option:: -h, --help

   Show help message.

.. option:: -V, --version

   Show version information.

.. option:: --config-file file

   The alternative module configuration file. When this option
   is used, the module configuration is only read from the
   given file and no other configuration stage is considered.
   Therefore, all configuration including the definition of
   plugins must be contained in that file or given along with
   other command\-line options such as \-\-plugins.

.. option:: --plugins arg

   Load given plugins.

.. option:: --auto-shutdown arg

   Enable\/disable self\-shutdown because a master module shutdown.
   This only works when messaging is enabled and the master
   module sends a shutdown message \(enabled with
   \-\-start\-stop\-msg for the master module\).

.. option:: --shutdown-master-module arg

   Set the name of the master\-module used for auto\-shutdown.
   This is the application name of the module actually
   started. If symlinks are used, then it is the name of
   the symlinked application.

.. option:: --shutdown-master-username arg

   Set the name of the master\-username of the messaging
   used for auto\-shutdown. If \"shutdown\-master\-module\" is
   given as well, this parameter is ignored.


Verbosity
---------

.. option:: --verbosity arg

   Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
   4:debug.

.. option:: -v, --v

   Increase verbosity level \(may be repeated, e.g., \-vv\).

.. option:: -q, --quiet

   Quiet mode: no logging output.

.. option:: --component arg

   Limit the logging to a certain component. This option can
   be given more than once.

.. option:: -s, --syslog

   Use syslog logging backend. The output usually goes to
   \/var\/lib\/messages.

.. option:: -l, --lockfile arg

   Path to lock file.

.. option:: --console arg

   Send log output to stdout.

.. option:: --debug

   Execute in debug mode.
   Equivalent to \-\-verbosity\=4 \-\-console\=1 .

.. option:: --log-file arg

   Use alternative log file.

.. option:: --print-component arg

   For each log entry print the component right after the
   log level. By default the component output is enabled
   for file output but disabled for console output.

.. option:: --trace

   Execute in trace mode.
   Equivalent to \-\-verbosity\=4 \-\-console\=1 \-\-print\-component\=1
   \-\-print\-context\=1 .


Messaging
---------

.. option:: -u, --user arg

   Overrides configuration parameter :confval:`connection.username`.


.. option:: -H, --host arg

   Overrides configuration parameter :confval:`connection.server`.


.. option:: -t, --timeout arg

   Overrides configuration parameter :confval:`connection.timeout`.


.. option:: -g, --primary-group arg

   Overrides configuration parameter :confval:`connection.primaryGroup`.


.. option:: -S, --subscribe-group arg

   A group to subscribe to.
   This option can be given more than once.

.. option:: --content-type arg

   Overrides configuration parameter :confval:`connection.contentType`.

   Default: ``binary``


.. option:: --start-stop-msg arg

   Default: ``0``

   Set sending of a start and a stop message.


Database
--------

.. option:: --db-driver-list

   List all supported database drivers.

.. option:: -d, --database arg

   The database connection string, format:
   service:\/\/user:pwd\@host\/database.
   \"service\" is the name of the database driver which
   can be queried with \"\-\-db\-driver\-list\".

.. option:: --config-module arg

   The config module to use.

.. option:: --inventory-db arg

   Load the inventory from the given database or file, format:
   [service:\/\/]location .

.. option:: --db-disable

   Do not use the database at all


Records
-------

.. option:: --record-driver-list

   List all supported record stream drivers.

.. option:: -I, --record-url arg

   The RecordStream source URL. Format:
   [service:\/\/]location[#type].
   \"service\" is the name of the RecordStream driver
   which can be queried with \"\-\-record\-driver\-list\".
   If \"service\" is not given, \"file:\/\/\" is
   used and simply the name of a miniSEED file can be given.

.. option:: --record-file arg

   Specify a file as record source.

.. option:: --record-type arg

   Specify a type for the records being read.


Cities
------

.. option:: --city-xml arg

   Type: *file*

   Values: ``*.xml``

   The path to the cities XML file. This overrides the default
   paths. Compare with the global parameter \"citiesXML\".


User interface
--------------

.. option:: -F, --full-screen

   Start the application filling the entire screen.
   This only works with GUI applications.

.. option:: -N, --non-interactive

   Use non\-interactive presentation mode. This only works with
   GUI applications.


Options
-------

.. option:: --script0 arg

   Path to the executable script called when configurable
   button0 is pressed; EventID, arrival count, magnitude and
   the additional location information string are passed as
   parameters \$1, \$2, \$3 and \$4, respectively.

.. option:: --script1 arg

   Path to the executable script called when configurable
   button1 is pressed; EventID, arrival count, magnitude and
   the additional location information string are passed as
   parameters \$1, \$2, \$3 and \$4, respectively.

.. option:: --load-event-db arg

   Number of days to load from database.

