csaxs_bec/docs/user/saxs/online_integration.md

(user.saxs.online_integration)=

Setup online radial integration on Jungfraujoch

1. Calibrate the detector using pyFAI.

   Analyze a calibration scan carefully with pyFAI and save the resulting PONI file and pixel mask. Also determine the beam center position.

   :::{note} As of 2026-06-18, Jungfraujoch only accepts uint32 TIFF mask files. If the mask generated by pyFAI is stored as uint8, it needs to be converted to the required format before uploading. To do this (from the home directory /sls/x12sa/data/[p-group]/raw/):

   • Activate the python environment: source mask/.mask/bin/activate
   • Run python convert_mask_format.py -i <input .tif file path> -o <output .tiff file path> :::

2. Update the BEC configuration.

   Update the detector distance and beam center coordinates in the BEC configuration files using the calibration results.

3. Configure Jungfraujoch.

   Open the Jungfraujoch Expert Configuration panel in the frontend interface, for example:

   http://sls-jfjoch-001:8080/frontend
   

   • Upload the pixel mask under Pixel Mask.
   • Fill in the required parameters under Azimuthal Integration Settings.
   • Make sure to enable Force CPU calculation in FPGA workflow.
   • After uploading a new configuration, do not press "initialize", as this will remove all the previously uploaded configuration.

4. Detector rotation (if required).

   :::{note} Adding rotation of the detector still needs to be documented (likely configured in the BEC configuration). :::