measur-tools-suite 1.0.14-beta.268 → 1.0.14-beta.283

package/bin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "measur-tools-suite",
-  "version": "1.0.14-beta.268",
+  "version": "1.0.14-beta.283",
   "engines": {
     "node": "20.19.4",
     "npm": "10.8.2"

package/docs/dependencies/mathjax-config.js

@@ -96,6 +96,7 @@ window.MathJax = {
                 \DeclareSIUnit{\lbmol}{lbmol}
                 \DeclareSIUnit{\year}{yr}
                 \DeclareSIUnit{\ton}{ton}
+                \DeclareSIUnit{\squareInch}{in^2}
                 \DeclareSIUnit{\inchMercury}{inHg}
             `);
         }

package/docs/dox-content/calculators/processHeat/flow_calculations_energy_use_calculator.dox

@@ -0,0 +1,211 @@
+/**
+ * @defgroup flow_calculations_energy_use_calculator Flow Calculations Energy Use Calculator
+ * @ingroup process_heat_calculators
+ * @brief Calculates flow rate and heat input of a fuel-fired furnace using orifice flow measurement.
+ * @details This calculator estimates gas flow rate and energy consumption in fuel-fired furnaces by measuring pressure drop across an orifice. The calculation uses orifice geometry, gas properties, operating conditions, and discharge coefficients to determine volumetric flow and thermal input. The method is based on standard industrial practice for orifice flow measurement in combustion systems.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Orifice Area** - Calculate effective orifice cross-sectional area
+ * 2. **Adjusted Discharge Coefficient** - Correct discharge coefficient for diameter ratio effects
+ * 3. **Pressure Drop Term** - Calculate normalized pressure drop accounting for specific gravity
+ * 4. **Temperature Adjustment** - Correct flow for actual gas temperature vs. standard conditions
+ * 5. **Pressure Adjustment** - Correct flow for actual gas pressure vs. atmospheric
+ * 6. **Flow Rate** - Calculate volumetric flow rate at standard conditions
+ * 7. **Heat Input** - Calculate thermal input based on flow and heating value
+ * 8. **Total Flow** - Calculate total gas volume consumed over operating period
+ *
+ * Relevant formulas and symbol definitions are documented below.
+ *
+ * @heading{Orifice Area}
+ * @copydoc flow_calculations_orifice_area_formula
+ *
+ * @heading{Adjusted Discharge Coefficient}
+ * @copydoc flow_calculations_adjusted_discharge_coefficient_formula
+ *
+ * @heading{Pressure Drop Term}
+ * @copydoc flow_calculations_pressure_drop_formula
+ *
+ * @heading{Temperature Adjustment}
+ * @copydoc flow_calculations_temperature_adjustment_formula
+ *
+ * @heading{Pressure Adjustment}
+ * @copydoc flow_calculations_pressure_adjustment_formula
+ *
+ * @heading{Flow Rate}
+ * @copydoc flow_calculations_flow_rate_formula
+ *
+ * @heading{Heat Input}
+ * @copydoc flow_calculations_heat_input_formula
+ *
+ * @heading{Total Flow}
+ * @copydoc flow_calculations_total_flow_formula
+ *
+ * @heading{Gas Type Specific Gravity Values}
+ * The following table shows the default specific gravity values. Provided for reference.
+ *
+ * | Gas Type | Specific Gravity (unitless) |
+ * |----------|---------------------------|
+ * | Air | 1.0 |
+ * | Ammonia (Dissociated) | 0.3 |
+ * | Argon | 1.38 |
+ * | Butane | 2.02 |
+ * | Endothermic Ammonia | 0.59 |
+ * | Exothermic (Cracked Lean) | 1.0 |
+ * | Exothermic (Cracked Rich) | 0.85 |
+ * | Helium | 0.14 |
+ * | Hydrogen | 0.07 |
+ * | Natural Gas | 0.65 |
+ * | Nitrogen | 0.96 |
+ * | Oxygen | 1.11 |
+ * | Propane | 1.52 |
+ *
+ * @heading{Section Type Discharge Coefficients}
+ * The following table shows the default discharge coefficient values. Provided for reference.
+ *
+ * | Section Type | Discharge Coefficient (unitless) |
+ * |-------------|----------------------------------|
+ * | Square Edge | 0.5 |
+ * | Sharp Edge | 0.6 |
+ * | Venturi | 0.8 |
+ */
+
+/**
+ * @defgroup flow_calculations_orifice_area_formula Orifice Area Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Effective cross-sectional area of the orifice.
+ * @details The orifice area is calculated using an empirical factor and the square of the orifice diameter. This factor accounts for the conversion from diameter in inches to effective area for volumetric flow calculations in standard cubic feet per hour.
+ *
+ * @formula{flow-calculations-orifice-area; A = k_{area} \cdot d_{orifice}^2}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{A; Orifice area; \squareInch}
+ * @symrow{k_{area}; Orifice area factor (1300) - empirical constant for flow calculations, see @ref physics::us::kOrificeAreaFactor; \unitless}
+ * @symrow{d_{orifice}; Orifice diameter; \inch}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup flow_calculations_adjusted_discharge_coefficient_formula Adjusted Discharge Coefficient Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Discharge coefficient corrected for diameter ratio effects.
+ * @details When the orifice diameter is smaller than the pipe diameter, the discharge coefficient must be adjusted to account for the velocity of approach and contraction effects. If the diameters are equal, no adjustment is needed.
+ *
+ * @formula{flow-calculations-adjusted-discharge-coeff; C_{d,adj} = \begin{cases} \frac{C_d}{\sqrt{1 - \left(\frac{d_{orifice}}{d_{pipe}}\right)^4}} & \text{if } d_{orifice} < d_{pipe} \\ C_d & \text{otherwise} \end{cases}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{C_{d,adj}; Adjusted discharge coefficient; \unitless}
+ * @symrow{C_d; Discharge coefficient; \unitless}
+ * @symrow{d_{orifice}; Orifice diameter; \inch}
+ * @symrow{d_{pipe}; Inside pipe diameter; \inch}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup flow_calculations_pressure_drop_formula Pressure Drop Term Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Normalized pressure drop term accounting for gas specific gravity.
+ * @details The pressure drop term represents the driving force for flow through the orifice, normalized by the gas specific gravity. This accounts for the fact that lighter gases will flow faster for the same pressure drop.
+ *
+ * @formula{flow-calculations-pressure-drop; \Delta P_{norm} = \sqrt{\frac{\Delta P_{orifice}}{SG}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{\Delta P_{norm}; Normalized pressure drop; \inchWaterColumn}
+ * @symrow{\Delta P_{orifice}; Orifice pressure drop; \inchWaterColumn}
+ * @symrow{SG; Gas specific gravity (relative to air); \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup flow_calculations_temperature_adjustment_formula Temperature Adjustment Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Temperature correction factor for flow to standard conditions.
+ * @details The temperature adjustment converts actual volumetric flow at operating temperature to standard conditions (60°F or 520°R). Gas volume is inversely proportional to the square root of absolute temperature.
+ *
+ * @formula{flow-calculations-convert-temperature; T_{gas} = T_{gas,F} + 459.67}
+ * @formula{flow-calculations-temperature-adj; f_T = \sqrt{\frac{T_{std}}{T_{gas}}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{f_T; Temperature adjustment factor; \unitless}
+ * @symrow{T_{std}; Standard gas temperature (520) - see @ref physics::us::kStandardGasTemperatureR; \degreeRankine}
+ * @symrow{T_{gas}; Actual gas temperature in Rankine; \degreeRankine}
+ * @symrow{T_{gas,F}; Actual gas temperature in Fahrenheit; \degreeFahrenheit}
+ * @symrow{459.67; Fahrenheit to Rankine conversion factor - see @ref physics::conversions::fahrenheitToRankine; \degreeRankine}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup flow_calculations_pressure_adjustment_formula Pressure Adjustment Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Pressure correction factor for flow to standard conditions.
+ * @details The pressure adjustment converts actual volumetric flow at operating pressure (gauge) to standard atmospheric pressure. Gas volume is proportional to the square root of absolute pressure.
+ *
+ * @formula{flow-calculations-abs-gas-pressure; P_{gas,abs} = P_{gas,gauge} + P_{atm}}
+ * @formula{flow-calculations-pressure-adj; f_P = \sqrt{\frac{P_{gas,abs}}{P_{atm}}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{f_P; Pressure adjustment factor; \unitless}
+ * @symrow{P_{gas,abs}; Absolute gas pressure; psia}
+ * @symrow{P_{gas,gauge}; Gauge gas pressure; psig}
+ * @symrow{P_{atm}; Atmospheric pressure (14.7) - see @ref physics::us::kAtmosphericPressurePsi; psia}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup flow_calculations_flow_rate_formula Flow Rate Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Volumetric flow rate at standard conditions.
+ * @details The flow rate is calculated by combining the orifice area, adjusted discharge coefficient, and all correction factors. This represents the gas flow rate at standard conditions (60°F, 1 atm).
+ *
+ * @formula{flow-calculations-flow-rate; \dot{V} = A \cdot C_{d,adj} \cdot \Delta P_{norm} \cdot f_T \cdot f_P}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{\dot{V}; Volumetric flow rate; \scf\per\hour}
+ * @symrow{A; Orifice area; \squareInch}
+ * @symrow{C_{d,adj}; Adjusted discharge coefficient; \unitless}
+ * @symrow{\Delta P_{norm}; Normalized pressure drop; \inchWaterColumn}
+ * @symrow{f_T; Temperature adjustment factor; \unitless}
+ * @symrow{f_P; Pressure adjustment factor; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup flow_calculations_heat_input_formula Heat Input Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Thermal energy input over operating period.
+ * @details The heat input is calculated by multiplying the volumetric flow rate by the heating value of the gas and the operating time. The result is converted from Btu to MMBtu. If the heating value is zero or negative, the heat input is zero.
+ *
+ * @formula{flow-calculations-heat-input; Q_{input} = \frac{\dot{V} \cdot HHV \cdot t_{op}}{CF_{MMBtu}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Q_{input}; Heat input over operating period; \MMBtu}
+ * @symrow{\dot{V}; Volumetric flow rate; \scf\per\hour}
+ * @symrow{HHV; Higher heating value of gas; \btu\per\scf}
+ * @symrow{t_{op}; Operating time; \hour}
+ * @symrow{CF_{MMBtu}; Conversion factor to convert from Btu to MMBtu (1,000,000 Btu/MMBtu) - see @ref physics::conversions::kMMBtuToBtu; \btu\per\MMBtu}
+ * @endsymtable
+ *
+ * @note If HHV ≤ 0, then @math{Q_{input}} = 0.
+ */
+
+/**
+ * @defgroup flow_calculations_total_flow_formula Total Flow Formula
+ * @ingroup flow_calculations_energy_use_calculator
+ * @brief Total gas volume consumed over operating period.
+ * @details The total flow is calculated by multiplying the volumetric flow rate at standard conditions by the operating time. This represents the total volume of gas consumed during the operating period.
+ *
+ * @formula{flow-calculations-total-flow; V_{total} = \dot{V} \cdot t_{op}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{V_{total}; Total gas volume consumed; \scf}
+ * @symrow{\dot{V}; Volumetric flow rate; \scf\per\hour}
+ * @symrow{t_{op}; Operating time; \hour}
+ * @endsymtable
+ */

package/docs/dox-content/calculators/processHeat/losses/solid_liquid_flue_gas_calculator.dox

@@ -272,15 +272,26 @@
  * estimates the fraction of excess air supplied to the combustion process. The calculation uses stoichiometric 
  * relationships and mass balance.
  *
+ * The implementation uses the shared @ref process_heat::calculateExcessAir function from the @ref process_heat 
+ * namespace as the initial estimate, then iteratively refines it based on the fuel composition and measured 
+ * flue gas properties.
+ *
  * @subheading{Iterative Procedure}
- * The excess air is estimated by iterating on the relationship between O2 content and excess air until convergence.
- * See the source code implementation for the detailed iterative algorithm.
+ * 1. **Initial Estimate**: Uses @ref process_heat::calculateExcessAir to get a starting excess air value based 
+ *    on measured flue gas O2. See @ref process_heat_excess_air_formula for the formula.
+ * 2. **Iterative Refinement**: Calculates expected O2 using @ref solid_liquid_flue_gas_material::calculateFlueGasO2
+ *    and adjusts excess air until convergence (error < 2%).
+ * 3. **Convergence**: Iteration continues until the calculated O2 matches the measured O2 within tolerance.
+ *
  *
  * @par Symbols
  * @symtable
  * @symrow{EA; Excess air fraction; \unitless}
  * @symrow{O_2; Measured flue gas oxygen percentage; \percent}
  * @endsymtable
+ *
+ * @see process_heat::calculateExcessAir for the initial excess air estimate formula
+ * @see solid_liquid_flue_gas_material::calculateFlueGasO2 for O2 calculation during iteration
  */
 
 /**

package/docs/dox-content/calculators/processHeat/o2_enrichment_calculator.dox

@@ -0,0 +1,206 @@
+/**
+ * @defgroup o2_enrichment_calculator O2 Enrichment Calculator
+ * @ingroup process_heat_calculators
+ * @brief Calculates fuel consumption and savings from oxygen enrichment in fuel-fired furnaces.
+ * @details This calculator estimates the benefit of enriching combustion air with oxygen to improve combustion efficiency and reduce fuel consumption. The calculation uses combustion air properties, flue gas temperatures, oxygen concentrations, and fuel consumption data. The method is based on standard industrial practice for oxygen enrichment in process heating systems.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Excess Air** - Calculate excess air from oxygen concentration in flue gas
+ * 2. **Heat Input** - Determine heat input based on flue gas temperature
+ * 3. **Air Specific Heat** - Calculate specific heat of combustion air based on preheat temperature
+ * 4. **Air Correction** - Compute correction factor for excess air heat losses
+ * 5. **Combustion Air Correction** - Calculate correction factor for combustion air preheat
+ * 6. **Standard Available Heat** - Determine standard available heat from heat input and corrections
+ * 7. **Available Heat** - Calculate available heat accounting for oxygen enrichment effects
+ * 8. **Fuel Consumption with O2 Enrichment** - Compute fuel consumption with oxygen enrichment
+ * 9. **Fuel Savings with O2 Enrichment** - Determine fuel savings as a percentage
+ *
+ * Relevant formulas and symbol definitions are documented below.
+ *
+ * @heading{Excess Air}
+ * @copydoc o2_enrichment_excess_air_formula
+ *
+ * @heading{Heat Input}
+ * @copydoc o2_enrichment_heat_input_formula
+ *
+ * @heading{Air Specific Heat}
+ * @copydoc o2_enrichment_air_specific_heat_formula
+ *
+ * @heading{Air Correction}
+ * @copydoc o2_enrichment_air_correction_formula
+ *
+ * @heading{Combustion Air Correction}
+ * @copydoc o2_enrichment_combustion_air_correction_formula
+ *
+ * @heading{Standard Available Heat}
+ * @copydoc o2_enrichment_standard_available_heat_formula
+ *
+ * @heading{Available Heat}
+ * @copydoc o2_enrichment_available_heat_formula
+ *
+ * @heading{Fuel Consumption with O2 Enrichment}
+ * @copydoc o2_enrichment_fuel_consumption_formula
+ *
+ * @heading{Fuel Savings with O2 Enrichment}
+ * @copydoc o2_enrichment_fuel_savings_formula
+ */
+
+/**
+ * @defgroup o2_enrichment_excess_air_formula Excess Air Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Excess air calculated from oxygen concentration in flue gas.
+ * @details The excess air is determined from the oxygen concentration in the flue gas using stoichiometric 
+ * relationships. This calculation uses the shared @ref process_heat::calculateExcessAir function from the 
+ * @ref process_heat namespace, which provides a consistent implementation across all process heat calculators.
+ *
+ * The formula uses empirical factors derived from combustion stoichiometry for typical fuels to account for 
+ * the fact that excess oxygen in flue gas indicates incomplete combustion air utilization.
+ *
+ * @par Implementation
+ * See @ref process_heat_excess_air_formula for the complete formula, symbol definitions, and implementation details.
+ *
+ */
+
+/**
+ * @defgroup o2_enrichment_heat_input_formula Heat Input Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Heat input calculated based on flue gas temperature.
+ * @details The heat input is estimated from the flue gas temperature using an empirical linear relationship. Higher flue gas temperatures indicate greater heat losses, resulting in lower available heat for the process. The relationship is based on typical industrial furnace operating conditions.
+ *
+ * @formula{o2-enrichment-heat-input; Q_{in} = 95 - 0.025 \cdot T_{flue}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Q_{in}; Heat input; \percent}
+ * @symrow{T_{flue}; Flue gas temperature; \degreeFahrenheit}
+ * @symrow{95; Heat input intercept constant; \percent}
+ * @symrow{0.025; Heat input slope constant; \percent\per\degreeFahrenheit}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_air_specific_heat_formula Air Specific Heat Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Specific heat of combustion air calculated based on preheat temperature.
+ * @details The specific heat of air varies with temperature according to an empirical linear relationship. This accounts for the temperature-dependent thermodynamic properties of air. The base specific heat and temperature coefficient are referenced from @ref physics::us::kSpecificHeatAirBase and @ref physics::us::kSpecificHeatAirCoeff.
+ *
+ * @formula{o2-enrichment-air-specific-heat; C_{p,air} = C_{p,base} + k_{temp} \cdot T_{air}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{C_{p,air}; Air specific heat; \btu\per\pound\per\degreeFahrenheit}
+ * @symrow{C_{p,base}; Base specific heat of air (0.017828518) - see @ref physics::us::kSpecificHeatAirBase; \btu\per\pound\per\degreeFahrenheit}
+ * @symrow{k_{temp}; Temperature coefficient (0.000002556) - see @ref physics::us::kSpecificHeatAirCoeff; \btu\per\pound\per\degreeFahrenheit\per\degreeFahrenheit}
+ * @symrow{T_{air}; Combustion air preheat temperature; \degreeFahrenheit}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_air_correction_formula Air Correction Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Correction factor for excess air heat losses.
+ * @details The air correction accounts for heat losses due to excess air being heated and discharged with the flue gas. The correction is proportional to the excess air fraction, flue gas temperature, and air specific heat. The base constant is referenced from @ref physics::us::kAirCorrectionBase.
+ *
+ * @formula{o2-enrichment-air-correction; AC = -(k_{base} + C_{p,air} \cdot T_{flue}) \cdot EA}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{AC; Air correction; \percent}
+ * @symrow{k_{base}; Air correction base constant (-1.078913827) - see @ref physics::us::kAirCorrectionBase; \btu\per\pound}
+ * @symrow{C_{p,air}; Air specific heat; \btu\per\pound\per\degreeFahrenheit}
+ * @symrow{T_{flue}; Flue gas temperature; \degreeFahrenheit}
+ * @symrow{EA; Excess air; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_combustion_air_correction_formula Combustion Air Correction Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Correction factor for combustion air preheat.
+ * @details The combustion air correction accounts for the heat credit from preheating combustion air. Higher preheat temperatures reduce fuel consumption by providing sensible heat to the combustion process. The correction is applied to both stoichiometric and excess air. The base constant is the same as the air correction base.
+ *
+ * @formula{o2-enrichment-combustion-air-correction; CAC = (k_{base} + C_{p,air} \cdot T_{air}) \cdot (1 + EA)}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{CAC; Combustion air correction; \percent}
+ * @symrow{k_{base}; Combustion air correction base constant (-1.078913827); \btu\per\pound}
+ * @symrow{C_{p,air}; Air specific heat; \btu\per\pound\per\degreeFahrenheit}
+ * @symrow{T_{air}; Combustion air preheat temperature; \degreeFahrenheit}
+ * @symrow{EA; Excess air; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_standard_available_heat_formula Standard Available Heat Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Standard available heat from heat input and correction factors.
+ * @details The standard available heat represents the net heat available for the process after accounting for flue gas losses and combustion air preheat. It is the sum of the heat input, air correction (negative for losses), and combustion air correction (positive for preheat credit).
+ *
+ * @formula{o2-enrichment-standard-available-heat; AH_{std} = Q_{in} + AC + CAC}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{AH_{std}; Standard available heat; \percent}
+ * @symrow{Q_{in}; Heat input; \percent}
+ * @symrow{AC; Air correction; \percent}
+ * @symrow{CAC; Combustion air correction; \percent}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_available_heat_formula Available Heat Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Available heat accounting for oxygen enrichment effects.
+ * @details The available heat is adjusted from the standard available heat to account for the benefits of oxygen enrichment. Enriching the combustion air with oxygen reduces the nitrogen content, which decreases sensible heat losses in the flue gas. The correction is proportional to the oxygen enrichment level, flue gas temperature, and the difference from ambient conditions.
+ *
+ * @formula{o2-enrichment-available-heat; AH = AH_{std} + 100 \cdot k_O \cdot \frac{O_{2,air} - 0.21}{O_{2,air}} \cdot 0.02 \cdot \frac{T_{flue} - 60}{980}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{AH; Available heat with enrichment; \percent}
+ * @symrow{AH_{std}; Standard available heat; \percent}
+ * @symrow{k_O; Oxygen enrichment factor (9.38); \unitless}
+ * @symrow{O_{2,air}; Oxygen in combustion air; \unitless}
+ * @symrow{0.21; Reference oxygen fraction in air; \unitless}
+ * @symrow{0.02; Available heat fraction factor; \unitless}
+ * @symrow{T_{flue}; Flue gas temperature; \degreeFahrenheit}
+ * @symrow{60; Ambient reference temperature; \degreeFahrenheit}
+ * @symrow{980; Available heat temperature divisor; \degreeFahrenheit}
+ * @symrow{100; Conversion factor to percentage; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_fuel_consumption_formula Fuel Consumption with O2 Enrichment Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Fuel consumption with oxygen enrichment.
+ * @details The fuel consumption with oxygen enrichment is calculated by adjusting the baseline fuel consumption based on the ratio of standard available heat to the available heat with enrichment. As the available heat increases with enrichment, less fuel is required to deliver the same process heat.
+ *
+ * @formula{o2-enrichment-fuel-consumption; FC_{enriched} = FC_{base} \cdot \frac{AH_{std}}{AH_{enriched}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{FC_{enriched}; Fuel consumption with O2 enrichment; \mega\btu\per\hour}
+ * @symrow{FC_{base}; Baseline fuel consumption; \mega\btu\per\hour}
+ * @symrow{AH_{std}; Standard available heat (baseline); \percent}
+ * @symrow{AH_{enriched}; Available heat with O2 enrichment; \percent}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup o2_enrichment_fuel_savings_formula Fuel Savings with O2 Enrichment Formula
+ * @ingroup o2_enrichment_calculator
+ * @brief Fuel savings with oxygen enrichment as a percentage.
+ * @details The fuel savings represents the percentage reduction in fuel consumption achieved through oxygen enrichment. It is calculated as the difference between baseline and enriched fuel consumption divided by the baseline, expressed as a percentage.
+ *
+ * @formula{o2-enrichment-fuel-savings; FS = \frac{FC_{base} - FC_{enriched}}{FC_{base}} \cdot 100}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{FS; Fuel savings with O2 enrichment; \percent}
+ * @symrow{FC_{base}; Baseline fuel consumption; \mega\btu\per\hour}
+ * @symrow{FC_{enriched}; Fuel consumption with O2 enrichment; \mega\btu\per\hour}
+ * @symrow{100; Conversion factor to percentage; \unitless}
+ * @endsymtable
+ */

package/docs/dox-content/calculators/processHeat/process_heat_calculator.dox

@@ -0,0 +1,50 @@
+/**
+ * @defgroup process_heat Process Heat Utilities
+ * @ingroup process_heat_calculators
+ * @brief Common utility functions for process heating calculations.
+ * @details This module provides reusable functions and helpers for process heating calculations, such as excess air, 
+ * available heat, and other shared logic. These functions are used across multiple process heat calculators to 
+ * ensure consistent calculations and reduce code duplication.
+ *
+ * @heading{Excess Air Calculation}
+ * @copydoc process_heat_excess_air_formula
+ *
+ * @see o2_enrichment_calculator
+ * @see solid_liquid_flue_gas_material_calculator
+ */
+
+/**
+ * @defgroup process_heat_excess_air_formula Excess Air from Flue Gas O2
+ * @ingroup process_heat
+ * @brief Calculate excess air from oxygen concentration in flue gas.
+ * @details The excess air is determined from the oxygen concentration in the flue gas using stoichiometric 
+ * relationships. The calculation accounts for the fact that excess oxygen in flue gas indicates incomplete 
+ * combustion air utilization. The formula uses empirical factors derived from combustion stoichiometry for 
+ * typical fuels.
+ *
+ * This calculation is a fundamental component used throughout process heat calculations, including:
+ * - O2 enrichment analysis (@ref o2_enrichment_calculator)
+ * - Solid/liquid flue gas material calculations (@ref solid_liquid_flue_gas_material_calculator)
+ *
+ * The formula provides a quick estimate of excess air based on measured flue gas oxygen content. For more 
+ * complex fuel compositions, iterative refinement may be applied (as in 
+ * @ref solid_liquid_flue_gas_material::calculateExcessAirFromFlueGasO2).
+ *
+ * @formula{process-heat-excess-air; EA = \frac{k_1 \cdot O_{2,flue}}{2 - k_2 \cdot O_{2,flue}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{EA; Excess air; \unitless}
+ * @symrow{O_{2,flue}; Oxygen in flue gas; \unitless}
+ * @symrow{k_1; Stoichiometric air factor (8.52381); \unitless}
+ * @symrow{k_2; Oxygen flue gas factor (9.52381); \unitless}
+ * @endsymtable
+ *
+ * @subheading{Implementation}
+ * The function is implemented in the @ref process_heat namespace:
+ * @code{.cpp}
+ * double excess_air = process_heat::calculateExcessAir(o2_flue_gas_fraction);
+ * @endcode
+ *
+ * @note Input oxygen should be provided as a fraction (not percentage). For example, 3% O2 should be passed as 0.03.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "measur-tools-suite",
-  "version": "1.0.14-beta.268",
+  "version": "1.0.14-beta.283",
   "engines": {
     "node": "20.19.4",
     "npm": "10.8.2"