[AGIPD][TESTs]test_agipdlib AGIPDCtrl and get_bias_voltage for AGIPD1M and AGIPD500K

Based on https://git.xfel.eu/detectors/pycalibration/-/merge_requests/651

• Test AGIPDCtrl() methods to read conditions from Fast or slow data.
• differentiate between AGIPD1M and AGIPD500K sources and keys to read bias_voltage. (temporary unbreakable change.)

Description

Latest changes to agipdlib had a class AGIPDCtrl() created collecting all methods to read AGIPD parameter conditions from fast and slow data.

1. I have added tests for these methods
2. I have split some methods based on their functionality.
3. As bias_voltage is stored in different paths for AGIPD1M and AGIPD500K, a condition was added to select the right source.

• This is a temporary change and I think one should give the correct source and key through get_bias_voltage arguments.

4. All of the tests are based on EXtra-data mocked data. I have added mock_agipd1m_run, mock_agipd500K_run and mock_agipd1m_run_old at :

How Has This Been Tested?

Unit tests.

Relevant Documents (optional)

Types of changes

• Test (additional or refactored tests)

Checklist:

• My code follows the code style of this project.
• I have updated the documentation accordingly.
• I added tests where appropriate.

Reviewers

@calibration

src/cal_tools/agipdutils.py

@@ -130,6 +130,15 @@ def get_shadowed_stripe(data, threshold, fraction):
     npx_sh = np.count_nonzero(data < threshold, axis=1)
     rows_to_use = npx_sh / npx_all > fraction
 
+    # TODO: is this necessary?
+    # The previous code excludes the first and last rows that would otherwise
+    # be considered shadowed, with no explanation of why.
+    # For now, I'll preserve the behaviour. -TK
+    row_idxs = np.nonzero(rows_to_use)[0]
+    if len(row_idxs) > 0:
+        rows_to_use[row_idxs[0]] = False
+        rows_to_use[row_idxs[-1]] = False
+
     # Ignore rows with double-width pixels
     rows_to_use[64:512:64] = False
     rows_to_use[63:511:64] = False