Add multi-burner hot-oil heater CO diagnostics

README.md

@@ -42,6 +42,7 @@ Advanced notebooks use JPype directly or through the Python distribution. They c
 * [Mechanical design to interactive 3D equipment](notebooks/process/mechanical_design_to_3d_models.ipynb) – Generate separator and compressor models from calculated NeqSim dimensions, inspect cutaways, compare flow cases, and exchange qualified STL/GLB/JSON artifacts.
 
 * [Hot-oil commissioning and ML risk screening](notebooks/flowassurance/hot_oil_commissioning_neqsim_ml.ipynb) – Combine NeqSim properties, wax, thermal resistance and a native heater/pipeline process with a conservative transient displacement model, numerical checks, RF/MLP surrogates and explicit gel-restart assumptions.
+* [Multi-burner hot-oil heater and CO-emissions diagnostics](notebooks/process/multi_burner_hot_oil_heater_co_emissions.ipynb) – Run source-pinned finite-rate burner and post-flame zones for seven/five burners, fixed-air load and 10–40 MW sweeps; retain actual CO mass, dry and reference-O₂ bases, thermal duty, fuel-slip diagnostics, projection omissions, provenance and conservation gates. GRI-Mech 3.0 remains a software demonstration rather than C3/C4 qualification.
 * [open-DARTS waterflood simulation and a NeqSim process handoff](notebooks/reservoir/open_darts_waterflood_to_neqsim.ipynb) – Build and validate an open-DARTS reservoir model, exercise well controls, check analytical and numerical sensitivity, and transfer component rates into NeqSim; connect the tutorial to the existing OPM Flow, RMS, and ERT examples.
 * [Elemental sulfur in oil stabilization and gas recompression](notebooks/process/elemental_sulfur_stabilization_recompression.ipynb) – Calculate H2S/O2 equilibrium and kinetics, sulfur deposition, rust/FeS effects, separator oil/condensate carryover, compressor fouling, and potential mitigation and cleaning measures.
 * [LNG process simulation and benchmark comparison](notebooks/process/LNG_Process_Benchmark_Comparison.ipynb) – Run closed-loop SMR, C3MR, DMR, and nitrogen-expander models with common KPIs, literature checks, and an exchanger grid-convergence study.

notebooks/examples_of_NeqSim_in_Colab.ipynb

@@ -366,6 +366,7 @@
     "* [NCS wind, battery, and gas-turbine electrification with NeqSim](power/ncs_wind_battery_gas_electrification.ipynb): build NeqSim from a pinned repository commit, derive an offshore process load, dispatch Hywind-scale synthetic wind and balancing gas, evaluate native battery storage, and screen direct CO₂, curtailment, ramps, reserve, and field-maturity sensitivities.\n",
     "* [Process-coupled offshore electrification with NeqSim](power/process_coupled_offshore_electrification_study.ipynb): extend a real separation and recompression process with 70-to-160 bara export compression, derive flow-dependent electrical demand from solved equipment duties, and compare gas turbines, shore power, wind, battery storage, and hybrid operation.\n",
     "* [Natural-gas combustion, burner devices, and NeqSim integration with Cantera](reactions/natural_gas_combustion_with_cantera.ipynb): compare fuel and oxidizer blends; boiler, furnace, low-NOx, gas-turbine, duct-burner, and flare cases; validate composition and mass closure; model staged combustion; and run a Cantera custom unit inside a NeqSim process.\n",
+    "* **Advanced** - [Multi-burner hot-oil heater and CO-emissions diagnostics](process/multi_burner_hot_oil_heater_co_emissions.ipynb): run source-pinned finite-rate burner and post-flame zones for seven/five burners, fixed-air load and 10–40 MW sweeps; retain CO mass and dry/reference-O2 bases, thermal duty, fuel-slip diagnostics, projection omissions, provenance, and conservation gates.\n",
     "* [Gas-fired power plants with NeqSim](power/Gas_fired_power_plants.ipynb): fuel quality, stoichiometric combustion, Brayton-cycle states, heat recovery, balances, direct CO2 intensity, and operating sensitivities.\n",
     "* [Natural-gas combined-cycle power plant with NeqSim](power/combined_cycle_power_plant.ipynb): Brayton gas turbine, single-pressure HRSG, CPA water/steam Rankine cycle, balances, quality checks, and operating sensitivities.\n",
     "\n",

notebooks/maintenance_ledger/multi_burner_heater_20261004.json

@@ -0,0 +1,45 @@
+{
+  "schema_version": 1,
+  "updated_at": "2026-10-04T06:34:00Z",
+  "notebooks": [
+    {
+      "path": "notebooks/process/multi_burner_hot_oil_heater_co_emissions.ipynb",
+      "verified_date": "2026-10-04",
+      "verified_at_utc": "2026-10-04T06:34:00Z",
+      "neqsim_version": "3.23.0 dependencies with source overlay at 64e0a0a5997c0d130b9326a78d46269063f5bc94",
+      "python_version": "3.12.14",
+      "java_version": "openjdk 17.0.20",
+      "execution_status": "passed",
+      "execution_method": "All 11 code cells executed sequentially in a fresh Python process and shared namespace. The managed validator blocks Jupyter ZeroMQ sockets, so execution used ordinary Python while retaining stdout, rich HTML tables, PNG figures and execution counts. Java loaded connector-reconstructed source classes compiled at the pinned NeqSim master commit over public NeqSim 3.23.0 dependencies; Cantera 3.2.0 supplied GRI-Mech 3.0 finite-rate chemistry.",
+      "code_cells": 11,
+      "markdown_cells": 8,
+      "publication": {
+        "branch": "feat/multi-burner-heater-colab",
+        "mode": "draft pull request",
+        "commit": "this atomic commit"
+      },
+      "retained_figures": {
+        "count": 4,
+        "purposes": [
+          "seven/five burner comparison at equal total fuel and air",
+          "fixed-common-air CO mass, concentration, oxygen and temperature sweep",
+          "useful heat, residual chemical power, methane, organic carbon and assumed local-air capture",
+          "10–40 MW useful-heat and CO scaling"
+        ],
+        "visual_inspection": "Passed at original resolution: titles, units, legends, scales and rise/fall CO behavior are readable with no clipping or overlap."
+      },
+      "key_checks": [
+        "11 of 11 code cells executed in order with zero stored errors",
+        "seven/five cases passed independent zone mass and every-element residuals below 1e-7, full energy residual below 1e-6 and omitted-element fractions below the native 1e-6 projection limit",
+        "fixed-air sweep maximum omitted-element fraction was 3.247241e-4 against its declared 1e-3 limit; maximum full-energy residual was 1.788856e-7",
+        "CO mass rose to 18.0719 kg/h at 30% load and fell to 9.4747 kg/h at 20% load while useful hot-oil heat stayed positive, so complete extinction was not used as the explanation",
+        "10, 20, 30 and 40 MW scale points produced 8.7454, 17.5066, 26.2714 and 35.0381 MW useful hot-oil heat",
+        "actual CO kg/h, raw dry ppmv and mg/Nm3, 3 vol% O2-corrected mg/Nm3, O2, burner/stack temperatures, residual chemical power, CH4 and organic-carbon diagnostics are retained separately",
+        "loaded MultiBurnerFiredHeater class origin, exact NeqSim source ref, Cantera version, GRI-Mech mechanism fingerprint, species/reaction counts and top omitted hydrogen species are displayed",
+        "four retained figures were extracted and visually inspected after the final execution"
+      ],
+      "limitations": "GRI-Mech 3.0 is only a software demonstration. Local-air capture, effective tube sink, chamber geometry and steady refractory are declared assumptions. The notebook does not claim C3/C4 benchmark qualification, spatial CFD, dynamic refractory storage, plant calibration, VOC-instrument equivalence, emissions compliance, burner safety or heater-design certification.",
+      "summary": "Adds an executed, source-pinned demonstration of the native NeqSim multi-burner fired-heater API with finite-rate Cantera chemistry, explicit hot-oil heat transfer and fail-closed projection/conservation evidence."
+    }
+  ]
+}

notebooks/notebook_maintenance_ledger.json

@@ -1,5 +1,5 @@
 {
-  "active_notebook_count": 321,
+  "active_notebook_count": 322,
   "retired_notebooks": [
     {
       "follow_up": "Replace with the planned NeqSim-master data-reconciliation and Bayesian digital-twin notebook.",