feat: Luminex IntelliFlex - Added support for single table files (#1061)

Author: felipenarv

src/allotropy/parsers/constants.py

@@ -10,8 +10,17 @@
 POSSIBLE_WELL_COUNTS = [1, 2, 4, 6, 8, 12, 24, 48, 72, 96, 384, 1536, 3456]
 
 
-def round_to_nearest_well_count(well_count: int) -> int | None:
-    for possible_count in POSSIBLE_WELL_COUNTS:
+def round_to_nearest_well_count(
+    well_count: int, possible_well_counts: list[int] | None = None
+) -> int | None:
+    """
+    Round the well count to the nearest well count in the list of possible well counts. If a list
+    of possible well counts is not provided, use the default list of possible well counts.
+    If the well count is not in the list of possible well counts, return None.
+    """
+    well_counts = possible_well_counts or POSSIBLE_WELL_COUNTS
+    well_counts.sort()
+    for possible_count in well_counts:
         if well_count > possible_count:
             continue
         return possible_count

src/allotropy/parsers/luminex_xponent/constants.py

@@ -15,6 +15,7 @@
 EXPECTED_CALIBRATION_RESULT_LEN = 2
 EXPECTED_HEADER_COLUMNS = 7
 REQUIRED_SECTIONS = ["Count", "Units", "Dilution Factor"]
+POSSIBLE_WELL_COUNTS_LUMINEX = [96, 384]
 
 
 @dataclass(frozen=True)
@@ -69,3 +70,53 @@ class StatisticSectionConfig:
     "% Recovery": "(unitless)",
     "%CV of Replicates": "(unitless)",
 }
+
+# Known metric names in the columns of the single dataset results table
+SINGLE_DATASET_RESULTS_METRIC_WORDS: set[str] = {
+    "MEAN",
+    "MEDIAN",
+    "COUNT",
+    "PEAK",
+    "STDEV",
+    "STANDARD",
+    "DEVIATION",
+    "%CV",
+    "TRIMMED",
+    "NET",
+    "MFI",
+    "AVERAGE",
+    "AVG",
+    "RMS",
+    "MODE",
+    "TRMEAN",
+    "TRIMSTDEV",
+    "NORMALIZED",
+    "DILUTION",
+    "FACTOR",
+    "SETTING",
+    "UNITS",
+}
+
+# Allowed section names for Luminex Xponent reports. Any other name should raise an error upstream.
+ALLOWED_SECTION_NAMES: set[str] = {
+    "Median",
+    "Test Result",
+    "Range",
+    "Net MFI",
+    "Count",
+    "Mean",
+    "Avg Net MFI",
+    "Peak",
+    "Trimmed Peak",
+    "Trimmed Count",
+    "Trimmed Std Dev",
+    "Std Dev",
+    "% CV",
+    "Expected Result",
+    "Units",
+    "Per Bead Count",
+    "Dilution Factor",
+    "Analysis Types",
+    "Audit Logs",
+    "Warnings/Errors",
+}