Siria -  *Source Inversion and Rapid Impact Assessment*
=======================================================

Siria is an open source toolbox and library shipping fast moment tensor and
extended rupture estimation methods. It is written in Python language and
provides methods to invert for seismic sources in automatized processes. Siria
provides also functions to assess and use databases of active faults and
historical seismicity with the focus on the Mediterranean region.

.. raw:: html

   <div style="clear:both"></div>

   <hr class="solid"> 

The EWRICA project
------------------

Siria was developed within the scope of the project *Early-Warning and Rapid
Impact Assessment with real-time GNSS in the Mediterranean* (EWRICA). It was
funded by the federal Ministry of Education and Research. The overarching goal
was to develop fast kinematic and point source inversion and modeling tools
combining GNSS-based near field data with traditional broadband ground velocity
and accelerometer data.

Through EWRICA, different institutions have been involved in the development of
the Siria package:

.. raw:: html

   <div style="clear:both; width:100%; text-align:center; margin-top:3em; margin-bottom:2em;">
      <a href="https://www.bmbf.de/"><img style="margin-left:1em; height:4em; display:inline-block;" src="_static/logos/bmbf.png" /></a>
      <a href="https://www.uni-potsdam.de/en/geo"><img style="margin-left:1em; height:4em; display:inline-block;" src="_static/logos/UP.jpg" /></a>
      <a href="https://www.gfz-potsdam.de/">
            <img style="margin-left:1em; height:4em; display:inline-block;" src="_static/logos/GFZ.png" />
      </a>
   </div>

   <hr class="solid"> 


Useful links
------------

.. raw:: html

   <div class="icon-button-group" style="margin-bottom:2em">
      <a href="install/index.html" class="icon-button">
         <i class="fa fa-download" aria-hidden="true"></i><br />
         Download and installation
      </a>
      <a href="https://git.pyrocko.org/wanderelch/siria" class="icon-button">
         <i class="fa fa-code" aria-hidden="true"></i><br />
         Git code repository
      </a>
      <a href="library/index.html#examples" class="icon-button">
         <i class="fa fa-graduation-cap" aria-hidden="true"></i><br />
         Reference and examples
      </a>
   </div>

   <hr class="solid"> 


The Source Inversion Demonstrator
---------------------------------

The goal of the Siria package is providing a common and configurable platform
for the application of different source inversion techniques implemented into
different software packages. Siria provides a wrapper for these software, as
well as loading utilities for a priori informations like fault databases. The
latter could be used to pre-constraint inversion parameter search spaces.

The :py:class:`siria.si.demonstrator.SourceInversionDemonstrator` provides the
option to invert for different seismic source models based on a priori
information, and preliminary earthquake parameters (as shown in the image
below.)

.. figure :: /static/method/fast_estimate_essentials.png
    :align: center
    :width: 95 %
    :alt: Flowchart of demonstrator workflow.

    Flowchart illustrating the workflow when using the
    :py:class:`~siria.si.demonstrator.SourceInversionDemonstrator` in a case of
    fast seismic source inversion.


Details on the provided a priori databases are given in
:py:mod:`siria.dataset`. The wrapping of the IDS (Iterative Deconvolution and
Stacking) code is explained in detail in the `applications section of IDS
<apps/ids/index.html>`_. The wrapping of the Bayesian Bootstrap-based
optimization tool Grond is described in :py:mod:`siria.si.invert`.

The :py:class:`~siria.si.demonstrator.SourceInversionDemonstrator` itself and
the different required configuration options are documented in
:py:class:`siria.si.demonstrator` and in `the demonstrator topic
<topics/demonstrator/index.html>`_ along with example configuration files.

A beta version utilising the demonstrator for fast, prior driven source
inversions is provided on `git.gfz-potsdam.de/ewrica
<https://git.gfz-potsdam.de/ewrica/readme>`_ [Zaccarelli2023]_ and currently
tested on two playback events:

* the M\ :sub:`w` 6.5 2016 Norcia, Italy, earthquake (https://geofon.gfz-potsdam.de/ewrica-playback),
* the M\ :sub:`w` 7.0 2020 Samos, Greece, earthquake (https://geofon.gfz-potsdam.de/ewrica-playback-samos).

.. [Zaccarelli2023] Zaccarelli, Riccardo; Metz, Malte; Lehman, Lukas; Heinloo,
    Andres (2023): EWRICA - Docker container for Early-Warning and Rapid Impact
    Assessment with real-time GNSS data. GFZ Data Services.
    https://doi.org/10.5880/GFZ.2.6.2023.003