HDF5 to XDI at BM08
===================

Usage
-----

The automatic XDI conversion workflows can be configured through the *xdi_converter* object in the Bliss session

.. code-block:: python

    DEMO_SESSION [4]: xdi_converter
            Out [4]: 
                    Workflows:
                    trigger_at   'END'                                                                                             
                    workflow     '/tmp/demo_resources9gh6nnmd/inhouse/id002511/id00/20251101/SCRIPTS/workflows/xdi_convert.json'   
                    
                    Parameters:
                    mono_counter             'roby'                 Monochromator energy or theta counter name.             
                    crystal_motor            'sy'                   Motor that selects the monochromator crystal.           
                    optional_counters        ['diode1', 'diode2']   Other counter name to be saved in XDI.                  
                    optional_mca_counters    ['OdaRoi']             MCA counter names like ROI names to be saved in XDI.    
                    livetime_normalization   -1                     Live-time normalization in seconds for the MCA counters.
                                                                        None: no normalization                                 
                                                                        `<=0` the median of the elapsed per point              
                    
                    Data access:
                    retry_timeout   15   Timeout for HDF5 reading.
                                            None: wait forever      
                    
                    Calibration:
                    mono_edge_theoretical    None   The theoretical edge position in 'mono_counter' units. 
                    mono_edge_experimental   None   The experimental edge position in 'mono_counter' units.
                    
                    Status:
                    Enabled   False   

Features are:

- XAS energy values from an energy or theta counter.
- Save XDI files with regular and MCA Bliss counters.
- Save XDI files with metadata on the monochromator.
- Support monochromator energy calibration.
- Support live-time correction of MCA counters.
- Upload results to the Data Portal, including the workflows that produced them.

Installation
------------

Dependencies to be installed on the worker side:

.. code-block:: bash

    pip install ewoksbm08