.. _tutorials_processing:

******************************
Configure real-time processing
******************************

You will enable processing by your existing local SeisComP system.


:Pre-requisites for this tutorial:

  * Real-time data for the station must be available locally.
    See :ref:`tutorials_waveforms` or :ref:`tutorials_geofon_waveforms`.
  * Inventory must be loaded locally.

:Afterwards/Results/Outcomes:

   The new station is used for automatic real-time data processing.

:Time range estimate:

  10 minutes.

:Related tutorial(s):

  :ref:`tutorials_addstation`

-----------


Create bindings
===============

In SeisComP terminology, *bindings* are the connection between modules
and individual stations.
See the "Bindings" section of :ref:`concepts_configuration` for full details.

You can create the necessary bindings for your new station
using :program:`scconfig`.
Go to the "Bindings" tab on the left side bar of :program:`scconfig`.

* You will need to add  "global" and "scautopick" bindings.

  * Create a global profile named "BH" by clicking with the right button on "global"
    in the top right panel. Double click on it and set BH as *detectStream* and
    empty location code as *detecLocID* information.
    Adjust these as appropriate for your station.

  * Create a *scautopick* profile named "default" (no changes necessary).

  * Drag and drop all profiles from the right side to the network icon on the
    left side (you may do that also at the station level).

  * Press Ctrl+S to save the configuration.
    This writes configuration files in :file:`~/seiscomp/etc/key`.

* Alternatively, you can add the scautopick and global bindings
  by editing the relevant top-level key file.
  (For station CLL of the GR network, this would be :file:`etc/key/station_GR_CLL`.)
  It would contain:

  .. code::

      # Binding references
      global
      scautopick:default

  in addition to any other bindings that might be defined for this station.

Then:

.. code-block:: sh

   $ seiscomp update-config
   $ seiscomp restart scautopick


Check the station is used for processing
========================================

If you have correctly configured the station for processing, then:

* On restarting :program:`scautopick`, the station appears in the
  :file:`scautopick.log` log
  file in :file:`~/.seiscomp/log`::

    2020/03/01 18:01:00 [info/Autopick] Adding detection channel GR.CLL..BHZ

  After some time, a nearby event will occur and the station should then be picked.
  This should appear in the latest :file:`autoloc-picklog` file in
  :file:`~/.seiscomp/log`:

  .. code-block:: sh

     $ grep "CLL" .seiscomp/log/autoloc-picklog.2020-03-01
     2020-03-01 18:31:47.1 GR CLL    BHZ __   40.9    177.433  1.1 A 20200301.183147.13-AIC-GR.CLL..BHZ


* The station should now appear in the GUIs.
  After restarting them,

  - The station should now show up in :program:`scmv`
    (as a new triangle at the expected location on the map,
    which is not black if the station is active).

  - In :program:`scrttv` a trace should be visible.

  - In :program:`scolv`, the new station is either already included
    in automatic locations, or can be added manually.

In case of problems, check that :confval:`detecStream` and
:confval:`detecLocid` are set correctly.
They must match both what is in inventory and the waveforms provided
from the upstream server.