(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:

   ```text
   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).
   :::