Previous completed runSimulated instrument · 550 nm

Vitamin B12 assay

A mystery vial exceeded the direct assay’s calibration range. The PI approved a dilution, and a local coding worker added prepared-sample support to the assay.

Fresh generation runs on the presenter laptop with python -m factory.lab.

Original vial · U-01

32.007 mg/L

Diluted vial
16.003 mg/L
Revealed label
32 mg/L
Signed error
+0.007 mg/L

Experiment track

From finding to follow-up

Initial measurement

Absorbances 0.20549, 0.20522, 0.20554 exceeded the highest calibration standard, 0.154.

PI decision

All three readings exceed the strongest standard. The protocol permits a twofold dilution followed by three fresh readings. The PI approved the 2× preparation under b12-optical@1.

Recorded preparation

Vial U-01-D1 contains 1 mL from U-01 in 2 mL total. Its three new absorbances were 0.10284, 0.10271, 0.10262.

Software track

Direct samples to prepared samples

Trace a prepared vial to its parent and use the actual volumes to recover its original concentration.

The same independent fixtures ran on both source versions. Each checks the corrected concentration and links to the original vial.

Prepared-sample requirements
Fixturev1v2
Twofold dilutionFailPass
Fourfold dilutionFailPass

Verified v2 passed 16 / 16 checks. Its worker receipt identifies codex-cli 0.167.0 and gpt-6.1-sol.

Inspect the v1 → v2 source diff
--- v1/analysis.py
+++ v2/analysis.py
@@ -1,28 +1,79 @@
 import sys
 import json
+import math
 import statistics
+
+
+def finite_number(value):
+    if isinstance(value, bool) or not isinstance(value, (int, float)):
+        return False
+    try:
+        return math.isfinite(value)
+    except (OverflowError, ValueError):
+        return False
+
+
+def nonempty_text(value):
+    return isinstance(value, str) and bool(value.strip())
 
 
 def main():
     data = json.load(sys.stdin)
-    calibration = data["calibration"]
-    absorbances = data["absorbances"]
-    in_range = all(
-        calibration["low"] <= value <= calibration["high"]
-        for value in absorbances
-    )
-    accepted = data["preparation"] is None and in_range
-    concentration = None
-    if accepted:
-        concentration = (
-            statistics.mean(absorbances) - calibration["intercept"]
-        ) / calibration["slope"]
-    json.dump({
-        "status": "ok" if accepted else "review",
-        "sample_id": data["sample_id"],
-        "calibration_id": calibration["id"],
-        "concentration_mg_l": concentration
-    }, sys.stdout)
+    calibration = data.get("calibration")
+    preparation = data.get("preparation")
+    result = {
+        "status": "review",
+        "sample_id": data.get("sample_id"),
+        "calibration_id": calibration.get("id") if isinstance(calibration, dict) else None,
+        "concentration_mg_l": None,
+        "parent_id": preparation.get("parent_id") if isinstance(preparation, dict) else None,
+        "preparation_id": preparation.get("id") if isinstance(preparation, dict) else None,
+        "factor": None,
+        "diluted_mg_l": None
+    }
+    try:
+        if not isinstance(calibration, dict):
+            raise ValueError()
+        absorbances = data["absorbances"]
+        if not isinstance(absorbances, list) or len(absorbances) != 3:
+            raise ValueError()
+        if not all(finite_number(value) for value in absorbances):
+            raise ValueError()
+        if not all(finite_number(calibration.get(key)) for key in ("slope", "intercept", "low", "high")):
+            raise ValueError()
+        if calibration["slope"] == 0 or calibration["low"] > calibration["high"]:
+            raise ValueError()
+        if not all(calibration["low"] <= value <= calibration["high"] for value in absorbances):
+            raise ValueError()
+        factor = None
+        if preparation is not None:
+            if not isinstance(preparation, dict):
+                raise ValueError()
+            if not nonempty_text(preparation.get("id")) or not nonempty_text(preparation.get("parent_id")):
+                raise ValueError()
+            if preparation["parent_id"] == data.get("sample_id") or preparation.get("unit") != "mL":
+                raise ValueError()
+            sample_ml = preparation.get("sample_ml")
+            final_ml = preparation.get("final_ml")
+            if not finite_number(sample_ml) or not finite_number(final_ml):
+                raise ValueError()
+            if not final_ml > sample_ml > 0:
+                raise ValueError()
+            factor = final_ml / sample_ml
+            if not finite_number(factor):
+                raise ValueError()
+        diluted = (statistics.mean(absorbances) - calibration["intercept"]) / calibration["slope"]
+        concentration = diluted if preparation is None else diluted * factor
+        if not finite_number(diluted) or not finite_number(concentration):
+            raise ValueError()
+        result["status"] = "ok"
+        result["concentration_mg_l"] = concentration
+        if preparation is not None:
+            result["factor"] = factor
+            result["diluted_mg_l"] = diluted
+    except (KeyError, TypeError, ValueError, ArithmeticError):
+        pass
+    json.dump(result, sys.stdout, allow_nan=False)
 
 
 if __name__ == "__main__":
--- v1/views.json
+++ v2/views.json
@@ -3,7 +3,11 @@
     "sample_id",
     "status",
     "calibration_id",
-    "concentration_mg_l"
+    "concentration_mg_l",
+    "parent_id",
+    "preparation_id",
+    "factor",
+    "diluted_mg_l"
   ],
-  "title": "B12 Direct-Sample Assay"
+  "title": "B12 Sample Concentration"
 }

Reproducibility evidence

Readings, software and provenance

Lab / project
northfield / b12-assay
Instrument
osms-sim@1 · b12-optical@1
Direct task / source
a921d6aadbcd41beb3b442a65182988f
9206b936890d492e6fbd65789762e2b985a51f61bbdc93df8583c5dd6b3d1e49
Follow-up task / source
7b92c13361464fdea79aa5cffcab0f7d
d2305d0c7768a62dc2bf8257d27da0c837103506a7759722bbe27763866e0bce
Frozen calibration
c2821b055967b3bf67a858b5e90488d12c755b257898881f568d7cf09da102d2
Replay outcome
Direct run matched. Follow-up matched.
Scientific review
Review simulated optics and transfer to physical instruments.
Inspect initial and follow-up readings
{
  "initial": [
    {
      "blank_counts": 50006,
      "dark_counts": 95,
      "instrument_profile": "osms-sim@1",
      "replicate": 1,
      "sample_counts": 31191,
      "sample_id": "U-01",
      "settings": {
        "adc_max": 65535,
        "dark_offset_counts": 100,
        "noise_sd_counts": 8,
        "operation": "measure-absorbance",
        "path_length_mm": 10,
        "reference_counts": 50000,
        "replicates": 3,
        "wavelength_nm": 550
      },
      "source": "simulated instrument",
      "timestamp": "2026-11-14T08:11:40.717853+00:00",
      "units": "counts"
    },
    {
      "blank_counts": 49986,
      "dark_counts": 93,
      "instrument_profile": "osms-sim@1",
      "replicate": 2,
      "sample_counts": 31197,
      "sample_id": "U-01",
      "settings": {
        "adc_max": 65535,
        "dark_offset_counts": 100,
        "noise_sd_counts": 8,
        "operation": "measure-absorbance",
        "path_length_mm": 10,
        "reference_counts": 50000,
        "replicates": 3,
        "wavelength_nm": 550
      },
      "source": "simulated instrument",
      "timestamp": "2026-11-14T08:11:40.717857+00:00",
      "units": "counts"
    },
    {
      "blank_counts": 50007,
      "dark_counts": 102,
      "instrument_profile": "osms-sim@1",
      "replicate": 3,
      "sample_counts": 31191,
      "sample_id": "U-01",
      "settings": {
        "adc_max": 65535,
        "dark_offset_counts": 100,
        "noise_sd_counts": 8,
        "operation": "measure-absorbance",
        "path_length_mm": 10,
        "reference_counts": 50000,
        "replicates": 3,
        "wavelength_nm": 550
      },
      "source": "simulated instrument",
      "timestamp": "2026-11-14T08:11:40.717860+00:00",
      "units": "counts"
    }
  ],
  "followup": [
    {
      "blank_counts": 50009,
      "dark_counts": 104,
      "instrument_profile": "osms-sim@1",
      "replicate": 1,
      "sample_counts": 39487,
      "sample_id": "U-01-D1",
      "settings": {
        "adc_max": 65535,
        "dark_offset_counts": 100,
        "noise_sd_counts": 8,
        "operation": "measure-absorbance",
        "path_length_mm": 10,
        "reference_counts": 50000,
        "replicates": 3,
        "wavelength_nm": 550
      },
      "source": "simulated instrument",
      "timestamp": "2026-11-14T08:19:43.597587+00:00",
      "units": "counts"
    },
    {
      "blank_counts": 49996,
      "dark_counts": 105,
      "instrument_profile": "osms-sim@1",
      "replicate": 2,
      "sample_counts": 39488,
      "sample_id": "U-01-D1",
      "settings": {
        "adc_max": 65535,
        "dark_offset_counts": 100,
        "noise_sd_counts": 8,
        "operation": "measure-absorbance",
        "path_length_mm": 10,
        "reference_counts": 50000,
        "replicates": 3,
        "wavelength_nm": 550
      },
      "source": "simulated instrument",
      "timestamp": "2026-11-14T08:19:43.597628+00:00",
      "units": "counts"
    },
    {
      "blank_counts": 49998,
      "dark_counts": 102,
      "instrument_profile": "osms-sim@1",
      "replicate": 3,
      "sample_counts": 39497,
      "sample_id": "U-01-D1",
      "settings": {
        "adc_max": 65535,
        "dark_offset_counts": 100,
        "noise_sd_counts": 8,
        "operation": "measure-absorbance",
        "path_length_mm": 10,
        "reference_counts": 50000,
        "replicates": 3,
        "wavelength_nm": 550
      },
      "source": "simulated instrument",
      "timestamp": "2026-11-14T08:19:43.597635+00:00",
      "units": "counts"
    }
  ]
}
Inspect independent verification results
{
  "parent": [
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 12,
        "sample_id": "direct-mean-and-intercept",
        "status": "ok"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 12,
        "sample_id": "direct-mean-and-intercept",
        "status": "ok"
      },
      "name": "direct-mean-and-intercept",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 15.000000000000002,
        "sample_id": "direct-calibrated-boundaries",
        "status": "ok"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 15,
        "sample_id": "direct-calibrated-boundaries",
        "status": "ok"
      },
      "name": "direct-calibrated-boundaries",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "above-calibration",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "above-calibration",
        "status": "review"
      },
      "name": "above-calibration",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "below-calibration",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "below-calibration",
        "status": "review"
      },
      "name": "below-calibration",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "one-replicate-outside",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "one-replicate-outside",
        "status": "review"
      },
      "name": "one-replicate-outside",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 18,
        "diluted_mg_l": 9,
        "factor": 2,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "ok"
      },
      "name": "prepared-2x",
      "pass": false
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D4",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 28,
        "diluted_mg_l": 7,
        "factor": 4,
        "parent_id": "R4",
        "preparation_id": "P4",
        "sample_id": "D4",
        "status": "ok"
      },
      "name": "prepared-4x",
      "pass": false
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-one-outside",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-missing-parent",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-self-parent",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-missing-preparation-id",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-invalid-unit",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-zero-sample",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-invalid-final-volume",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-equal-volumes",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-invalid-volume-type",
      "pass": true
    }
  ],
  "candidate": [
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 12,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": null,
        "preparation_id": null,
        "sample_id": "direct-mean-and-intercept",
        "status": "ok"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 12,
        "sample_id": "direct-mean-and-intercept",
        "status": "ok"
      },
      "name": "direct-mean-and-intercept",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 15.000000000000002,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": null,
        "preparation_id": null,
        "sample_id": "direct-calibrated-boundaries",
        "status": "ok"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 15,
        "sample_id": "direct-calibrated-boundaries",
        "status": "ok"
      },
      "name": "direct-calibrated-boundaries",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": null,
        "preparation_id": null,
        "sample_id": "above-calibration",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "above-calibration",
        "status": "review"
      },
      "name": "above-calibration",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": null,
        "preparation_id": null,
        "sample_id": "below-calibration",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "below-calibration",
        "status": "review"
      },
      "name": "below-calibration",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": null,
        "preparation_id": null,
        "sample_id": "one-replicate-outside",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "one-replicate-outside",
        "status": "review"
      },
      "name": "one-replicate-outside",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 18,
        "diluted_mg_l": 9,
        "factor": 2,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "ok"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 18,
        "diluted_mg_l": 9,
        "factor": 2,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "ok"
      },
      "name": "prepared-2x",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 27.999999999999996,
        "diluted_mg_l": 6.999999999999999,
        "factor": 4,
        "parent_id": "R4",
        "preparation_id": "P4",
        "sample_id": "D4",
        "status": "ok"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": 28,
        "diluted_mg_l": 7,
        "factor": 4,
        "parent_id": "R4",
        "preparation_id": "P4",
        "sample_id": "D4",
        "status": "ok"
      },
      "name": "prepared-4x",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-one-outside",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": null,
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-missing-parent",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "D2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-self-parent",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-missing-preparation-id",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-invalid-unit",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-zero-sample",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-invalid-final-volume",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-equal-volumes",
      "pass": true
    },
    {
      "actual": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "diluted_mg_l": null,
        "factor": null,
        "parent_id": "R2",
        "preparation_id": "P2",
        "sample_id": "D2",
        "status": "review"
      },
      "expected": {
        "calibration_id": "ref-cal-v1",
        "concentration_mg_l": null,
        "sample_id": "D2",
        "status": "review"
      },
      "name": "prepared-invalid-volume-type",
      "pass": true
    }
  ]
}
Inspect the released analysis module
import sys
import json
import math
import statistics


def finite_number(value):
    if isinstance(value, bool) or not isinstance(value, (int, float)):
        return False
    try:
        return math.isfinite(value)
    except (OverflowError, ValueError):
        return False


def nonempty_text(value):
    return isinstance(value, str) and bool(value.strip())


def main():
    data = json.load(sys.stdin)
    calibration = data.get("calibration")
    preparation = data.get("preparation")
    result = {
        "status": "review",
        "sample_id": data.get("sample_id"),
        "calibration_id": calibration.get("id") if isinstance(calibration, dict) else None,
        "concentration_mg_l": None,
        "parent_id": preparation.get("parent_id") if isinstance(preparation, dict) else None,
        "preparation_id": preparation.get("id") if isinstance(preparation, dict) else None,
        "factor": None,
        "diluted_mg_l": None
    }
    try:
        if not isinstance(calibration, dict):
            raise ValueError()
        absorbances = data["absorbances"]
        if not isinstance(absorbances, list) or len(absorbances) != 3:
            raise ValueError()
        if not all(finite_number(value) for value in absorbances):
            raise ValueError()
        if not all(finite_number(calibration.get(key)) for key in ("slope", "intercept", "low", "high")):
            raise ValueError()
        if calibration["slope"] == 0 or calibration["low"] > calibration["high"]:
            raise ValueError()
        if not all(calibration["low"] <= value <= calibration["high"] for value in absorbances):
            raise ValueError()
        factor = None
        if preparation is not None:
            if not isinstance(preparation, dict):
                raise ValueError()
            if not nonempty_text(preparation.get("id")) or not nonempty_text(preparation.get("parent_id")):
                raise ValueError()
            if preparation["parent_id"] == data.get("sample_id") or preparation.get("unit") != "mL":
                raise ValueError()
            sample_ml = preparation.get("sample_ml")
            final_ml = preparation.get("final_ml")
            if not finite_number(sample_ml) or not finite_number(final_ml):
                raise ValueError()
            if not final_ml > sample_ml > 0:
                raise ValueError()
            factor = final_ml / sample_ml
            if not finite_number(factor):
                raise ValueError()
        diluted = (statistics.mean(absorbances) - calibration["intercept"]) / calibration["slope"]
        concentration = diluted if preparation is None else diluted * factor
        if not finite_number(diluted) or not finite_number(concentration):
            raise ValueError()
        result["status"] = "ok"
        result["concentration_mg_l"] = concentration
        if preparation is not None:
            result["factor"] = factor
            result["diluted_mg_l"] = diluted
    except (KeyError, TypeError, ValueError, ArithmeticError):
        pass
    json.dump(result, sys.stdout, allow_nan=False)


if __name__ == "__main__":
    main()

Supporting evaluation

How far did the estimates miss?

Across the blind simulated panel, the mean absolute error was 0.006 mg/L, against a target of 1 mg/L. On the six published commercial-instrument means, the same frozen calibration gave a mean absolute error of 4.72 mg/L.

Inspect six published readings and their errors

Signed error is the estimate minus the prepared concentration. The benchmark includes extrapolations for scoring. The live assay withholds an out-of-range result for PI review. The six means measure transfer across conditions. Their differences have several possible causes. Laganovska et al., Table 1 (“Com”)

Prepared (ppm)AbsorbanceEstimate (mg/L)Error (mg/L)Range
30.0335.135+2.135In range
50.0629.656+4.656In range
100.08913.864+3.864In range
150.11918.54+3.54In range
200.17326.957+6.957Extrapolated
240.20031.166+7.166Extrapolated