Online analysis
===============

hRIXS
~~~~~

The hRIXS online analysis uses EXtra-Metro and can be found in the `SCS_METRO_HRIXS` project.
Various tools for centroiding, averaging spectra, scanning, are available.

.. image:: images/hrixs_online.png
   :width: 600


Troobleshooting
+++++++++++++++


Instructions to recover hRIXS online analysis from device server crashes (August 2024):

https://mylog.connect.xfel.eu/#narrow/stream/196-SCS_900464_AndreasScherz/topic/Instructions/near/62817 

XAS
~~~

The XAS processor is a Karabo device that can be found in the `SCS_DATA_ANALYSIS` project.

.. image:: images/xas_online.png
   :width: 600


DSSC
~~~~

The DSSC analysis with zone plate (BOZ) uses EXtra-Metro.
** To be updated **

XOX
~~~

The online analysis for XOX using Gotthard devices can be found in the `SCS_DATA_ANALYSIS` project.
There is a scene for timeline visualization and one for scanning delay.

.. image:: images/Gotthard_online.png
   :width: 600


Checking run files validity
~~~~~~~~~~~~~~~~~~~~~~~~~~~

To quickly check that the recorded run have data in them, you can `ssh` to the
server and use `hdfview` to inspect the saved file:

  .. code-block:: console

    ssh -X desyusername@exflonc13
    module load xray
    cd /gpfs/exfel/exp/SCS/201831/p900048/raw
    hdfview r0029/RAW-R0029-DA03-S00000.h5 &

Online analysis with jupyter
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

On `exflonc13`, port 8088, there is a jupyter notebook server which is running
and accessible with password *scs-jupyter*. Open a browser to `exflonc13`_ to
see it. Based on `elog_722`_.

.. _exflonc13: http://exflonc13:8088
.. _elog_722: https://in.xfel.eu/elog/SCS+Beamline/722


Extra-foam for DSSC
~~~~~~~~~~~~~~~~~~~

Instructions to start extra-foam for DSSC online monitoring, based on `elog 3291 <https://in.xfel.eu/elog/SCS+Instrument/3291>`_:

1. open a terminal: ssh wp86team@sa3-onc-scs
2. module load exfel EXtra-foam/scs_moonshot
3. extra-foam DSSC SCS, wait several seconds for the gui to appear
4. in the first row, second column, double click and select "Run directory" instead of "ZeroMQ bridge"

.. image:: images/extra-foam-gui.png
   :width: 600

5. select DSSC source SCS_DET_DSSC1M/DET/\*CH0:xtdf to see the whole detector
6. go to karabo, open the project: SCS_DATA_ANALYSIS
7. go to device SCS_DET_DSSC/DA/TRAINMATCHER, press start/stop to enable/disable the train matcher

.. image:: images/train-matcher-device.png
   :width: 600