[Gotthard2][Dark] Sort dark runs

Description

Sort dark runs for Gotthard2 by checking RUN/.../settings

This addresses GH2 part of this issue: https://git.xfel.eu/calibration/planning/-/issues/192

How Has This Been Tested?

Relevant Documents (optional)

gh2_sort_darks_fxe.pdf

gh2_sort_darks_hirex.pdf

Types of changes

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

Checklist:

• I added tests where appropriate. Can't be used now because of permissions

Reviewers

@schmidtp @kluyvert

notebooks/Gotthard2/Characterize_Darks_Gotthard2_NBC.ipynb

     calcat_creation_time,
     get_constant_from_db_and_time,
     get_report,
+    raw_data_location_string,
     save_const_to_h5,
     send_to_db,
 )
 out_folder = Path(out_folder)
 out_folder.mkdir(parents=True, exist_ok=True)
 
+if not karabo_id_control:
+    karabo_id_control = karabo_id
+
 ctrl_src = ctrl_source_template.format(karabo_id_control, control_template)
+run_nums = gotthard2lib.sort_dark_runs_by_gain(
+    raw_folder=in_folder,
+    runs=run_nums,
+    ctrl_src=ctrl_src,
+)
 
 # Read report path to associate it later with injected constants.
 report = get_report(metadata_folder)
 
 # Run's creation time:
-creation_time = calcat_creation_time(in_folder, run_high, creation_time)
+creation_time = calcat_creation_time(in_folder, run_nums[0], creation_time)
 print(f"Creation time: {creation_time}")
-
-if not karabo_id_control:
-    karabo_id_control = karabo_id
 %% Cell type:code id:c176a86f tags:
 ``` python
-run_dc = RunDirectory(in_folder / f"r{run_high:04d}")
-file_loc = f"proposal:{run_dc.run_metadata()['proposalNumber']} runs:{run_high} {run_med} {run_low}"  # noqa
+run_dc = RunDirectory(in_folder / f"r{run_nums[0]:04d}")
+file_loc = raw_data_location_string(
+    f"p{run_dc.run_metadata()['proposalNumber']}", run_nums)
 receiver_names = [f"*{receiver_template.format(x)}*" for x in receiver_affixes]
 data_sources = sorted(list(run_dc.select(receiver_names).all_sources))
 step_timer.start()
 run_dcs_dict = dict()
 
-ctrl_src = ctrl_source_template.format(karabo_id_control, control_template)
 conditions = {
     "bias_voltage": set(),
     "exposure_time": set(),