measur-tools-suite 1.0.14-beta.214 → 1.0.14-beta.221

package/bin/package.json

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

package/docs/dox-content/calculators/atmosphere_heat_loss_calculator.dox

@@ -16,7 +16,8 @@
  * @copydoc atmosphere_heat_loss_formula
  *
  * @heading{Specific Heat Values}
- * @copydoc atmosphere_specific_heat_values
+ * @copydoc gas_type_data
+ * see gas_type_data
  */
 
 /**
@@ -38,18 +39,4 @@
  * @symrow{T_\text{in}; Inlet temperature of gas; \degreeFahrenheit}
  * @symrow{f_\text{corr}; Correction factor; \unitless}
  * @endsymtable
- */
-
-/**
- * @defgroup atmosphere_specific_heat_values Atmosphere Specific Heat Values
- * @ingroup atmosphere_heat_loss_calculator
- * Reference temperature: @qty{60; \degreeFahrenheit}
- * | Gas Type        | Specific Heat @unitb{\btu\per\standardCubicFeet\degreeFahrenheit} |
- * | --------------- | ----------------------------------------------------------------- |
- * | Nitrogen        | 0.0185                                                            |
- * | Hydrogen        | 0.0182                                                            |
- * | Exothermic Gas  | 0.0185                                                            |
- * | Endothermic Gas | 0.0185                                                            |
- * | Air             | 0.0184                                                            |
- * | Water Vapor     | 0.0212                                                            |
  */

package/docs/dox-content/calculators/gas_flue_gas_calculator.dox

@@ -1,141 +1,300 @@
 /**
  * @defgroup gas_flue_gas_material_calculator Gas Flue Gas Material Calculator
  * @ingroup heat_loss_calculators
- * @brief Stepwise algorithm for calculating process heat properties and available heat for flue gas materials.
- * @details This document presents the algorithm implemented in processHeatProperties (see gas_flue_gas_material.cpp), with each step annotated, formulae provided, and all symbols defined. The calculation covers excess air, flue gas O2, constituent Cp, generated product weights/volumes, enthalpy, and available heat. All variables use snake_case.
- *
- * @heading{Algorithm Steps}
-* @subheading{Step 1: Excess Air and Flue Gas O2}
-*   If excess air fraction (EA) is provided calculate @math{O_2}:
-*     @formula{gas-flue-gas-material-excess-air-cpp; O_2 = f_{O_2}(EA)}
-*   Else calculate excess air (EA) given @math{O_2}:
-*     @formula{gas-flue-gas-material-excess-air-cpp-2; EA = f_{EA}(O_2)}
-*   @symtable
-*     @symrow{EA; Excess air percent; \percent}
-*     @symrow{f_{O_2}(EA); @ref gas_composition_estimate_excess_air_from_o2_cpp_formula; \unitless}
-*     @symrow{O_2; Flue gas oxygen percentage; \percent}
-*     @symrow{f_{EA}(O_2); @ref gas_composition_o2_percentage_from_excess_air_cpp_formula; \unitless}
-*   @endsymtable
- *
- * @subheading{Step 2: Temperature Conversion}
- *   Convert input temperatures to absolute (Rankine) for specific heat calculations:
- *     @formula{gas-flue-gas-material-temp-conv-cpp; T_{abs} = T_{F} + 460}
- *   @symtable
- *     @symrow{T_{abs}; Absolute temperature; \degreeRankine}
- *     @symrow{T_{F}; Temperature in Fahrenheit; \degreeFahrenheit}
- *   @endsymtable
- *
- *
-* @subheading{Step 3: Constituent Specific Heats (Cp)}
-*   For each major constituent, calculate Cp at both initial and final temperature:
-*     @formula{gas-flue-gas-material-cp-o2-cpp; Cp_{O_2}(T) = 11.515 - \frac{172.0}{\sqrt{T}} + \frac{1530.0}{T}}
-*     @formula{gas-flue-gas-material-cp-n2-cpp; Cp_{N_2}(T) = 9.47 - \frac{3470.0}{T} + \frac{1.07 \times 10^6}{T^2}}
-*     @formula{gas-flue-gas-material-cp-h2o-cpp; Cp_{H_2O}(T) = 19.86 - \frac{597.0}{\sqrt{T}} + \frac{7500.0}{T}}
-*     @formula{gas-flue-gas-material-cp-co2-cpp; Cp_{CO_2}(T) = \frac{16.2 - \frac{6530.0}{T} + \frac{1.41 \times 10^6}{T^2}}{44.0}}
-*   where @math{T} is either the initial or final absolute temperature (Rankine).\n
-*    @formula{gas-flue-gas-avg-cp; \overline{Cp} = \frac{Cp(T_{initial}) + Cp(T_{final})}{2}}
-*   @symtable
-*     @symrow{Cp_{i}(T); Specific heat of constituent @math{i} at temperature @math{T}; \btu\per\pound\degreeFahrenheit}
-*     @symrow{T_{initial}, T_{final}; Initial and final absolute temperature (Rankine); \degreeRankine}
-*     @symrow{\overline{Cp}; Average specific heat over temperature range; \btu\per\pound\degreeFahrenheit}
-*   @endsymtable
- *
-* @subheading{Step 4: Mean Cp for Combustion Air}
- *   Weighted average for O2, N2, H2O at initial and final temperatures.
- *   Linear Cp coefficients for combustion air:
- *     @formula{gas-flue-gas-material-cp-linear-cpp; Cp_{mean} = a + b \cdot T}
- *   @symtable
- *     @symrow{Cp_{mean}; Mean specific heat; \btu\per\pound\degreeFahrenheit}
- *     @symrow{a, b; Linear coefficients; \unitless}
- *     @symrow{T; Temperature; \degreeFahrenheit}
- *   @endsymtable
- *
-* @subheading{Step 5: Fuel and Product Aggregation}
- *   Aggregate fuel heating value and generated weights:
- *     @formula{gas-flue-gas-material-co2-gen-wt-cpp; W_{CO_2} = \sum_i x_i \cdot w_{CO_2,i}}
- *     @formula{gas-flue-gas-material-h2o-gen-wt-cpp; W_{H_2O} = \sum_i x_i \cdot w_{H_2O,i} + \text{combustion air moisture}}
- *     @formula{gas-flue-gas-material-o2-gen-wt-cpp; W_{O_2} = \text{from excess air}}
- *     @formula{gas-flue-gas-material-n2-gen-wt-cpp; W_{N_2} = \text{from air fraction}}
- *   @symtable
- *     @symrow{W_{i}; Generated weight of constituent i; \pound\per\MMBtu}
- *     @symrow{x_i; Volume fraction of fuel constituent i; \unitless}
- *     @symrow{w_{i}; Weight generated per constituent i; \pound\per\cubicFoot}
- *   @endsymtable
- *
-* @subheading{Step 6: Generated Volumes and Unit Conversion}
- *   Convert generated weights to volumes:
- *     @formula{gas-flue-gas-material-co2-gen-vol-cpp; V_{CO_2} = W_{CO_2} \cdot 0.022722}
- *     @formula{gas-flue-gas-material-h2o-gen-vol-cpp; V_{H_2O} = W_{H_2O} \cdot 0.055506}
- *   @symtable
- *     @symrow{V_{i}; Generated volume of constituent i; \cubicFoot\per\MMBtu}
- *   @endsymtable
- *
-* @subheading{Step 7: Stoichiometric Air and Moisture Correction}
- *   Calculate stoichiometric air required:
- *     @formula{gas-flue-gas-material-stoich-air-cpp; Air_{stoich} = W_{O_2} \cdot \left(1 + \frac{1 - f_{O_2}}{f_{O_2}}\right)}
- *   Combustion air moisture correction:
- *     @formula{gas-flue-gas-material-moisture-corr-cpp; Moisture_{corr} = (M_{perc} - 0.009) \cdot Air_{stoich} \cdot 0.0763}
- *   @symtable
- *     @symrow{Air_{stoich}; Stoichiometric air; \pound\per\MMBtu}
- *     @symrow{M_{perc}; Combustion air moisture percent; \percent}
- *   @endsymtable
- *
-* @subheading{Step 8: Partial Pressure of Water Vapor}
- *   @formula{gas-flue-gas-material-partial-pressure-h2o-cpp; P_{H_2O} = \frac{V_{H_2O}}{V_{CO_2} + V_{H_2O} + V_{O_2} + V_{N_2}}}
- *   @symtable
- *     @symrow{P_{H_2O}; Partial pressure of water vapor; \unitless}
- *   @endsymtable
- *
-* @subheading{Step 9: Enthalpy and Heat Content}
- *   For each constituent:
- *     @formula{gas-flue-gas-material-enthalpy-h2o-cpp; H_{H_2O} = (h_{sat} + Cp_{H_2O} \cdot (T_{fg} - T_{sat})) \cdot 100 \cdot W_{H_2O}}
- *     @formula{gas-flue-gas-material-heat-content-co2-cpp; H_{CO_2} = Cp_{CO_2} \cdot \Delta T_{fg,amb} \cdot 100 \cdot W_{CO_2}}
- *     @formula{gas-flue-gas-material-heat-content-n2-cpp; H_{N_2} = Cp_{N_2} \cdot \Delta T_{fg,amb} \cdot 100 \cdot W_{N_2}}
- *     @formula{gas-flue-gas-material-heat-content-o2-cpp; H_{O_2} = Cp_{O_2} \cdot \Delta T_{fg,amb} \cdot 100 \cdot W_{O_2}}
- *   @symtable
- *     @symrow{H_{i}; Heat content of constituent i; \btu\per\hour}
-*     @symrow{h_{sat}; Enthalpy at saturation (see @ref gas_composition_calculate_enthalpy_at_saturation_cpp_formula); \btu\per\pound}
-*     @symrow{T_{sat}; Saturation temperature (see @ref gas_composition_calculate_saturation_temperature_cpp_formula); \degreeFahrenheit}
-*     @symrow{\Delta T_{fg,amb}; Flue gas temperature rise above ambient (@math{T_{fg} - T_{amb}}); \degreeFahrenheit}
- *   @endsymtable
- *
- *
- *
-* @subheading{Step 10: Preheated Combustion Air and Moisture Effects}
- *   Heat in preheated combustion air:
- *     @formula{gas-flue-gas-material-preheat-air-cpp; Q_{preheat,air} = Air_{stoich} \cdot (1 + EA) \cdot ((T_{mean}) \cdot b + a) \cdot (T_{comb} - T_{amb})}
- *   Heat content of air moisture:
- *     @formula{gas-flue-gas-material-preheat-moisture-cpp; Q_{preheat,moisture} = Moisture_{corr} \cdot Cp_{H_2O} \cdot (T_{fg} - T_{comb})}
- *   @symtable
- *     @symrow{Q_{preheat,air}; Heat in preheated combustion air; \btu\per\hour}
- *     @symrow{Q_{preheat,moisture}; Heat content of air moisture; \btu\per\hour}
- *     @symrow{T_{comb}; Combustion air temperature; \degreeFahrenheit}
- *   @endsymtable
- *
-* @subheading{Step 11: Total Generated Products and Weighted Cp}
- *   Total generated products:
- *     @formula{gas-flue-gas-material-total-gen-cpp; W_{prod} = W_{CO_2} + W_{H_2O} + W_{O_2} + W_{N_2}}
- *   Weighted average specific heat:
- *     @formula{gas-flue-gas-material-weighted-cp-cpp; Cp_{fg} = \frac{W_{CO_2} \cdot Cp_{CO_2} + W_{H_2O} \cdot Cp_{H_2O} + W_{O_2} \cdot Cp_{O_2} + W_{N_2} \cdot Cp_{N_2}}{W_{prod}}}
- *   @symtable
- *     @symrow{Cp_{fg}; Specific heat of flue gas; \btu\per\pound\degreeFahrenheit}
- *     @symrow{W_{prod}; Total generated product weight; \pound\per\MMBtu}
- *   @endsymtable
- *
-* @subheading{Step 12: Sensible Heat of Fuel}
- *   @formula{gas-flue-gas-material-sensible-heat-cpp; Q_{sens} = Cp_{fg} \cdot (T_{fuel} - T_{amb})}
- *   @symtable
- *     @symrow{Q_{sens}; Sensible heat of fuel; \btu\per\hour}
- *     @symrow{T_{fuel}; Fuel temperature; \degreeFahrenheit}
- *   @endsymtable
- *
-* @subheading{Step 13: Available Heat Calculation}
- *   @formula{gas-flue-gas-material-available-heat-cpp; Q_{avail} = \frac{100 \cdot (Q_{sens} + H_{fuel} + Q_{preheat,air} + Q_{preheat,moisture}) - (H_{H_2O} + H_{CO_2} + H_{N_2} + H_{O_2})}{100 \cdot H_{fuel}}}
- *   @symtable
- *     @symrow{Q_{avail}; Available heat; \btu\per\hour}
- *     @symrow{H_{fuel}; Heating value of fuel; \btu\per\cubicFoot}
- *   @endsymtable
+ * @brief Calculates process heat properties and available heat for gas fuel flue gas materials.
+ * @details This calculator estimates the available heat and heat losses for gas fuel combustion by analyzing flue gas 
+ * composition, excess air, constituent properties, and enthalpy of products. The algorithm accounts for stoichiometry, 
+ * temperature-dependent specific heats, and moisture effects to determine the percentage of fuel energy available for 
+ * useful work after exhaust losses.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Available Heat** - Calculate percentage of fuel energy available after exhaust losses
+ * 2. **Enthalpy and Heat Content** - Determine heat content of each flue gas constituent
+ * 3. **Fuel and Product Aggregation** - Sum fuel heating value and generated product weights/volumes
+ * 4. **Constituent Specific Heats** - Calculate temperature-dependent specific heat for each gas
+ * 5. **Excess Air and Flue Gas O2** - Determine excess air from O2 measurement or vice versa
+ * 6. **Temperature Conversion** - Convert temperatures to absolute scale for thermodynamic calculations
+ *
+ * Each step is documented with formulas and complete symbol tables.
+ *
+ * @heading{Available Heat Calculation}
+ * @copydoc gas_flue_gas_material_available_heat_formula
+ *
+ * @heading{Sensible Heat of Fuel}
+ * @copydoc gas_flue_gas_material_sensible_heat_formula
+ *
+ * @heading{Enthalpy and Heat Content}
+ * @copydoc gas_flue_gas_material_enthalpy_formula
+ *
+ * @heading{Partial Pressure of Water Vapor}
+ * @copydoc gas_flue_gas_material_partial_pressure_formula
+ *
+ * @heading{Stoichiometric Air and Moisture Correction}
+ * @copydoc gas_flue_gas_material_stoichiometric_air_formula
+ *
+ * @heading{Generated Volumes and Unit Conversion}
+ * @copydoc gas_flue_gas_material_generated_volumes_formula
+ *
+ * @heading{Fuel and Product Aggregation}
+ * @copydoc gas_flue_gas_material_aggregation_formula
+ *
+ * @heading{Mean Cp for Combustion Air}
+ * @copydoc gas_flue_gas_material_mean_cp_formula
+ *
+ * @heading{Constituent Specific Heats}
+ * @copydoc gas_flue_gas_material_specific_heats_formula
+ *
+ * @heading{Temperature Conversion}
+ * @copydoc gas_flue_gas_material_temperature_conversion_formula
+ *
+ * @heading{Excess Air and Flue Gas O2}
+ * @copydoc gas_flue_gas_material_excess_air_formula
  *
  * @see gas_flue_gas_material_data_database
  * @see gas_constants for molecular weights, specific heat formulas, and stoichiometric constants
  */
+
+/**
+ * @defgroup gas_flue_gas_material_available_heat_formula Available Heat Calculation
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate percentage of fuel energy available after exhaust losses.
+ * @details The available heat represents the fraction of input fuel energy that remains for useful work after 
+ * accounting for sensible and latent heat losses in the flue gas. It includes contributions from fuel sensible heat, 
+ * preheated air, and moisture, minus the enthalpy carried away by flue gas constituents.
+ *
+ * @formula{gas-flue-gas-material-available-heat-cpp; Q_{avail} = \frac{100 \cdot (Q_{sens} + H_{fuel} + Q_{preheat,air} + Q_{preheat,moisture}) - (H_{H_2O} + H_{CO_2} + H_{N_2} + H_{O_2})}{100 \cdot H_{fuel}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Q_{avail}; Available heat percentage; \percent}
+ * @symrow{Q_{sens}; Sensible heat of fuel; \btu\per\hour}
+ * @symrow{H_{fuel}; Heating value of fuel; \btu\per\cubicFoot}
+ * @symrow{Q_{preheat,air}; Sensible heat of preheated combustion air; \btu\per\hour}
+ * @symrow{Q_{preheat,moisture}; Sensible heat of moisture in combustion air; \btu\per\hour}
+ * @symrow{H_{H_2O}; Heat content of water vapor in flue gas; \btu\per\hour}
+ * @symrow{H_{CO_2}; Heat content of CO2 in flue gas; \btu\per\hour}
+ * @symrow{H_{N_2}; Heat content of N2 in flue gas; \btu\per\hour}
+ * @symrow{H_{O_2}; Heat content of O2 in flue gas; \btu\per\hour}
+ * @symrow{100; Percentage conversion factor; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_sensible_heat_formula Sensible Heat of Fuel
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate sensible heat contribution from fuel temperature above ambient.
+ * @details When fuel enters at a temperature above ambient, it contributes additional sensible heat to the system. 
+ * This heat is calculated using the flue gas specific heat and temperature difference.
+ *
+ * @formula{gas-flue-gas-material-sensible-heat-cpp; Q_{sens} = Cp_{fg} \cdot (T_{fuel} - T_{amb})}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Q_{sens}; Sensible heat of fuel; \btu\per\hour}
+ * @symrow{Cp_{fg}; Specific heat of flue gas; \btu\per\pound\degreeFahrenheit}
+ * @symrow{T_{fuel}; Fuel temperature; \degreeFahrenheit}
+ * @symrow{T_{amb}; Ambient temperature; \degreeFahrenheit}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_enthalpy_formula Enthalpy and Heat Content
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate heat content of each flue gas constituent.
+ * @details For each constituent in the flue gas, calculate the enthalpy or heat content based on temperature and 
+ * mass flow. Water vapor requires special treatment due to latent heat of condensation.
+ *
+ * @subheading{Water Vapor Enthalpy}
+ * @formula{gas-flue-gas-material-enthalpy-h2o-cpp; H_{H_2O} = (h_{sat} + Cp_{H_2O} \cdot (T_{fg} - T_{sat})) \cdot 100 \cdot W_{H_2O}}
+ *
+ * @subheading{Dry Gas Heat Content}
+ * @formula{gas-flue-gas-material-heat-content-co2-cpp; H_{CO_2} = Cp_{CO_2} \cdot \Delta T_{fg,amb} \cdot 100 \cdot W_{CO_2}}
+ * @formula{gas-flue-gas-material-heat-content-n2-cpp; H_{N_2} = Cp_{N_2} \cdot \Delta T_{fg,amb} \cdot 100 \cdot W_{N_2}}
+ * @formula{gas-flue-gas-material-heat-content-o2-cpp; H_{O_2} = Cp_{O_2} \cdot \Delta T_{fg,amb} \cdot 100 \cdot W_{O_2}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{H_{i}; Heat content of constituent i; \btu\per\hour}
+ * @symrow{h_{sat}; Enthalpy at saturation - see @ref gas_composition_calculate_enthalpy_at_saturation_cpp_formula; \btu\per\pound}
+ * @symrow{T_{sat}; Saturation temperature - see @ref gas_composition_calculate_saturation_temperature_cpp_formula; \degreeFahrenheit}
+ * @symrow{Cp_{i}; Specific heat of constituent i; \btu\per\pound\degreeFahrenheit}
+ * @symrow{T_{fg}; Flue gas temperature; \degreeFahrenheit}
+ * @symrow{T_{amb}; Ambient temperature; \degreeFahrenheit}
+ * @symrow{\Delta T_{fg,amb}; Flue gas temperature rise above ambient (T_{fg} - T_{amb}); \degreeFahrenheit}
+ * @symrow{W_{i}; Generated weight of constituent i; \pound\per\MMBtu}
+ * @symrow{100; Conversion factor; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_partial_pressure_formula Partial Pressure of Water Vapor
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate mole fraction of water vapor in flue gas.
+ * @details The partial pressure (mole fraction) of water vapor is needed to determine saturation temperature and 
+ * enthalpy for latent heat calculations.
+ *
+ * @formula{gas-flue-gas-material-partial-pressure-h2o-cpp; P_{H_2O} = \frac{V_{H_2O}}{V_{CO_2} + V_{H_2O} + V_{O_2} + V_{N_2}}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{P_{H_2O}; Partial pressure (mole fraction) of water vapor; \unitless}
+ * @symrow{V_{H_2O}; Generated volume of water vapor; \cubicFoot\per\MMBtu}
+ * @symrow{V_{CO_2}; Generated volume of CO2; \cubicFoot\per\MMBtu}
+ * @symrow{V_{O_2}; Generated volume of O2; \cubicFoot\per\MMBtu}
+ * @symrow{V_{N_2}; Generated volume of N2; \cubicFoot\per\MMBtu}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_stoichiometric_air_formula Stoichiometric Air and Moisture Correction
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate stoichiometric air required and moisture correction.
+ * @details Stoichiometric air is the theoretical minimum air required for complete combustion. The moisture correction 
+ * accounts for water vapor in the combustion air.
+ *
+ * @subheading{Stoichiometric Air}
+ * @formula{gas-flue-gas-material-stoich-air-cpp; Air_{stoich} = W_{O_2} \cdot \left(1 + \frac{1 - f_{O_2}}{f_{O_2}}\right)}
+ *
+ * @subheading{Moisture Correction}
+ * @formula{gas-flue-gas-material-moisture-corr-cpp; Moisture_{corr} = (M_{perc} - 0.009) \cdot Air_{stoich} \cdot 0.0763}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Air_{stoich}; Stoichiometric air required; \pound\per\MMBtu}
+ * @symrow{W_{O_2}; Generated weight of O2; \pound\per\MMBtu}
+ * @symrow{f_{O_2}; Oxygen mass fraction in air; \unitless}
+ * @symrow{Moisture_{corr}; Moisture correction for combustion air; \pound\per\MMBtu}
+ * @symrow{M_{perc}; Combustion air moisture percent; \percent}
+ * @symrow{0.009; Reference moisture content; \unitless}
+ * @symrow{0.0763; Moisture correction factor; \unitless}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_generated_volumes_formula Generated Volumes and Unit Conversion
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Convert generated weights to volumes using density factors.
+ * @details Convert mass of combustion products to volumetric flow rates for partial pressure calculations. 
+ * Conversion factors are based on standard conditions.
+ *
+ * @formula{gas-flue-gas-material-co2-gen-vol-cpp; V_{CO_2} = W_{CO_2} \cdot 0.022722}
+ * @formula{gas-flue-gas-material-h2o-gen-vol-cpp; V_{H_2O} = W_{H_2O} \cdot 0.055506}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{V_{i}; Generated volume of constituent i; \cubicFoot\per\MMBtu}
+ * @symrow{W_{i}; Generated weight of constituent i; \pound\per\MMBtu}
+ * @symrow{0.022722; CO2 weight-to-volume conversion factor; \cubicFoot\per\pound}
+ * @symrow{0.055506; H2O weight-to-volume conversion factor; \cubicFoot\per\pound}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_aggregation_formula Fuel and Product Aggregation
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Sum fuel heating value and generated product weights.
+ * @details Aggregate contributions from each fuel constituent to determine total fuel properties and combustion products. 
+ * The generated weights account for stoichiometry and excess air.
+ *
+ * @formula{gas-flue-gas-material-co2-gen-wt-cpp; W_{CO_2} = \sum_i x_i \cdot w_{CO_2,i}}
+ * @formula{gas-flue-gas-material-h2o-gen-wt-cpp; W_{H_2O} = \sum_i x_i \cdot w_{H_2O,i} + \text{combustion air moisture}}
+ * @formula{gas-flue-gas-material-o2-gen-wt-cpp; W_{O_2} = \text{from excess air}}
+ * @formula{gas-flue-gas-material-n2-gen-wt-cpp; W_{N_2} = \text{from air fraction}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{W_{i}; Generated weight of constituent i; \pound\per\MMBtu}
+ * @symrow{x_i; Volume fraction of fuel constituent i; \unitless}
+ * @symrow{w_{i,j}; Weight of product j generated per unit of fuel constituent i; \pound\per\cubicFoot}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_mean_cp_formula Mean Cp for Combustion Air
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate weighted average specific heat for combustion air.
+ * @details The mean specific heat of combustion air is approximated using a linear correlation with temperature. 
+ * This accounts for the temperature-dependent properties of O2, N2, and H2O in the air.
+ *
+ * @formula{gas-flue-gas-material-cp-linear-cpp; Cp_{mean} = a + b \cdot T}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Cp_{mean}; Mean specific heat of combustion air; \btu\per\pound\degreeFahrenheit}
+ * @symrow{a; Linear coefficient (intercept); \btu\per\pound\degreeFahrenheit}
+ * @symrow{b; Linear coefficient (slope); \btu\per\pound\degreeFahrenheit\squared}
+ * @symrow{T; Temperature; \degreeFahrenheit}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_specific_heats_formula Constituent Specific Heats
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate temperature-dependent specific heat for each gas constituent.
+ * @details For each major constituent in the flue gas, calculate specific heat at both initial and final temperature 
+ * using empirical correlations. The average specific heat over the temperature range is used for enthalpy calculations. 
+ * See @ref gas_constants for the specific heat formulas and coefficients.
+ *
+ * @subheading{Oxygen}
+ * @formula{gas-flue-gas-material-cp-o2-cpp; Cp_{O_2}(T) = 11.515 - \frac{172.0}{\sqrt{T}} + \frac{1530.0}{T}}
+ *
+ * @subheading{Nitrogen}
+ * @formula{gas-flue-gas-material-cp-n2-cpp; Cp_{N_2}(T) = 9.47 - \frac{3470.0}{T} + \frac{1.07 \times 10^6}{T^2}}
+ *
+ * @subheading{Water Vapor}
+ * @formula{gas-flue-gas-material-cp-h2o-cpp; Cp_{H_2O}(T) = 19.86 - \frac{597.0}{\sqrt{T}} + \frac{7500.0}{T}}
+ *
+ * @subheading{Carbon Dioxide}
+ * @formula{gas-flue-gas-material-cp-co2-cpp; Cp_{CO_2}(T) = \frac{16.2 - \frac{6530.0}{T} + \frac{1.41 \times 10^6}{T^2}}{44.0}}
+ *
+ * @subheading{Average Specific Heat}
+ * @formula{gas-flue-gas-avg-cp; \overline{Cp} = \frac{Cp(T_{initial}) + Cp(T_{final})}{2}}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Cp_{i}(T); Specific heat of constituent i at temperature T; \btu\per\pound\degreeFahrenheit}
+ * @symrow{T; Absolute temperature; \degreeRankine}
+ * @symrow{T_{initial}; Initial absolute temperature; \degreeRankine}
+ * @symrow{T_{final}; Final absolute temperature; \degreeRankine}
+ * @symrow{\overline{Cp}; Average specific heat over temperature range; \btu\per\pound\degreeFahrenheit}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_temperature_conversion_formula Temperature Conversion
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Convert temperatures to absolute scale for thermodynamic calculations.
+ * @details All thermodynamic properties require absolute temperature. Convert Fahrenheit to Rankine by adding the 
+ * offset constant. See @ref physics::conversions::kFahrenheitToRankineOffset for the conversion constant.
+ *
+ * @formula{gas-flue-gas-material-temp-conv-cpp; T_{abs} = T_{F} + 460}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{T_{abs}; Absolute temperature; \degreeRankine}
+ * @symrow{T_{F}; Temperature in Fahrenheit; \degreeFahrenheit}
+ * @symrow{460; Fahrenheit to Rankine offset - see @ref physics::conversions::kFahrenheitToRankineOffset; \degreeRankine}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup gas_flue_gas_material_excess_air_formula Excess Air and Flue Gas O2
+ * @ingroup gas_flue_gas_material_calculator
+ * @brief Calculate excess air from O2 measurement or O2 from excess air.
+ * @details The relationship between excess air and flue gas oxygen content allows determination of one from the other. 
+ * See @ref gas_composition for detailed formulas.
+ *
+ * @subheading{O2 from Excess Air}
+ * @formula{gas-flue-gas-material-excess-air-cpp; O_2 = f_{O_2}(EA)}
+ *
+ * @subheading{Excess Air from O2}
+ * @formula{gas-flue-gas-material-excess-air-cpp-2; EA = f_{EA}(O_2)}
+ *
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{EA; Excess air percent; \percent}
+ * @symrow{O_2; Flue gas oxygen percentage; \percent}
+ * @symrow{f_{O_2}(EA); Function to estimate O2 from excess air - see @ref gas_composition_o2_percentage_from_excess_air_cpp_formula; \unitless}
+ * @symrow{f_{EA}(O_2); Function to estimate excess air from O2 - see @ref gas_composition_estimate_excess_air_from_o2_cpp_formula; \unitless}
+ * @endsymtable
+ */

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

@@ -1,17 +1,22 @@
-
 /**
  * @defgroup solid_liquid_flue_gas_material_calculator Solid/Liquid Flue Gas Material Calculator
  * @ingroup heat_loss_calculators
- * @brief Stepwise algorithm for calculating process heat properties and available heat for solid/liquid flue gas materials.
- * @details
- * This page documents the engineering algorithms for solid and liquid fuel flue gas analysis, including:
+ * @brief Calculates process heat properties and available heat for solid and liquid fuel flue gas materials.
+ * @details This calculator estimates the available heat and heat losses for solid and liquid fuel combustion by analyzing 
+ * flue gas composition, excess air, stoichiometry, and enthalpy of reactants and products. The algorithm accounts for 
+ * sensible, latent, unburned carbon, and ash losses to determine the percentage of fuel energy available for useful work.
  *
- * - **Total Heat Loss & Available Heat:** Calculates the total heat loss and available heat from combustion by accounting for fuel/air composition, enthalpy of reactants and products, stoichiometry, flue gas constituents, and all major loss mechanisms (sensible, latent, unburned carbon, and ash).
- * - **Excess Air Determination:** Provides an iterative method to estimate the fraction of excess air supplied to the combustion process based on measured flue gas oxygen and fuel composition.
- * - **Flue Gas Oxygen Calculation:** Computes the expected oxygen content in the flue gas for a given excess air level and fuel composition, using stoichiometric and mass balance relationships.
- * - **Fuel Heating Value:** Calculates the higher heating value of a solid or liquid fuel as a weighted sum of elemental contributions (carbon, hydrogen, sulphur).
+ * The calculation follows a top-down approach:
+ * 1. **Available Heat** - Calculate percentage of fuel energy available after all losses
+ * 2. **Input Heat** - Sum sensible heat of fuel, combustion air, heating value, and moisture heat
+ * 3. **Flue Gas Heat Loss** - Calculate sensible and latent heat in exhaust products
+ * 4. **Other Losses** - Account for moisture, unburned carbon, and ash losses
+ * 5. **Flue Gas Components** - Determine mass of each combustion product
+ * 6. **Stoichiometric Air** - Calculate theoretical air requirements from fuel composition
+ * 7. **Fuel Composition Normalization** - Convert fuel analysis percentages to fractions
  *
- * Each section presents stepwise formulas, symbol tables, and engineering context for practical application in combustion system analysis, energy auditing, and process optimization.
+ * Each section presents formulas with complete symbol tables and engineering context for practical application in 
+ * combustion system analysis, energy auditing, and process optimization.
  *
  * @heading{Flue Gas Heat Loss Calculation}
  * @copydoc solid_liquid_flue_gas_heat_loss_formula
@@ -24,236 +29,302 @@
  *
  * @heading{Heating Value Calculation}
  * @copydoc solid_liquid_flue_gas_hv_calc
+ *
+ * @see solid_liquid_flue_gas_material_data_database
+ * @see gas_constants for molecular weights, specific heat formulas, and stoichiometric constants
  */
 
 /**
  * @defgroup solid_liquid_flue_gas_heat_loss_formula Total Solid/Liquid Flue Gas: Heat Loss
  * @ingroup solid_liquid_flue_gas_material_calculator
  * @brief Algorithm for calculating total heat loss and available heat for solid/liquid flue gas materials.
- * @details This section documents the algorithm implemented in total heat loss of solid/liquid flue gas, including normalization, enthalpy calculations, stoichiometry, flue gas component analysis, and available heat computation. Each step is annotated with formulas and symbol tables for clarity.
- * @subheading{Step 1: Normalize Fuel Composition}
- *   Normalize all fuel composition inputs to fractions:
- *     @formula{slfgm-norm-fuel; x_i = \frac{X_i}{\sum_j X_j}}
- *   where @math{X_i} is the percent of constituent @math{i} in the fuel.
- *   @symtable
- *     @symrow{x_i; Normalized fraction of constituent i; \unitless}
- *     @symrow{X_i; Percent of constituent i in fuel; \percent}
- *   @endsymtable
-
-* @subheading{Step 2: Fuel and Combustion Air Enthalpy}
-*   Calculate the sensible enthalpy of both the fuel and the combustion air:
-*     @formula{slfgm-h-fuel; h_{fuel} = C_{pfuel} \cdot (1 - x_{moisture}) \cdot (T_{fuel} - T_{amb})}
-*     @formula{slfgm-cp-comb-air; C_{p,air} = a + b \cdot T_{comb}}
-*     @formula{slfgm-h-comb-air; h_{comb,air} = M_{comb,air} \cdot C_{p,air} \cdot (T_{comb} - T_{amb}) / \rho_{air}}
-*   @symtable
-*     @symrow{h_{fuel}; Sensible enthalpy of fuel; \btu\per\hour}
-*     @symrow{C_{pfuel}; Specific heat of fuel; \btu\per\pound\degreeFahrenheit}
-*     @symrow{x_{moisture}; Moisture fraction in fuel; \unitless}
-*     @symrow{T_{fuel}; Fuel temperature; \degreeFahrenheit}
-*     @symrow{T_{amb}; Ambient air temperature; \degreeFahrenheit}
-*     @symrow{C_{p,air}; Specific heat of combustion air; \btu\per\pound\degreeFahrenheit}
-*     @symrow{T_{comb}; Combustion air temperature; \degreeFahrenheit}
-*     @symrow{h_{comb,air}; Sensible enthalpy of combustion air; \btu\per\hour}
-*     @symrow{M_{comb,air}; Mass of combustion air; \pound}
-*     @symrow{\rho_{air}; Density of air; \pound\per\cubicFoot}
-*   @endsymtable
- *
- *
- * @subheading{Step 3: Stoichiometric Air and Combustion Calculations}
- *   Calculate stoichiometric air required for combustion:
- *     @formula{slfgm-stoich-air; O2_{s,air} = x_C \cdot k_{C\to O_2} + x_H \cdot k_{H\to O_2} + x_S \cdot k_{S\to O_2} - x_{O_2}}
- *     @formula{slfgm-n2s-air; N2_{s,air} = O2_{s,air} \cdot k_{N_2/O_2}}
- *     @formula{slfgm-ms-air; M_{s,air} = O2_{s,air} + N2_{s,air}}
- *     @formula{slfgm-m-comb-air; M_{comb,air} = M_{s,air} \cdot (1 + EA)}
- *   @symtable
- *     @symrow{O2_{s,air}; Stoichiometric O2 required; \unitless}
- *     @symrow{N2_{s,air}; Stoichiometric N2 from air; \unitless}
- *     @symrow{M_{s,air}; Stoichiometric air; \unitless}
- *     @symrow{M_{comb,air}; Total combustion air; \unitless}
- *     @symrow{EA; Excess air fraction; \unitless}
- *   @endsymtable
- *
- * @subheading{Step 4: Flue Gas Components and Heating Value}
- *   Calculate mass of each flue gas component:
- *     @formula{slfgm-m-co2; m_{CO_2} = x_C \cdot k_{C\to CO_2}}
- *     @formula{slfgm-m-h2o; m_{H_2O} = x_H \cdot k_{H\to H_2O} + x_{moisture} + (M_{comb,air} \cdot M_{air,moisture}/100)}
- *     @formula{slfgm-m-so2; m_{SO_2} = x_S \cdot k_{S\to SO_2}}
- *     @formula{slfgm-m-o2; m_{O_2} = O2_{s,air} \cdot EA}
- *     @formula{slfgm-m-n2; m_{N_2} = N2_{s,air} \cdot (1 + EA)}
- *   Heating value:
- *     @formula{slfgm-hv; HV_{fuel} = x_C \cdot k_{HV,C} + x_H \cdot k_{HV,H} + x_S \cdot k_{HV,S}}
- *   @symtable
- *     @symrow{m_{i}; Mass of constituent i; \unitless}
- *     @symrow{HV_{fuel}; Heating value of fuel; \btu\per\pound}
- *   @endsymtable
- *
- * @subheading{Step 5: Partial Pressure of Water Vapor}
- *   @formula{slfgm-pp-h2o; p_{H_2O} = \frac{m_{H_2O}/0.047636}{m_{CO_2}/0.116367 + m_{H_2O}/0.047636 + m_{N_2}/0.074077 + m_{O_2}/0.084611 + m_{SO_2}/0.169381}}
- *   @symtable
- *     @symrow{p_{H_2O}; Partial pressure of water vapor; \unitless}
- *   @endsymtable
- *
- * @subheading{Step 6: Enthalpy of Saturated Steam}
- *   @formula{slfgm-h-sat; h_{sat} = 1096.7 \cdot (p_{H_2O} \cdot 29.926)^{0.013}}
- *   @symtable
- *     @symrow{h_{sat}; Enthalpy of saturated steam; \btu\per\pound}
- *     @symrow{p_{H_2O}; Partial pressure of water vapor; \unitless}
- *   @endsymtable
- *
- * @subheading{Step 7: Sensible Heat of Flue Gas Components}
- *   For each component:
- *     @formula{slfgm-h-sensible-co2; h_{CO_2} = m_{CO_2} \cdot \frac{Cp_{CO_2}}{MW_{CO_2}} \cdot (T_{fg} - T_{ref})}
- *     @formula{slfgm-h-sensible-h2o; h_{H_2O} = m_{H_2O,fuel} \cdot (h_{sat} + \frac{Cp_{H_2O}}{MW_{H_2O}} \cdot (T_{fg} - T_{ref})) + m_{H_2O,air} \cdot (\frac{Cp_{H_2O}}{MW_{H_2O}} \cdot (T_{fg} - T_{ref}))}
- *     @formula{slfgm-h-sensible-so2; h_{SO_2} = m_{SO_2} \cdot \frac{Cp_{SO_2}}{MW_{SO_2}} \cdot (T_{fg} - T_{ref})}
- *     @formula{slfgm-h-sensible-o2; h_{O_2} = m_{O_2} \cdot \frac{Cp_{O_2}}{MW_{O_2}} \cdot (T_{fg} - T_{ref})}
- *     @formula{slfgm-h-sensible-n2; h_{N_2} = m_{N_2} \cdot \frac{Cp_{N_2}}{MW_{N_2}} \cdot (T_{fg} - T_{ref})}
- *   Total sensible heat:
- *     @formula{slfgm-h-fg; h_{fg} = h_{H_2O} + h_{CO_2} + h_{N_2} + h_{O_2} + h_{SO_2}}
- *   @symtable
- *     @symrow{h_{i}; Sensible heat of constituent i; \btu\per\hour}
- *     @symrow{Cp_{i}; Specific heat of constituent i; \btu\per\pound\degreeFahrenheit}
- *     @symrow{MW_{i}; Molecular weight of constituent i; \pound\per\lbmol}
- *     @symrow{T_{fg}; Flue gas temperature; \degreeFahrenheit}
- *     @symrow{T_{ref}; Reference temperature (ambient); \degreeFahrenheit}
- *   @endsymtable
- *
- * @subheading{Step 8: Other Losses}
- *   Moisture, unburned carbon, and ash losses:
- *     @formula{slfgm-h-moisture; h_{moisture} = X_{moisture} \cdot (T_{fg} - T_{ref})}
- *     @formula{slfgm-h-carbon; h_{carbon} = 14093.0 \cdot X_{unburned,carbon} \cdot (X_{ash}/x_{fuel})}
- *     @formula{slfgm-h-ash; h_{ash} = (X_{ash}/x_{fuel}) \cdot 0.25 \cdot (1.8 \cdot T_{ash,discharge} + 32.0 - T_{ref})}
- *   @symtable
- *     @symrow{h_{moisture}; Heat loss due to moisture; \btu\per\hour}
- *     @symrow{h_{carbon}; Heat loss due to unburned carbon; \btu\per\hour}
- *     @symrow{h_{ash}; Heat loss due to ash; \btu\per\hour}
- *     @symrow{X_{moisture}; Moisture percent in fuel; \percent}
- *     @symrow{X_{unburned,carbon}; Unburned carbon in ash; \percent}
- *     @symrow{X_{ash}; Ash percent in fuel; \percent}
- *     @symrow{T_{ash,discharge}; Ash discharge temperature; \degreeFahrenheit}
- *   @endsymtable
- *
- * @subheading{Step 9: Input Heat}
- *   @formula{slfgm-h-in; h_{in} = h_{fuel} + h_{combustion,air} + HV_{fuel} + h_{moisture}}
- *   @symtable
- *     @symrow{h_{in}; Total input heat; \btu\per\hour}
- *     @symrow{h_{fuel}; Sensible heat in fuel; \btu\per\hour}
- *     @symrow{h_{combustion,air}; Sensible heat in combustion air; \btu\per\hour}
- *   @endsymtable
- *
- * @subheading{Step 10: Available Heat Calculation}
- *   @formula{slfgm-available-heat; Q_{avail} = \frac{h_{in} - h_{fg} - h_{ash} - h_{carbon}}{HV_{fuel}}}
- *   @symtable
- *     @symrow{Q_{avail}; Available heat fraction; \unitless}
- *   @endsymtable
+ * @details This section documents the complete algorithm for determining available heat from solid and liquid fuels. 
+ * The calculation includes normalization of fuel composition, enthalpy calculations for fuel and air inputs, 
+ * stoichiometric analysis, flue gas component analysis, and all major loss mechanisms.
  *
- * @see solid_liquid_flue_gas_material_data_database
-*/
- 
-/**
- * @defgroup solid_liquid_flue_gas_excess_air_calc Solid/Liquid Flue Gas: Excess Air Calculation
- * @ingroup solid_liquid_flue_gas_material_calculator
- * @brief Algorithm for calculating excess air from flue gas O2 for solid/liquid fuels.
- * @details Implements an iterative algorithm to estimate excess air given measured flue gas O2 and fuel composition.
- *
- * @subheading{Step 1: Normalize Fuel Composition}
- *   Normalize all fuel composition inputs to fractions:
- *     @formula{slfgm-norm-fuel-ea; x_i = \frac{X_i}{\sum_j X_j}}
- *   @symtable
- *     @symrow{x_i; Normalized fraction of constituent i; \unitless}
- *     @symrow{X_i; Percent of constituent i in fuel; \percent}
- *   @endsymtable
- *
- * @subheading{Step 2: Initial Estimate of Excess Air}
- *   Compute initial excess air estimate from flue gas O2:
- *     @formula{slfgm-ea-initial; EA_0 = \frac{a \cdot O_2}{b - (c \cdot O_2)}}
- *   where @math{a}, @math{b}, @math{c} are empirical constants.
- *   @symtable
- *     @symrow{EA_0; Initial excess air estimate; \unitless}
- *     @symrow{O_2; Flue gas oxygen percent; \percent}
- *   @endsymtable
- *
- * @subheading{Step 3: Iterative Refinement}
- *   Iteratively refine excess air estimate:
- *     @formula{slfgm-ea-iter; EA_{n+1} = EA_n \pm (EA_n \cdot 0.01)}
- *   until calculated O2 matches measured O2 within tolerance.
- *   @symtable
- *     @symrow{EA_n; Excess air at iteration n; \unitless}
- *   @endsymtable
- *
- * @note Uses calculateFlueGasO2 for O2 calculation in each iteration.
+ * @subheading{Available Heat Calculation}
+ * @brief Final available heat percentage after all losses.
+ * @details Available heat is the fraction of input fuel energy remaining for useful work after accounting for 
+ * sensible heat in flue gas, ash losses, and unburned carbon losses.
+ *
+ * @formula{slfgm-available-heat; Q_{avail} = \frac{h_{in} - h_{fg} - h_{ash} - h_{carbon}}{HV_{fuel}}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{Q_{avail}; Available heat fraction; \unitless}
+ * @symrow{h_{in}; Total input heat; \btu\per\pound}
+ * @symrow{h_{fg}; Total sensible heat in flue gas; \btu\per\pound}
+ * @symrow{h_{ash}; Heat loss due to ash; \btu\per\pound}
+ * @symrow{h_{carbon}; Heat loss due to unburned carbon; \btu\per\pound}
+ * @symrow{HV_{fuel}; Heating value of fuel; \btu\per\pound}
+ * @endsymtable
+ *
+ * @subheading{Input Heat}
+ * @brief Total heat input from fuel, combustion air, and moisture.
+ * @details Input heat includes the heating value of the fuel plus sensible heat contributions from elevated 
+ * fuel temperature, preheated combustion air, and fuel moisture.
+ *
+ * @formula{slfgm-h-in; h_{in} = h_{fuel} + h_{combustion,air} + HV_{fuel} + h_{moisture}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{h_{in}; Total input heat; \btu\per\pound}
+ * @symrow{h_{fuel}; Sensible heat in fuel; \btu\per\pound}
+ * @symrow{h_{combustion,air}; Sensible heat in combustion air; \btu\per\pound}
+ * @symrow{HV_{fuel}; Heating value of fuel; \btu\per\pound}
+ * @symrow{h_{moisture}; Heat required for fuel moisture; \btu\per\pound}
+ * @endsymtable
+ *
+ * @subheading{Sensible Heat of Flue Gas Components}
+ * @brief Calculate heat content of each flue gas constituent.
+ * @details For each component in the flue gas, calculate the sensible heat based on temperature rise and mass flow. 
+ * Water vapor requires special treatment for latent heat of condensation.
+ *
+ * @formula{slfgm-h-sensible-co2; h_{CO_2} = m_{CO_2} \cdot \frac{Cp_{CO_2}}{MW_{CO_2}} \cdot (T_{fg} - T_{ref})}
+ * @formula{slfgm-h-sensible-h2o; h_{H_2O} = m_{H_2O,fuel} \cdot (h_{sat} + \frac{Cp_{H_2O}}{MW_{H_2O}} \cdot (T_{fg} - T_{ref})) + m_{H_2O,air} \cdot (\frac{Cp_{H_2O}}{MW_{H_2O}} \cdot (T_{fg} - T_{ref}))}
+ * @formula{slfgm-h-sensible-so2; h_{SO_2} = m_{SO_2} \cdot \frac{Cp_{SO_2}}{MW_{SO_2}} \cdot (T_{fg} - T_{ref})}
+ * @formula{slfgm-h-sensible-o2; h_{O_2} = m_{O_2} \cdot \frac{Cp_{O_2}}{MW_{O_2}} \cdot (T_{fg} - T_{ref})}
+ * @formula{slfgm-h-sensible-n2; h_{N_2} = m_{N_2} \cdot \frac{Cp_{N_2}}{MW_{N_2}} \cdot (T_{fg} - T_{ref})}
+ * @formula{slfgm-h-fg; h_{fg} = h_{H_2O} + h_{CO_2} + h_{N_2} + h_{O_2} + h_{SO_2}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{h_{i}; Sensible heat of constituent i; \btu\per\pound}
+ * @symrow{m_{i}; Mass of constituent i; \pound\per\pound\;fuel}
+ * @symrow{Cp_{i}; Specific heat of constituent i - see @ref gas_constants; \btu\per\pound\degreeFahrenheit}
+ * @symrow{MW_{i}; Molecular weight of constituent i - see @ref gas_constants; \pound\per\lbmol}
+ * @symrow{T_{fg}; Flue gas temperature; \degreeFahrenheit}
+ * @symrow{T_{ref}; Reference temperature (ambient); \degreeFahrenheit}
+ * @symrow{h_{sat}; Enthalpy of saturated steam; \btu\per\pound}
+ * @symrow{m_{H_2O,fuel}; Water from fuel moisture and combustion; \pound\per\pound\;fuel}
+ * @symrow{m_{H_2O,air}; Water from combustion air moisture; \pound\per\pound\;fuel}
+ * @symrow{h_{fg}; Total sensible heat in flue gas; \btu\per\pound}
+ * @endsymtable
+ *
+ * @subheading{Enthalpy of Saturated Steam}
+ * @brief Calculate enthalpy at saturation for latent heat effects.
+ * @details The enthalpy of saturated steam is needed to account for latent heat of condensation in the water vapor 
+ * component of the flue gas.
+ *
+ * @formula{slfgm-h-sat; h_{sat} = 1096.7 \cdot (p_{H_2O} \cdot 29.926)^{0.013}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{h_{sat}; Enthalpy of saturated steam; \btu\per\pound}
+ * @symrow{p_{H_2O}; Partial pressure of water vapor; \unitless}
+ * @symrow{1096.7; Empirical correlation coefficient; \btu\per\pound}
+ * @symrow{29.926; Atmospheric pressure in inches of mercury; \inchMercury}
+ * @symrow{0.013; Empirical correlation exponent; \unitless}
+ * @endsymtable
+ *
+ * @subheading{Partial Pressure of Water Vapor}
+ * @brief Calculate mole fraction of water vapor in flue gas.
+ * @details The partial pressure of water vapor is needed to determine saturation conditions for latent heat calculations. 
+ * It is calculated from the volumetric fractions of all constituents using specific gravity ratios.
+ *
+ * @formula{slfgm-pp-h2o; p_{H_2O} = \frac{m_{H_2O}/0.047636}{m_{CO_2}/0.116367 + m_{H_2O}/0.047636 + m_{N_2}/0.074077 + m_{O_2}/0.084611 + m_{SO_2}/0.169381}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{p_{H_2O}; Partial pressure (mole fraction) of water vapor; \unitless}
+ * @symrow{m_{i}; Mass of constituent i; \pound\per\pound\;fuel}
+ * @symrow{0.047636; H2O specific weight - see @ref gas_constants; \pound\per\cubicFoot}
+ * @symrow{0.116367; CO2 specific weight - see @ref gas_constants; \pound\per\cubicFoot}
+ * @symrow{0.074077; N2 specific weight - see @ref gas_constants; \pound\per\cubicFoot}
+ * @symrow{0.084611; O2 specific weight - see @ref gas_constants; \pound\per\cubicFoot}
+ * @symrow{0.169381; SO2 specific weight - see @ref gas_constants; \pound\per\cubicFoot}
+ * @endsymtable
+ *
+ * @subheading{Other Losses}
+ * @brief Account for moisture, unburned carbon, and ash losses.
+ * @details Additional heat losses occur due to moisture evaporation, incomplete combustion leaving unburned carbon 
+ * in ash, and sensible heat carried away by hot ash.
+ *
+ * @formula{slfgm-h-moisture; h_{moisture} = X_{moisture} \cdot (T_{fg} - T_{ref})}
+ * @formula{slfgm-h-carbon; h_{carbon} = 14093.0 \cdot X_{unburned,carbon} \cdot (X_{ash}/x_{fuel})}
+ * @formula{slfgm-h-ash; h_{ash} = (X_{ash}/x_{fuel}) \cdot 0.25 \cdot (1.8 \cdot T_{ash,discharge} + 32.0 - T_{ref})}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{h_{moisture}; Heat loss due to moisture evaporation; \btu\per\pound}
+ * @symrow{h_{carbon}; Heat loss due to unburned carbon; \btu\per\pound}
+ * @symrow{h_{ash}; Heat loss due to ash sensible heat; \btu\per\pound}
+ * @symrow{X_{moisture}; Moisture percent in fuel; \percent}
+ * @symrow{X_{unburned,carbon}; Unburned carbon in ash; \percent}
+ * @symrow{X_{ash}; Ash percent in fuel; \percent}
+ * @symrow{x_{fuel}; Dry fuel fraction; \unitless}
+ * @symrow{T_{fg}; Flue gas temperature; \degreeFahrenheit}
+ * @symrow{T_{ref}; Reference temperature (ambient); \degreeFahrenheit}
+ * @symrow{T_{ash,discharge}; Ash discharge temperature; \degreeFahrenheit}
+ * @symrow{14093.0; Heating value of carbon; \btu\per\pound}
+ * @symrow{0.25; Specific heat of ash; \btu\per\pound\degreeFahrenheit}
+ * @symrow{1.8; Fahrenheit to Celsius conversion factor; \unitless}
+ * @symrow{32.0; Fahrenheit to Celsius offset; \degreeFahrenheit}
+ * @endsymtable
+ *
+ * @subheading{Flue Gas Components and Heating Value}
+ * @brief Calculate mass of each flue gas component and fuel heating value.
+ * @details The mass of each combustion product is calculated from fuel composition and stoichiometry. The heating 
+ * value is the sum of elemental contributions from carbon, hydrogen, and sulfur. See @ref gas_constants for 
+ * stoichiometric constants.
+ *
+ * @formula{slfgm-m-co2; m_{CO_2} = x_C \cdot k_{C\to CO_2}}
+ * @formula{slfgm-m-h2o; m_{H_2O} = x_H \cdot k_{H\to H_2O} + x_{moisture} + (M_{comb,air} \cdot M_{air,moisture}/100)}
+ * @formula{slfgm-m-so2; m_{SO_2} = x_S \cdot k_{S\to SO_2}}
+ * @formula{slfgm-m-o2; m_{O_2} = O2_{s,air} \cdot EA}
+ * @formula{slfgm-m-n2; m_{N_2} = N2_{s,air} \cdot (1 + EA)}
+ * @formula{slfgm-hv; HV_{fuel} = x_C \cdot k_{HV,C} + x_H \cdot k_{HV,H} + x_S \cdot k_{HV,S}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{m_{i}; Mass of constituent i per unit fuel; \pound\per\pound\;fuel}
+ * @symrow{x_C; Carbon mass fraction in fuel; \unitless}
+ * @symrow{x_H; Hydrogen mass fraction in fuel; \unitless}
+ * @symrow{x_S; Sulfur mass fraction in fuel; \unitless}
+ * @symrow{x_{moisture}; Moisture mass fraction in fuel; \unitless}
+ * @symrow{k_{C\to CO_2}; Carbon to CO2 stoichiometric ratio - see @ref gas_constants; \pound\per\pound}
+ * @symrow{k_{H\to H_2O}; Hydrogen to H2O stoichiometric ratio - see @ref gas_constants; \pound\per\pound}
+ * @symrow{k_{S\to SO_2}; Sulfur to SO2 stoichiometric ratio - see @ref gas_constants; \pound\per\pound}
+ * @symrow{M_{comb,air}; Total combustion air; \pound\per\pound\;fuel}
+ * @symrow{M_{air,moisture}; Moisture percent in combustion air; \percent}
+ * @symrow{O2_{s,air}; Stoichiometric O2 required; \pound\per\pound\;fuel}
+ * @symrow{N2_{s,air}; Stoichiometric N2 from air; \pound\per\pound\;fuel}
+ * @symrow{EA; Excess air fraction; \unitless}
+ * @symrow{HV_{fuel}; Heating value of fuel; \btu\per\pound}
+ * @symrow{k_{HV,C}; Heating value of carbon; \btu\per\pound}
+ * @symrow{k_{HV,H}; Heating value of hydrogen; \btu\per\pound}
+ * @symrow{k_{HV,S}; Heating value of sulfur; \btu\per\pound}
+ * @symrow{100; Percentage conversion factor; \unitless}
+ * @endsymtable
+ *
+ * @subheading{Stoichiometric Air and Combustion Calculations}
+ * @brief Calculate theoretical air requirements from fuel composition.
+ * @details Stoichiometric air is the theoretical minimum air required for complete combustion. The calculation accounts 
+ * for oxygen requirements of carbon, hydrogen, and sulfur, minus any oxygen present in the fuel. See @ref gas_constants 
+ * for stoichiometric ratios.
+ *
+ * @formula{slfgm-stoich-air; O2_{s,air} = x_C \cdot k_{C\to O_2} + x_H \cdot k_{H\to O_2} + x_S \cdot k_{S\to O_2} - x_{O_2}}
+ * @formula{slfgm-n2s-air; N2_{s,air} = O2_{s,air} \cdot k_{N_2/O_2}}
+ * @formula{slfgm-ms-air; M_{s,air} = O2_{s,air} + N2_{s,air}}
+ * @formula{slfgm-m-comb-air; M_{comb,air} = M_{s,air} \cdot (1 + EA)}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{O2_{s,air}; Stoichiometric O2 required; \pound\per\pound\;fuel}
+ * @symrow{N2_{s,air}; Stoichiometric N2 from air; \pound\per\pound\;fuel}
+ * @symrow{M_{s,air}; Stoichiometric air; \pound\per\pound\;fuel}
+ * @symrow{M_{comb,air}; Total combustion air; \pound\per\pound\;fuel}
+ * @symrow{x_C; Carbon mass fraction in fuel; \unitless}
+ * @symrow{x_H; Hydrogen mass fraction in fuel; \unitless}
+ * @symrow{x_S; Sulfur mass fraction in fuel; \unitless}
+ * @symrow{x_{O_2}; Oxygen mass fraction in fuel; \unitless}
+ * @symrow{k_{C\to O_2}; Carbon to O2 stoichiometric ratio - see @ref gas_constants; \pound\per\pound}
+ * @symrow{k_{H\to O_2}; Hydrogen to O2 stoichiometric ratio - see @ref gas_constants; \pound\per\pound}
+ * @symrow{k_{S\to O_2}; Sulfur to O2 stoichiometric ratio - see @ref gas_constants; \pound\per\pound}
+ * @symrow{k_{N_2/O_2}; N2 to O2 ratio in air - see @ref gas_constants; \pound\per\pound}
+ * @symrow{EA; Excess air fraction; \unitless}
+ * @endsymtable
+ *
+ * @subheading{Fuel and Combustion Air Enthalpy}
+ * @brief Calculate sensible enthalpy of fuel and combustion air inputs.
+ * @details When fuel or combustion air enters at temperatures above ambient, they contribute additional sensible heat 
+ * to the system. The specific heat of combustion air varies with temperature.
+ *
+ * @formula{slfgm-h-fuel; h_{fuel} = C_{pfuel} \cdot (1 - x_{moisture}) \cdot (T_{fuel} - T_{amb})}
+ * @formula{slfgm-cp-comb-air; C_{p,air} = a + b \cdot T_{comb}}
+ * @formula{slfgm-h-comb-air; h_{comb,air} = M_{comb,air} \cdot C_{p,air} \cdot (T_{comb} - T_{amb}) / \rho_{air}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{h_{fuel}; Sensible enthalpy of fuel; \btu\per\pound}
+ * @symrow{C_{pfuel}; Specific heat of fuel; \btu\per\pound\degreeFahrenheit}
+ * @symrow{x_{moisture}; Moisture fraction in fuel; \unitless}
+ * @symrow{T_{fuel}; Fuel temperature; \degreeFahrenheit}
+ * @symrow{T_{amb}; Ambient air temperature; \degreeFahrenheit}
+ * @symrow{C_{p,air}; Specific heat of combustion air; \btu\per\pound\degreeFahrenheit}
+ * @symrow{a; Linear coefficient for air specific heat; \btu\per\pound\degreeFahrenheit}
+ * @symrow{b; Temperature coefficient for air specific heat; \btu\per\pound\degreeFahrenheit\squared}
+ * @symrow{T_{comb}; Combustion air temperature; \degreeFahrenheit}
+ * @symrow{h_{comb,air}; Sensible enthalpy of combustion air; \btu\per\pound}
+ * @symrow{M_{comb,air}; Mass of combustion air; \pound\per\pound\;fuel}
+ * @symrow{\rho_{air}; Density of air; \pound\per\cubicFoot}
+ * @endsymtable
+ *
+ * @subheading{Normalize Fuel Composition}
+ * @brief Convert fuel analysis percentages to mass fractions.
+ * @details Fuel composition is typically provided as percentages that may not sum to exactly 100%. Normalization 
+ * ensures mass fractions sum to unity for stoichiometric calculations.
+ *
+ * @formula{slfgm-norm-fuel; x_i = \frac{X_i}{\sum_j X_j}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{x_i; Normalized mass fraction of constituent i; \unitless}
+ * @symrow{X_i; Percent of constituent i in fuel; \percent}
+ * @endsymtable
  */
 
 /**
- * @defgroup solid_liquid_flue_gas_o2_calc Solid/Liquid Flue Gas: Flue Gas O2 Calculation
+ * @defgroup solid_liquid_flue_gas_excess_air_calc Excess Air Calculation
  * @ingroup solid_liquid_flue_gas_material_calculator
- * @brief Algorithm for calculating flue gas O2 fraction from excess air and fuel composition.
- * @details Computes stoichiometric air, combustion air, and flue gas constituents to determine O2 fraction in flue gas.
- *
- * @subheading{Step 1: Normalize Fuel Composition}
- *   Normalize all fuel composition inputs to fractions:
- *     @formula{slfgm-norm-fuel-o2; x_i = \frac{X_i}{\sum_j X_j}}
- *   @symtable
- *     @symrow{x_i; Normalized fraction of constituent i; \unitless}
- *     @symrow{X_i; Percent of constituent i in fuel; \percent}
- *   @endsymtable
- *
- * @subheading{Step 2: Stoichiometric Air and Combustion Calculations}
- *   Calculate stoichiometric O2 and N2 required:
- *     @formula{slfgm-stoich-o2; O2_{s,air} = x_C \cdot k_{C\to O_2} + x_H \cdot k_{H\to O_2} + x_S \cdot k_{S\to O_2} - x_{O_2}}
- *     @formula{slfgm-stoich-n2; N2_{s,air} = O2_{s,air} \cdot k_{N_2/O_2}}
- *     @formula{slfgm-ms-air-o2; M_{s,air} = O2_{s,air} + N2_{s,air}}
- *     @formula{slfgm-m-comb-air-o2; M_{comb,air} = M_{s,air} \cdot (1 + EA)}
- *   @symtable
- *     @symrow{O2_{s,air}; Stoichiometric O2 required; \unitless}
- *     @symrow{N2_{s,air}; Stoichiometric N2 from air; \unitless}
- *     @symrow{M_{s,air}; Stoichiometric air; \unitless}
- *     @symrow{M_{comb,air}; Total combustion air; \unitless}
- *     @symrow{EA; Excess air fraction; \unitless}
- *   @endsymtable
- *
- * @subheading{Step 3: Flue Gas Components}
- *   Calculate mass of each flue gas component:
- *     @formula{slfgm-m-co2-o2; m_{CO_2} = x_C \cdot k_{C\to CO_2}}
- *     @formula{slfgm-m-h2o-o2; m_{H_2O} = x_H \cdot k_{H\to H_2O} + x_{moisture} + (M_{comb,air} \cdot M_{air,moisture}/100)}
- *     @formula{slfgm-m-so2-o2; m_{SO_2} = x_S \cdot k_{S\to SO_2}}
- *     @formula{slfgm-m-o2-o2; m_{O_2} = O2_{s,air} \cdot EA}
- *     @formula{slfgm-m-n2-o2; m_{N_2} = N2_{s,air} \cdot (1 + EA)}
- *   @symtable
- *     @symrow{m_{i}; Mass of constituent i; \unitless}
- *   @endsymtable
- *
- * @subheading{Step 4: Calculate O2 Fraction in Flue Gas}
- *   @formula{slfgm-o2-frac; O2_{fg} = \frac{m_{O_2}}{m_{CO_2} + m_{H_2O} + m_{N_2} + m_{O_2} + m_{SO_2}}}
- *   @symtable
- *     @symrow{O2_{fg}; O2 fraction in flue gas; \unitless}
- *   @endsymtable
+ * @brief Iterative method to estimate excess air from measured flue gas oxygen.
+ * @details Given the measured O2 percentage in the flue gas and fuel composition, this algorithm iteratively 
+ * estimates the fraction of excess air supplied to the combustion process. The calculation uses stoichiometric 
+ * relationships and mass balance.
+ *
+ * @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.
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{EA; Excess air fraction; \unitless}
+ * @symrow{O_2; Measured flue gas oxygen percentage; \percent}
+ * @endsymtable
  */
 
 /**
- * @defgroup solid_liquid_flue_gas_hv_calc Solid/Liquid Flue Gas: Heating Value Calculation
+ * @defgroup solid_liquid_flue_gas_o2_calc Flue Gas O2 Calculation
  * @ingroup solid_liquid_flue_gas_material_calculator
- * @brief Algorithm for calculating heating value of solid/liquid fuel based on composition.
- * @details Computes the heating value as a weighted sum of elemental contributions.
- *
- * @subheading{Step 1: Normalize Fuel Composition}
- *   Normalize all fuel composition inputs to fractions:
- *     @formula{slfgm-norm-fuel-hv; x_i = \frac{X_i}{\sum_j X_j}}
- *   @symtable
- *     @symrow{x_i; Normalized fraction of constituent i; \unitless}
- *     @symrow{X_i; Percent of constituent i in fuel; \percent}
- *   @endsymtable
- *
- * @subheading{Step 2: Weighted Heating Value}
- *   Calculate heating value as weighted sum:
- *     @formula{slfgm-hv-calc; HV_{fuel} = x_C \cdot k_{HV,C} + x_H \cdot k_{HV,H} + x_S \cdot k_{HV,S}}
- *   @symtable
- *     @symrow{HV_{fuel}; Heating value of fuel; \btu\per\pound}
- *     @symrow{x_C, x_H, x_S; Normalized fractions of C, H, S; \unitless}
- *     @symrow{k_{HV,C}, k_{HV,H}, k_{HV,S}; Heating value constants; \btu\per\pound}
- *   @endsymtable
+ * @brief Compute expected oxygen content in flue gas for a given excess air level.
+ * @details Given the excess air fraction and fuel composition, this algorithm calculates the expected O2 percentage 
+ * in the flue gas using stoichiometric and mass balance relationships.
+ *
+ * @subheading{O2 Percentage}
+ * The O2 content is calculated from the mass of excess oxygen divided by the total flue gas mass, converted to 
+ * volumetric percentage.
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{O_2; Flue gas oxygen percentage; \percent}
+ * @symrow{EA; Excess air fraction; \unitless}
+ * @endsymtable
  */
 
 /**
- * @see solid_liquid_flue_gas_material_data_database
- * @see gas_constants for molecular weights, specific heat formulas, and stoichiometric constants
+ * @defgroup solid_liquid_flue_gas_hv_calc Heating Value Calculation
+ * @ingroup solid_liquid_flue_gas_material_calculator
+ * @brief Calculate higher heating value of solid or liquid fuel.
+ * @details The higher heating value (HHV) is calculated as a weighted sum of elemental contributions from carbon, 
+ * hydrogen, and sulfur in the fuel. The weights must be normalized fractions.
+ *
+ * @subheading{Normalization}
+ * First, normalize the fuel composition fractions:
+ * @formula{slfgm-norm-fuel-2; x_i = \frac{X_i}{\sum_j X_j}}
+ *
+ * @subheading{Weighted Heating Value}
+ * Calculate heating value as weighted sum:
+ * @formula{slfgm-hv-calc; HV_{fuel} = x_C \cdot k_{HV,C} + x_H \cdot k_{HV,H} + x_S \cdot k_{HV,S}}
+ *
+ * @par Symbols
+ * @symtable
+ * @symrow{HV_{fuel}; Heating value of fuel; \btu\per\pound}
+ * @symrow{x_C; Normalized carbon fraction; \unitless}
+ * @symrow{x_H; Normalized hydrogen fraction; \unitless}
+ * @symrow{x_S; Normalized sulfur fraction; \unitless}
+ * @symrow{X_i; Percent of constituent i in fuel; \percent}
+ * @symrow{k_{HV,C}; Heating value constant for carbon; \btu\per\pound}
+ * @symrow{k_{HV,H}; Heating value constant for hydrogen; \btu\per\pound}
+ * @symrow{k_{HV,S}; Heating value constant for sulfur; \btu\per\pound}
+ * @endsymtable
  */

package/docs/dox-content/calculators/wall_heat_loss_calculator.dox

@@ -24,7 +24,8 @@
  * @copydoc wall_radiative_heat_loss_formula
  *
  * @heading{Shape Factors}
- * @copydoc shape_factors
+ * @copydoc wall_type_data_database
+ * @see wall_type_data_database
  */
 
 /**
@@ -100,19 +101,4 @@
  * @symrow{T_s; Surface temperature; \degreeRankine}
  * @symrow{T_a; Ambient temperature; \degreeRankine}
  * @endsymtable
- */
-
-/**
- * @defgroup wall_shape_factors Wall Shape Factors
- * @ingroup wall_heat_loss_calculator
- * | Wall Type                                     | Shape Factor @unitb{\unitless} |
- * |-----------------------------------------------|--------------------------------|
- * | Horizontal cylinders                          | 1.016                          |
- * | Longer vertical cylinders                     | 1.235                          |
- * | Vertical plates                               | 1.394                          |
- * | Horizontal plate facing up, warmer than air   | 1.79                           |
- * | Horizontal plate facing down, warmer than air | 0.89                           |
- * | Horizontal plate facing up, cooler than air   | 0.89                           |
- * | Horizontal plate facing down, cooler than air | 1.79                           |
- * Source: @cite astmC680
- */
+ */

package/docs/dox-content/database-docs/gas_type_data_database.dox

@@ -0,0 +1,28 @@
+/**
+ * @defgroup gas_type_data_database Gas Type Database
+ * @ingroup databases
+ * @brief Contains default data for atmospheric gas types used in atmosphere heat loss calculations.
+ * @details This database provides default values for the specific heat of common atmospheric gases at a reference temperature of @qty{60;\degreeFahrenheit}. The data is used in atmosphere heat loss calculations for process heating systems.
+ *
+ * @heading{Default Gas Type Data}
+ * @copydoc gas_type_data
+ */
+
+/**
+ * @defgroup gas_type_data Default Gas Type Data
+ * @ingroup gas_type_data_database
+ * The following table lists the default gas types and their specific heat values:
+ *
+ * | Gas Description     | Specific Heat @unitb{\btu\per\standardCubicFeet\degreeFahrenheit} |
+ * |---------------------|-------------------------------------------------------------------|
+ * | Nitrogen            | 0.0185                                                            |
+ * | Hydrogen            | 0.0182                                                            |
+ * | Exothermic Gas      | 0.0185                                                            |
+ * | Endothermic Gas     | 0.0185                                                            |
+ * | Air                 | 0.0184                                                            |
+ * | Water Vapor         | 0.0212                                                            |
+ *
+ * @note Values are at a reference temperature of @qty{60;\degreeFahrenheit} and may vary with pressure and temperature.
+ *
+ * @see atmosphere_heat_loss_calculator
+ */

package/docs/dox-content/database-docs/wall_type_data_database.dox

@@ -0,0 +1,30 @@
+/**
+ * @defgroup wall_type_data_database Wall Type Database
+ * @ingroup databases
+ * @brief Contains default data for wall types used in wall heat loss calculations.
+ * @details This database provides default values for shape factors associated with various wall types. The data is used in wall heat loss calculations for process heating systems.
+ *
+ * @heading{Default Wall Type Data}
+ * @copydoc wall_type_data 
+ * Source: @cite astmC680
+ */
+
+/**
+ * @defgroup wall_type_data Default Wall Type Data
+ * @ingroup wall_type_data_database
+ * The following table lists the default wall types and their shape factor values:
+ *
+ * | Wall Description                                     | Shape Factor @unitb{\unitless} |
+ * |------------------------------------------------------|--------------------------------|
+ * | Horizontal cylinders                                 | 1.016                          |
+ * | Longer vertical cylinders                            | 1.235                          |
+ * | Vertical plates                                      | 1.394                          |
+ * | Horizontal plate facing up, warmer than air          | 1.79                           |
+ * | Horizontal plate facing down, warmer than air        | 0.89                           |
+ * | Horizontal plate facing up, cooler than air          | 0.89                           |
+ * | Horizontal plate facing down, cooler than air        | 1.79                           |
+ *
+ * @note Shape factors are used to account for the effect of surface orientation on convective heat transfer.
+ *
+ * @see wall_heat_loss_calculator
+ */

package/package.json

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