[Jungfrau][Correct][Dark] New Settings and gain mode enums to read the jungfrau correct parameters.

This MR is corresponding to this issue https://git.xfel.eu/calibration/planning/-/issues/143

Description

As there's a new software version for Jungfrau. These are needed changes to differentiate between old and new RAW data and read the correct gain_setting and gain_mode from the RUN source

1. Adding new Jungfrau settings and gain mode enums.
2. Using enum meta to be able to check, to which enum the run settings.value belong.
3. New _get_gain_mode_x functions based on the availability of the gainMode key.
4. Updating the dark notebook with the new ENUMs as it validates the value for the gain modes of the 3 runs.
5. Updating the correction notebook with the extra return from get_gain_mode function.
6. New bias voltage key as well in the new software

How Has This Been Tested?

• To be tested on the reference runs + the new JF version runs.

Relevant Documents (optional)

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist:

Reviewers

@kluyvert @schmidtp @danilevc @mramilli

added Testing label

changed the description

added 1 commit

• 06b47ca4 - small refactors

Compare with previous version

added 6 commits

• 06b47ca4...5c5daef0 - 4 commits from branch master
• 7ff844b9 - New Settings and gain mode enums to read the jungfrau correct parameters
• 9cb2968f - small refactors

Compare with previous version

added 1 commit

• 071cc1b2 - fixes after testing against reference runs

Compare with previous version

added 112 commits

• 071cc1b2...a6c9a7ce - 109 commits from branch master
• 5a931779 - New Settings and gain mode enums to read the jungfrau correct parameters
• 6b735dfa - small refactors
• cd269db5 - fixes after testing against reference runs

Compare with previous version

added 1 commit

• 2e0349be - update precorrection notebook

Compare with previous version

marked this merge request as ready

changed title from Draft: New Settings and gain mode enums to read the jungfrau correct parameters to [Jungfrau][Correct][Dark] New Settings and gain mode enums to read the jungfrau correct parameters.

changed the description

marked the checklist item To be tested on the reference runs + the new JF version runs. as completed

added 1 commit

• 191f3fa8 - flake8

Compare with previous version

The MR has been tested and ready for review.

I think I started adding comments prematurely - please don't focus on the details just yet. I'll think some more about what to recommend.

Can I just check a couple of things from your description calibration/planning#143:

• The new values in CONTROL/.../settings are equivalent to the old 'dynamicgain' (gain0) and 'dynamichg0' (highgain0)
• In the new scheme, CONTROL/.../settings is only meaningful if CONTROL/.../gainMode is 'dynamic'
• The other four values in the new CONTROL/.../gainMode field are equivalent to the remaining four values in the old .../settings (i.e. fixgain1, fixgain2, forceswitchg1, forceswitchg2 -> fixg1, fixg2, forceswitchg1, forceswitchg2)
• So overall, there are the same 6 possible options, but now split up into two fields.

Have I followed that right?

removed Testing label

added Waiting for review label

added 1 commit

• a50d8863 - Correct JungfraSettings enum keys

Compare with previous version