.. _toast_importing_creating:

Import events and create incidents in |toast|
=============================================

There are various ways for creating or loading an
:term:`incident <Incident>` or :term:`event <Event>` in |toast|:

* |scname| events are received via an active messaging connection and new
  incidents are created automatically, see: :ref:`toast_receive_events`.
* Events are imported manually by user interaction, see: :ref:`toast_import_event_manually`.
* The user creates an incident manually, see: :ref:`toast_artificial_incident`.
* The user creates an event manually, see: :ref:`toast_artificial_event`.
* Incidents are loaded from the |toast| database, see: :ref:`toast_import_incidents`.

See also: :ref:`toast_simulations` on how to add simulations to an :term:`incident <Incident>`.


.. _toast_receive_events:

Receive events automatically via messaging
------------------------------------------

.. TODO::
  Done by toastd now. Update accordingly.
  Confvals not availiable in |toastg| anymore but in trigger of |toastd| queue.

If a connection to a |scname| system is configured, new events (and event
updates) are received via messaging and incidents can be created automatically.
This is the case if the magnitude of the event is larger than
:confval:`incidentMinimumMagnitude`
and if the depth is shallower than
:confval:`incidentMaximumDepth`.
See also: :ref:`toast_sim_automatic`.


.. _toast_import_event_manually:

Import event from a |scname| database manually
----------------------------------------------

To import an event from a |scname| database and create an :term:`incident <Incident>`,
use :menuselection:`Menu --> File --> Import --> From SeisComP` or press *F4*.
Load events by choosing appropriate time span settings and clicking the refresh button.
Filter the list using the *funnel* icon. Double click an event to create an
incident which then is displayed in |toast|.

.. _fig-import_event:

.. figure:: media/toast/gui/import_event.png
   :align: center
   :width: 16 cm

   Import an event from a |scname| database

To trigger simulations for the new incident, press *CTRL+N*.
See also :ref:`toast_sim_manual`.


.. _toast_artificial_incident:

Create artificial incident
--------------------------

An :term:`incident <Incident>` can also be created manually, for example for
testing or in case a specific earthquake isn't available in the connected
|scname| database.
In case of manual incident creation, there is no event associated with
the incident.

Click the middle mouse button or use the context menu (right button) in the
:ref:`toast_map_perspective` and then
:menuselection:`Create artificial incident`.
Adapt the properties of the incident in the dialog and click *Ok*.
Note that some properties have an explaining tooltip when hovering over the
input field.
The new incident appears on the map and in the :ref:`toast_database_panel`.

.. _fig-artificial_incident:

.. figure:: media/toast/gui/artificial_incident.png
   :align: center
   :width: 9 cm

   Artificial incident dialog

Incident properties like latitude or magnitude can be modified after incident
creation. To do so, select an incident and then:
:menuselection:`Menu --> Extras --> Edit incident source...`
or use the context menu (mouse right-click) in the database panel in incident mode.

For more information on *Severity*, see: :ref:`toast_severity`.


.. _toast_artificial_event:

Create artificial events
------------------------

For some use cases it is useful to be able to create not just a
|toast| incident, but also a |scname| event.
One example would be testing the whole bulletin creation and dissemination
toolchain, including the bulletins which are triggered by the event.

This feature can be activated by configuring in the :ref:`toast_client_summ`
:confval:`eventCreation.enable = True`.

Click the right mouse button in the :ref:`toast_map_perspective` and then
:menuselection:`--> Create artificial SC event`.

.. _fig-artificial_event:

.. figure:: media/toast/gui/artificial_event.png
   :align: center
   :width: 9 cm

   Artificial event dialog

The event is sent to the |scname| messaging queue which is configured
at the :ref:`toast_server_summ` at :confval:`...toastd.source`.
If the event matches the incident creation criteria, an incident is
also created automatically.


.. _toast_import_incidents:

Load incidents from |toast| database
------------------------------------

In order to load :term:`incidents <Incident>` from the |toast| database,
click the settings-icon in the :ref:`toast_database_panel`, specify a time span
either by dates or by *Last days* and hit the corresponding refresh button.

Using: :program:`scconfig`
:menuselection:`--> Modules --> gempa --> toast --> toast --> tsunami --> database`
you can set :confval:`tsunami.database.loadLastDays` to automatically load
incidents after starting |toast|.