measur-tools-suite 1.0.14-rc.30 → 1.0.14-rc.32

package/bin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "measur-tools-suite",
-  "version": "1.0.14-rc.30",
+  "version": "1.0.14-rc.32",
   "engines": {
     "node": "20.19.4",
     "npm": "10.8.2"

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

@@ -5,10 +5,14 @@
  * @details This calculator is used to estimate heat losses of process heating equipment due to the introduction of
  * atmospheric gases (e.g., nitrogen, hydrogen, etc.). These gases absorb heat from the equipment and carry it away when
  * they exit the system. The calculator computes the total heat loss based on the flow rate, specific heat of the gas,
- * inlet and outlet temperatures, and a correction factor @cite trinks2003industrial. Relevant formulas and values are
- * documented below.
+ * inlet and outlet temperatures, and a correction factor @cite trinks2003industrial.
  *
- * @heading{Heat Loss}
+ * The calculation follows a top-down approach:
+ * 1. **Total Heat Loss** - Calculate the heat absorbed by atmospheric gases as they pass through the system
+ *
+ * Relevant formulas and values are documented below.
+ *
+ * @heading{Total Heat Loss}
  * @copydoc atmosphere_heat_loss_formula
  *
  * @heading{Specific Heat Values}
@@ -18,15 +22,20 @@
 /**
  * @defgroup atmosphere_heat_loss_formula Atmosphere Heat Loss Formula
  * @ingroup atmosphere_heat_loss_calculator
- * @formula{atmosphere-heat-loss; Q = \dot{v} \cdot c_p \cdot (T_\text{out} - T_\text{in}) \cdot
- * f_\text{corr}}
+ * @brief Total heat loss due to atmospheric gases.
+ * @details The heat loss is calculated by multiplying the volumetric flow rate, specific heat capacity, 
+ * temperature rise of the gas, and a correction factor. This represents the sensible heat absorbed by 
+ * the atmospheric gas as it passes through the heating equipment.
+ * 
+ * @formula{atmosphere-heat-loss; Q = \dot{v} \cdot c_p \cdot (T_\text{out} - T_\text{in}) \cdot f_\text{corr}}
+ * 
  * @subheading{Symbols}
  * @symtable
  * @symrow{Q; Heat loss; \btu\per\hour}
  * @symrow{\dot{v}; Flow rate of gas; \standardCubicFeet\per\hour}
  * @symrow{c_p; Specific heat of gas; \btu\per\standardCubicFeet\degreeFahrenheit}
  * @symrow{T_\text{out}; Outlet temperature of gas; \degreeFahrenheit}
- * @symrow{T_\text{in}; %Inlet temperature of gas; \degreeFahrenheit}
+ * @symrow{T_\text{in}; Inlet temperature of gas; \degreeFahrenheit}
  * @symrow{f_\text{corr}; Correction factor; \unitless}
  * @endsymtable
  */

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

@@ -2,18 +2,30 @@
  * @defgroup auxiliary_power_used_calculator Auxiliary Power Used Calculator
  * @ingroup heat_loss_calculators
  * @brief Calculates auxiliary power usage for electrical systems in process heating equipment.
- * @details This calculator estimates the energy use of motors and auxiliary systems associated with process heating equipment. It uses electrical parameters and operating time to compute total power consumption, converting electrical power from kW to BTU/hr using a physical constant. The algorithm is suitable for modeling auxiliary energy losses in industrial furnaces, ovens, and similar systems.
+ * @details This calculator estimates the energy use of motors and auxiliary systems associated with process heating 
+ * equipment. It uses electrical parameters and operating time to compute total power consumption, converting 
+ * electrical power from kW to BTU/hr using a physical constant. The algorithm is suitable for modeling auxiliary 
+ * energy losses in industrial furnaces, ovens, and similar systems.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Total Auxiliary Power** - Calculate electrical power consumption and convert to BTU/hr
  *
  * @heading{Total Auxiliary Power Used}
  * @copydoc auxiliary_power_used_formula
  *
- * @see Perry’s Chemical Engineers’ Handbook; NIST Engineering Statistics; ASHRAE Handbook
+ * @see Perry's Chemical Engineers' Handbook; NIST Engineering Statistics; ASHRAE Handbook
+ * @see physics::conversions::kKilowattToBtuPerHour for the conversion constant
  */
 
 /**
  * @defgroup auxiliary_power_used_formula Auxiliary Power Used Formula
  * @ingroup auxiliary_power_used_calculator
+ * @brief Total auxiliary power consumption.
+ * @details The formula calculates the electrical power in kilowatts based on voltage, current, power factor, and phase, 
+ * adjusts for operating time, then converts to BTU/hr using the conversion constant.
+ * 
  * @formula{aux-power-used; Q_\text{aux} = \sqrt{P} \cdot V \cdot I \cdot PF \cdot OT \cdot \frac{1}{1000} \cdot k_{\text{kW}\to\text{BTU/hr}}}
+ * 
  * @subheading{Symbols}
  * @symtable
  * @symrow{Q_\text{aux}; Auxiliary power used; \btu\per\hour}
@@ -22,7 +34,7 @@
  * @symrow{I; Average current; \ampere}
  * @symrow{PF; Power factor; \unitless}
  * @symrow{OT; Operating time (fraction, 0-1); \unitless}
- * @symrow{k_{\text{kW}\to\text{BTU/hr}}; Conversion factor; \btu\per\hour\per\kilowatt}
+ * @symrow{1000; Conversion from watts to kilowatts; \watt\per\kilowatt}
+ * @symrow{k_{\text{kW}\to\text{BTU/hr}}; Conversion factor - see @ref physics::conversions::kKilowattToBtuPerHour; \btu\per\hour\per\kilowatt}
  * @endsymtable
- * @details The formula first computes electrical power in kW, then converts to BTU/hr using the physical constant @ref physics::conversions::kKilowattToBtuPerHour.
  */

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

@@ -2,39 +2,59 @@
  * @defgroup energy_input_electric_arc_furnace_calculator Energy Input Electric Arc Furnace Calculator
  * @ingroup heat_loss_calculators
  * @brief Calculates total energy input and heat delivered for electric arc furnaces (EAF).
- * @details This calculator estimates the total chemical energy input and total heat delivered to an EAF, including contributions from natural gas, coal/carbon injection, electrodes, other fuels, and electricity. It uses standard unit conversions and accounts for all major energy sources supplied to the furnace. Relevant formulas are documented below.
+ * @details This calculator estimates the total chemical energy input and total heat delivered to an EAF, including 
+ * contributions from natural gas, coal/carbon injection, electrodes, other fuels, and electricity. It uses standard 
+ * unit conversions and accounts for all major energy sources supplied to the furnace.
  *
- * @heading{Total Chemical Energy Input}
- * @copydoc energy_input_electric_arc_furnace_formula
+ * The calculation follows a top-down approach:
+ * 1. **Total Heat Delivered** - Sum of chemical energy and electrical energy inputs
+ * 2. **Total Chemical Energy Input** - Sum of all chemical fuel sources (natural gas, coal, electrodes, other fuels)
+ *
+ * Relevant formulas are documented below.
  *
  * @heading{Total Heat Delivered}
  * @copydoc energy_input_electric_arc_furnace_heat_delivered_formula
+ *
+ * @heading{Total Chemical Energy Input}
+ * @copydoc energy_input_electric_arc_furnace_formula
+ *
+ * @see physics::conversions::kKilowattToBtuPerHour for electrical energy conversion
  */
 
 /**
- * @defgroup energy_input_electric_arc_furnace_formula Energy Input Electric Arc Furnace Formula
+ * @defgroup energy_input_electric_arc_furnace_heat_delivered_formula Energy Input Electric Arc Furnace Heat Delivered Formula
  * @ingroup energy_input_electric_arc_furnace_calculator
- * @formula{eaf-chemical-energy-input; Q_\text{chem} = Q_\text{ng} + m_\text{coal} c_\text{coal} + m_\text{elec} c_\text{elec} + Q_\text{other}}
+ * @brief Total heat delivered to the electric arc furnace.
+ * @details The total heat delivered is the sum of chemical energy from combustion and electrical energy supplied to the furnace.
+ * 
+ * @formula{eaf-heat-delivered; Q_\text{delivered} = Q_\text{chem} + Q_\text{elec}}
+ * 
  * @subheading{Symbols}
  * @symtable
+ * @symrow{Q_\text{delivered}; Total heat delivered to EAF; \btu\per\hour}
  * @symrow{Q_\text{chem}; Total chemical energy input; \btu\per\hour}
- * @symrow{Q_\text{ng}; Natural gas heat input; \btu\per\hour}
- * @symrow{m_\text{coal}; Mass of coal/carbon injection; \pound\per\hour}
- * @symrow{c_\text{coal}; Heating value of coal/carbon; \btu\per\pound}
- * @symrow{m_\text{elec}; Electrode use; \pound\per\hour}
- * @symrow{c_\text{elec}; Electrode heating value; \btu\per\pound}
- * @symrow{Q_\text{other}; Other fuel heat input; \btu\per\hour}
+ * @symrow{Q_\text{elec}; Electric power supplied; \btu\per\hour}
  * @endsymtable
  */
 
 /**
- * @defgroup energy_input_electric_arc_furnace_heat_delivered_formula Energy Input Electric Arc Furnace Heat Delivered Formula
+ * @defgroup energy_input_electric_arc_furnace_formula Energy Input Electric Arc Furnace Formula
  * @ingroup energy_input_electric_arc_furnace_calculator
- * @formula{eaf-heat-delivered; Q_\text{delivered} = Q_\text{chem} + Q_\text{elec}}
+ * @brief Total chemical energy input from all fuel sources.
+ * @details The total chemical energy is the sum of heat input from natural gas, coal/carbon injection, 
+ * electrode consumption, and other fuels. Each fuel contribution is calculated by multiplying mass flow 
+ * rate by its heating value.
+ * 
+ * @formula{eaf-chemical-energy-input; Q_\text{chem} = Q_\text{ng} + m_\text{coal} c_\text{coal} + m_\text{elec} c_\text{elec} + Q_\text{other}}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{Q_\text{delivered}; Total heat delivered to EAF; \btu\per\hour}
  * @symrow{Q_\text{chem}; Total chemical energy input; \btu\per\hour}
- * @symrow{Q_\text{elec}; Electric power supplied; \kilowatt\hour\per\hour}
+ * @symrow{Q_\text{ng}; Natural gas heat input; \btu\per\hour}
+ * @symrow{m_\text{coal}; Mass of coal/carbon injection; \pound\per\hour}
+ * @symrow{c_\text{coal}; Heating value of coal/carbon; \btu\per\pound}
+ * @symrow{m_\text{elec}; Electrode use; \pound\per\hour}
+ * @symrow{c_\text{elec}; Electrode heating value; \btu\per\pound}
+ * @symrow{Q_\text{other}; Other fuel heat input; \btu\per\hour}
  * @endsymtable
  */

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

@@ -2,7 +2,15 @@
  * @defgroup energy_input_exhaust_gas_heat_loss_calculator Energy Input Exhaust Gas Heat Loss Calculation
  * @ingroup heat_loss_calculators
  * @brief Calculates available heat, heat delivered, and exhaust gas losses for non-EAF electric furnaces.
- * @details The following formulas describe the calculation of available heat, heat delivered, exhaust gas losses, and all intermediate steps. Each step is documented with its own formula and symbol table.
+ * @details The following formulas describe the calculation of available heat, heat delivered, exhaust gas losses, 
+ * and all intermediate steps. Each step is documented with its own formula and symbol table.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Exhaust Gas Losses** - Calculate heat lost through exhaust gases based on available heat
+ * 2. **Heat Delivered** - Calculate useful heat delivered based on input and available heat percentage
+ * 3. **Available Heat** - Calculate percentage of input heat available after exhaust losses
+ * 4. **Air Corrections** - Calculate corrections for excess air and combustion air preheat
+ * 5. **Specific Heat of Air** - Temperature-dependent specific heat calculation
  *
  * @heading{Exhaust Gas Losses}
  * @copydoc energy_input_exhaust_gas_total_heat_loss_cpp_formula
@@ -13,90 +21,130 @@
  * @heading{Available Heat}
  * @copydoc energy_input_exhaust_gas_available_heat_cpp_formula
  *
- * @heading{Specific Heat of Air}
- * @copydoc energy_input_exhaust_gas_specific_heat_air_cpp_formula
- *
  * @heading{Air Correction}
  * @copydoc energy_input_exhaust_gas_air_correction_cpp_formula
  *
  * @heading{Combustion Air Correction}
  * @copydoc energy_input_exhaust_gas_combustion_air_correction_cpp_formula
+ *
+ * @heading{Specific Heat of Air}
+ * @copydoc energy_input_exhaust_gas_specific_heat_air_cpp_formula
+ *
+ * @see physics::us::kSpecificHeatAirBase for base specific heat of air
+ * @see physics::us::kSpecificHeatAirCoeff for specific heat temperature coefficient
+ * @see physics::us::kAirCorrectionBase for air correction base constant
  */
 
 /**
- * @defgroup energy_input_exhaust_gas_available_heat_cpp_formula Available Heat Formula
+ * @defgroup energy_input_exhaust_gas_total_heat_loss_cpp_formula Exhaust Gas Losses Formula
  * @ingroup energy_input_exhaust_gas_heat_loss_calculator
- * @formula{energy-input-exhaust-gas-available-heat-cpp; AH = 95 - 0.025 \cdot T_{exh} + AC + CAC}
+ * @brief Total heat loss through exhaust gases.
+ * @details The exhaust gas losses represent heat carried away by hot exhaust gases. It is calculated from 
+ * the delivered heat and the fraction of unavailable heat.
+ * 
+ * @formula{energy-input-exhaust-gas-total-heat-loss-cpp; Q_{loss} = Q_{delivered} \cdot \frac{100 - AH}{AH}}
+ * 
  * @subheading{Symbols}
  * @symtable
+ * @symrow{Q_{loss}; Exhaust gas losses; \btu\per\hour}
+ * @symrow{Q_{delivered}; Heat delivered; \btu\per\hour}
  * @symrow{AH; Available heat percent; \percent}
- * @symrow{T_{exh}; Exhaust gas temperature; \degreeFahrenheit}
- * @symrow{AC; Air correction; \percent}
- * @symrow{CAC; Combustion air correction; \percent}
+ * @symrow{100; Total heat percentage; \percent}
  * @endsymtable
  */
 
 /**
- * @defgroup energy_input_exhaust_gas_specific_heat_air_cpp_formula Specific Heat of Air Formula
+ * @defgroup energy_input_exhaust_gas_heat_delivered_cpp_formula Heat Delivered Formula
  * @ingroup energy_input_exhaust_gas_heat_loss_calculator
- * @formula{energy-input-exhaust-gas-specific-heat-air-cpp; SH_{air} = 0.01783 + 0.00000256 \cdot T_{air}}
+ * @brief Useful heat delivered to the furnace.
+ * @details The heat delivered is the fraction of total input heat that remains after exhaust gas losses, 
+ * based on the available heat percentage.
+ * 
+ * @formula{energy-input-exhaust-gas-heat-delivered-cpp; Q_{delivered} = Q_{input} \cdot \frac{AH}{100}}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{SH_{air}; Specific heat of air; \btu\per\pound\degreeFahrenheit}
- * @symrow{T_{air}; Combustion air temperature; \degreeFahrenheit}
- * @symrow{.01783; Base specific heat of air; \unitless}
- * @symrow{0.00000256; Specific heat air coefficient; \unitless}
+ * @symrow{Q_{delivered}; Heat delivered; \btu\per\hour}
+ * @symrow{Q_{input}; Total heat input; \btu\per\hour}
+ * @symrow{AH; Available heat percent; \percent}
+ * @symrow{100; Percentage conversion factor; \percent}
+ * @endsymtable
+ */
+
+/**
+ * @defgroup energy_input_exhaust_gas_available_heat_cpp_formula Available Heat Formula
+ * @ingroup energy_input_exhaust_gas_heat_loss_calculator
+ * @brief Percentage of input heat available after exhaust losses.
+ * @details The available heat represents the fraction of input energy that remains available for useful work 
+ * after accounting for exhaust gas temperature, excess air, and combustion air preheat.
+ * 
+ * @formula{energy-input-exhaust-gas-available-heat-cpp; AH = 95 - 0.025 \cdot T_{exh} + AC + CAC}
+ * 
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{AH; Available heat percent; \percent}
+ * @symrow{95; Base available heat at zero exhaust temperature; \percent}
+ * @symrow{0.025; Exhaust temperature loss coefficient; \percent\per\degreeFahrenheit}
+ * @symrow{T_{exh}; Exhaust gas temperature; \degreeFahrenheit}
+ * @symrow{AC; Air correction; \percent}
+ * @symrow{CAC; Combustion air correction; \percent}
  * @endsymtable
  */
 
 /**
  * @defgroup energy_input_exhaust_gas_air_correction_cpp_formula Air Correction Formula
  * @ingroup energy_input_exhaust_gas_heat_loss_calculator
+ * @brief Correction for excess air in exhaust.
+ * @details The air correction accounts for heat lost due to excess air being heated to exhaust temperature. 
+ * Excess air reduces available heat by carrying away sensible heat.
+ * 
  * @formula{energy-input-exhaust-gas-air-correction-cpp; AC = -[(-1.078913827 + SH_{air} \cdot T_{exh})] \cdot EA/100}
+ * 
  * @subheading{Symbols}
  * @symtable
  * @symrow{AC; Air correction; \percent}
- * @symrow{T_{exh}; Exhaust gas temperature; \degreeFahrenheit}
+ * @symrow{-1.078913827; Air correction base - see @ref physics::us::kAirCorrectionBase; \btu\per\pound}
  * @symrow{SH_{air}; Specific heat of air; \btu\per\pound\degreeFahrenheit}
- * @symrow{-1.078913827; Air correction base; \unitless}
+ * @symrow{T_{exh}; Exhaust gas temperature; \degreeFahrenheit}
  * @symrow{EA; Excess air as percent; \percent}
+ * @symrow{100; Percentage conversion factor; \percent}
  * @endsymtable
  */
 
 /**
  * @defgroup energy_input_exhaust_gas_combustion_air_correction_cpp_formula Combustion Air Correction Formula
  * @ingroup energy_input_exhaust_gas_heat_loss_calculator
+ * @brief Correction for preheated combustion air.
+ * @details The combustion air correction accounts for sensible heat added to the system when combustion air 
+ * is preheated. Preheating combustion air increases available heat.
+ * 
  * @formula{energy-input-exhaust-gas-combustion-air-correction-cpp; CAC = (-1.078913827 + SH_{air} \cdot T_{air}) \cdot (1 + EA/100)}
+ * 
  * @subheading{Symbols}
  * @symtable
  * @symrow{CAC; Combustion air correction; \percent}
+ * @symrow{-1.078913827; Air correction base - see @ref physics::us::kAirCorrectionBase; \btu\per\pound}
  * @symrow{SH_{air}; Specific heat of air; \btu\per\pound\degreeFahrenheit}
- * @symrow{-1.078913827; Air correction base; \unitless}
  * @symrow{T_{air}; Combustion air temperature; \degreeFahrenheit}
  * @symrow{EA; Excess air as percent; \percent}
+ * @symrow{100; Percentage conversion factor; \percent}
  * @endsymtable
  */
 
 /**
- * @defgroup energy_input_exhaust_gas_heat_delivered_cpp_formula Heat Delivered Formula
- * @ingroup energy_input_exhaust_gas_heat_loss_calculator
- * @formula{energy-input-exhaust-gas-heat-delivered-cpp; Q_{delivered} = Q_{input} \cdot \frac{AH}{100}}
- * @subheading{Symbols}
- * @symtable
- * @symrow{Q_{delivered}; Heat delivered; \btu\per\hour}
- * @symrow{Q_{input}; Total heat input; \btu\per\hour}
- * @symrow{AH; Available heat percent; \percent}
- * @endsymtable
- */
-
-/**
- * @defgroup energy_input_exhaust_gas_total_heat_loss_cpp_formula Exhaust Gas Losses Formula
+ * @defgroup energy_input_exhaust_gas_specific_heat_air_cpp_formula Specific Heat of Air Formula
  * @ingroup energy_input_exhaust_gas_heat_loss_calculator
- * @formula{energy-input-exhaust-gas-total-heat-loss-cpp; Q_{loss} = Q_{delivered} \cdot \frac{100 - AH}{AH}}
+ * @brief Temperature-dependent specific heat of air.
+ * @details The specific heat of air increases with temperature. This linear correlation provides the specific 
+ * heat as a function of temperature for use in air correction calculations.
+ * 
+ * @formula{energy-input-exhaust-gas-specific-heat-air-cpp; SH_{air} = 0.017828518 + 0.000002556 \cdot T_{air}}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{Q_{loss}; Exhaust gas losses; \btu\per\hour}
- * @symrow{Q_{delivered}; Heat delivered; \btu\per\hour}
- * @symrow{AH; Available heat percent; \percent}
+ * @symrow{SH_{air}; Specific heat of air; \btu\per\pound\degreeFahrenheit}
+ * @symrow{0.017828518; Base specific heat of air - see @ref physics::us::kSpecificHeatAirBase; \btu\per\pound\degreeFahrenheit}
+ * @symrow{0.000002556; Specific heat temperature coefficient - see @ref physics::us::kSpecificHeatAirCoeff; \btu\per\pound\degreeFahrenheit\per\degreeFahrenheit}
+ * @symrow{T_{air}; Combustion air temperature; \degreeFahrenheit}
  * @endsymtable
  */

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

@@ -2,7 +2,15 @@
  * @defgroup exhaust_gas_heat_loss_electric_arc_furnace_calculator Exhaust Gas Heat Loss Calculation (Electric Arc Furnace)
  * @ingroup heat_loss_calculators
  * @brief Calculates total heat loss from exhaust gas in electric arc furnaces (EAF).
- * @details The following formulas describe the calculation of heat loss from exhaust gases, including chemical heat, total heat value per unit volume, corrected volume flow rate, and total heat loss. Each step is documented with its own formula and symbol table.
+ * @details The following formulas describe the calculation of heat loss from exhaust gases, including chemical heat, 
+ * total heat value per unit volume, corrected volume flow rate, and total heat loss. Each step is documented with 
+ * its own formula and symbol table.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Total Heat Loss** - Calculate total heat carried away by exhaust gases
+ * 2. **Corrected Volume Flow Rate** - Adjust measured flow rate to standard conditions
+ * 3. **Total Heat Value per Unit Volume** - Sum of chemical heat and sensible heat content
+ * 4. **Chemical Heat** - Heat content from unburned combustibles in exhaust
  *
  * @heading{Total Heat Loss}
  * @copydoc exhaust_gas_total_heat_loss_cpp_formula
@@ -16,62 +24,86 @@
  * @heading{Chemical Heat}
  * @copydoc exhaust_gas_chemical_heat_cpp_formula
  *
+ * @see physics::us::kStandardGasTemperatureR for standard gas temperature
+ * @see physics::conversions::kFahrenheitToRankineOffset for temperature conversion
+ * @see physics::conversions::kMinutesPerHour for time conversion
  */
 
 /**
- * @defgroup exhaust_gas_chemical_heat_cpp_formula Chemical Heat Formula
+ * @defgroup exhaust_gas_total_heat_loss_cpp_formula Total Heat Loss Formula
  * @ingroup exhaust_gas_heat_loss_electric_arc_furnace_calculator
- * @formula{exhaust-gas-chemical-heat-cpp; Q_{chem} = \frac{CO \cdot 321 + H_{2} \cdot 325 + Combustibles \cdot 1020}{100}}
+ * @brief Total heat loss from exhaust gases.
+ * @details The total heat loss is calculated by multiplying the corrected volume flow rate, heat content per unit volume, 
+ * and conversion factor from minutes to hours.
+ * 
+ * @formula{exhaust-gas-total-heat-loss-cpp; Q_{total} = VFR_{total} \cdot Q_{flue} \cdot 60}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{Q_{chem}; Chemical heat per unit volume; \btu}
- * @symrow{CO; Percent CO in exhaust gas; \percent}
- * @symrow{H_{2}; Percent @math{H_2} in exhaust gas; \percent}
- * @symrow{Combustibles; Percent other combustibles in exhaust gas; \percent}
- * @symrow{321; Heating value for CO; \btu\per\percent}
- * @symrow{325; Heating value for @math{H_2}; \btu\per\percent}
- * @symrow{1020; Heating value for other combustibles; \btu\per\percent}
+ * @symrow{Q_{total}; Total heat loss; \btu\per\hour}
+ * @symrow{VFR_{total}; Corrected volume flow rate; \cubicFoot\per\minute}
+ * @symrow{Q_{flue}; Total heat value per unit volume; \btu\per\cubicFoot}
+ * @symrow{60; Minutes per hour - see @ref physics::conversions::kMinutesPerHour; \minute\per\hour}
  * @endsymtable
  */
 
 /**
- * @defgroup exhaust_gas_total_heat_value_cpp_formula Total Heat Value per Unit Volume Formula
+ * @defgroup exhaust_gas_total_vfr_cpp_formula Corrected Volume Flow Rate Formula
  * @ingroup exhaust_gas_heat_loss_electric_arc_furnace_calculator
- * @formula{exhaust-gas-total-heat-value-cpp; Q_{flue} = Q_{chem} + 0.0225 \cdot (T_{gas} - T_{ambient}) + Dust_{loading} \cdot 0.25 \cdot (T_{gas} - T_{ambient})}
+ * @brief Conversion of measured flow rate to standard conditions.
+ * @details The measured volume flow rate is corrected to standard temperature (520°R = 60°F) using the ideal gas law temperature correction.
+ * 
+ * @formula{exhaust-gas-total-vfr-cpp; VFR_{total} = VFR_{measured} \cdot \frac{T_{std}}{460 + T_{gas}}}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{Q_{flue}; Total heat value per unit volume; \btu}
- * @symrow{Q_{chem}; Chemical heat per unit volume; \btu}
- * @symrow{0.0225; Sensible heat factor; \btu\per\degreeFahrenheit}
+ * @symrow{VFR_{total}; Corrected volume flow rate; \cubicFoot\per\minute}
+ * @symrow{VFR_{measured}; Measured volume flow rate; \cubicFoot\per\minute}
+ * @symrow{T_{std}; Standard gas temperature - see @ref physics::us::kStandardGasTemperatureR; \degreeRankine}
+ * @symrow{460; Fahrenheit to Rankine offset - see @ref physics::conversions::kFahrenheitToRankineOffset; \degreeRankine}
  * @symrow{T_{gas}; Exhaust gas temperature; \degreeFahrenheit}
- * @symrow{T_{ambient}; Ambient/reference temperature; \degreeFahrenheit}
- * @symrow{Dust_{loading}; Dust loading in exhaust gas; \pound\per\cubic\foot}
- * @symrow{0.25; Dust heat factor; \btu\per\degreeFahrenheit}
  * @endsymtable
  */
 
 /**
- * @defgroup exhaust_gas_total_vfr_cpp_formula Corrected Volume Flow Rate Formula
+ * @defgroup exhaust_gas_total_heat_value_cpp_formula Total Heat Value per Unit Volume Formula
  * @ingroup exhaust_gas_heat_loss_electric_arc_furnace_calculator
- * @formula{exhaust-gas-total-vfr-cpp; VFR_{total} = VFR_{measured} \cdot \frac{T_{std}}{460 + T_{gas}}}
+ * @brief Heat content per unit volume of exhaust gas.
+ * @details The total heat value includes chemical heat from unburned combustibles plus sensible heat from the 
+ * temperature of the gas and entrained dust.
+ * 
+ * @formula{exhaust-gas-total-heat-value-cpp; Q_{flue} = Q_{chem} + 0.0225 \cdot (T_{gas} - T_{ambient}) + Dust_{loading} \cdot 0.25 \cdot (T_{gas} - T_{ambient})}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{VFR_{total}; Corrected volume flow rate; \ft\cubed\per\minute}
- * @symrow{VFR_{measured}; Measured volume flow rate; \ft\cubed\per\minute}
- * @symrow{T_{std}; Standard gas temperature (520 °F); \degreeFahrenheit}
+ * @symrow{Q_{flue}; Total heat value per unit volume; \btu\per\cubicFoot}
+ * @symrow{Q_{chem}; Chemical heat per unit volume; \btu\per\cubicFoot}
+ * @symrow{0.0225; Sensible heat factor for gas; \btu\per\cubicFoot\degreeFahrenheit}
  * @symrow{T_{gas}; Exhaust gas temperature; \degreeFahrenheit}
+ * @symrow{T_{ambient}; Ambient/reference temperature; \degreeFahrenheit}
+ * @symrow{Dust_{loading}; Dust loading in exhaust gas; \pound\per\cubicFoot}
+ * @symrow{0.25; Dust heat factor; \btu\per\pound\degreeFahrenheit}
  * @endsymtable
  */
 
 /**
- * @defgroup exhaust_gas_total_heat_loss_cpp_formula Total Heat Loss Formula
+ * @defgroup exhaust_gas_chemical_heat_cpp_formula Chemical Heat Formula
  * @ingroup exhaust_gas_heat_loss_electric_arc_furnace_calculator
- * @formula{exhaust-gas-total-heat-loss-cpp; Q_{total} = VFR_{total} \cdot Q_{flue} \cdot 60}
+ * @brief Chemical heat from unburned combustibles.
+ * @details The chemical heat represents the heating value of unburned combustibles (CO, H₂, and other combustibles) 
+ * in the exhaust gas. Each component is multiplied by its heating value and summed.
+ * 
+ * @formula{exhaust-gas-chemical-heat-cpp; Q_{chem} = \frac{CO \cdot 321 + H_{2} \cdot 325 + Combustibles \cdot 1020}{100}}
+ * 
  * @subheading{Symbols}
  * @symtable
- * @symrow{Q_{total}; Total heat loss; \btu\per\hour}
- * @symrow{VFR_{total}; Corrected volume flow rate; \ft\cubed\per\minute}
- * @symrow{Q_{flue}; Total heat value per unit volume; \btu}
- * @symrow{60; Minutes per hour; \minute\per\hour}
+ * @symrow{Q_{chem}; Chemical heat per unit volume; \btu\per\cubicFoot}
+ * @symrow{CO; Percent CO in exhaust gas; \percent}
+ * @symrow{H_{2}; Percent @math{H_2} in exhaust gas; \percent}
+ * @symrow{Combustibles; Percent other combustibles in exhaust gas; \percent}
+ * @symrow{321; Heating value for CO; \btu\per\cubicFoot\per\percent}
+ * @symrow{325; Heating value for @math{H_2}; \btu\per\cubicFoot\per\percent}
+ * @symrow{1020; Heating value for other combustibles; \btu\per\cubicFoot\per\percent}
+ * @symrow{100; Percentage conversion factor; \unitless}
  * @endsymtable
  */

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

@@ -7,16 +7,27 @@
  * temperature. These fixtures absorb heat from the furnace as they are heated from their initial temperature to the
  * final furnace temperature. The calculator computes the total heat loss based on the feed rate, specific heat of the
  * fixture material, initial and final temperatures, and a correction factor @cite trinks2003industrial. The calculation
- * assumes there is no melting or phase change of the fixture material involved. Relevant formulas are documented below.
+ * assumes there is no melting or phase change of the fixture material involved.
  *
- * @heading{Heat Loss}
+ * The calculation follows a top-down approach:
+ * 1. **Total Heat Loss** - Calculate sensible heat absorbed by fixtures as they are heated
+ *
+ * Relevant formulas are documented below.
+ *
+ * @heading{Total Heat Loss}
  * @copydoc fixture_heat_loss_formula
  */
 
 /**
  * @defgroup fixture_heat_loss_formula Fixture Heat Loss Formula
  * @ingroup fixture_heat_loss_calculator
+ * @brief Total heat loss due to fixture heating.
+ * @details The heat loss is the sensible heat required to raise the temperature of the fixture material from its 
+ * initial temperature to the final (furnace) temperature, adjusted by a correction factor. This represents energy 
+ * absorbed by the fixtures that is not available for the primary heating process.
+ * 
  * @formula{fixture-heat-loss; Q = \dot{m} \cdot c_p \cdot (T_\text{final} - T_\text{initial}) \cdot f_\text{corr}}
+ * 
  * @subheading{Symbols}
  * @symtable
  * @symrow{Q; Heat loss; \btu\per\hour}

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

@@ -2,29 +2,38 @@
  * @defgroup gas_cooling_heat_loss_calculator Gas Cooling Heat Loss Calculator
  * @ingroup heat_loss_calculators
  * @brief Calculates heat loss due to gas (including air) cooling in process heating equipment.
- * @details This calculator estimates the heat removed by gas cooling systems, using flow rate, gas density, inlet and outlet temperatures, specific heat, and a correction factor. The algorithm is suitable for modeling cooling losses in industrial furnaces, ovens, and similar systems, for gases including air.
+ * @details This calculator estimates the heat removed by gas cooling systems, using flow rate, gas density, 
+ * inlet and outlet temperatures, specific heat, and a correction factor. The algorithm is suitable for modeling 
+ * cooling losses in industrial furnaces, ovens, and similar systems, for gases including air.
+ *
+ * The calculation follows a top-down approach:
+ * 1. **Total Heat Loss** - Calculate heat removed by gas based on flow rate, density, specific heat, and temperature rise
+ *
  * @heading{Total Gas Cooling Heat Loss}
  * @copydoc gas_cooling_heat_loss_formula
  *
  * @note For heat losses due to liquid cooling see @ref liquid_cooling_heat_loss_calculator or for water see @ref water_cooling_heat_loss_calculator.
- *
- *
- * @see Perry’s Chemical Engineers’ Handbook; NIST Engineering Statistics
+ * @see Perry's Chemical Engineers' Handbook; NIST Engineering Statistics
+ * @see physics::conversions::kMinutesPerHour for time conversion
  */
 
 /**
  * @defgroup gas_cooling_heat_loss_formula Gas Cooling Heat Loss Formula
  * @ingroup gas_cooling_heat_loss_calculator
+ * @brief Total heat loss due to gas cooling.
+ * @details The heat loss is calculated by multiplying the gas flow rate, density, specific heat, temperature rise, 
+ * and correction factor. The factor of 60 converts from standard cubic feet per minute to standard cubic feet per hour.
+ * 
  * @formula{gas-cooling-heat-loss; Q_\text{cool} = FR \cdot 60 \cdot \rho_{g,lb/ft^3} \cdot SH \cdot \Delta T \cdot CF}
+ * 
  * @subheading{Symbols}
  * @symtable
  * @symrow{Q_\text{cool}; Gas cooling heat loss; \btu\per\hour}
- * @symrow{FR; Gas flow rate; \foot\cubed\per\minute}
- * @symrow{60; Minutes per hour (SCFM to SCFH conversion); \unitless}
- * @symrow{\rho_{g,lb/ft^3}; Gas density; \pound\per\cubic\foot}
- * @symrow{SH; Specific heat of gas; \btu\per\scf\per\degreeFahrenheit}
+ * @symrow{FR; Gas flow rate; \cubicFoot\per\minute}
+ * @symrow{60; Minutes per hour (SCFM to SCFH conversion) - see @ref physics::conversions::kMinutesPerHour; \unitless}
+ * @symrow{\rho_{g,lb/ft^3}; Gas density; \pound\per\cubicFoot}
+ * @symrow{SH; Specific heat of gas; \btu\per\pound\degreeFahrenheit}
  * @symrow{\Delta T; Temperature rise (outlet - inlet); \degreeFahrenheit}
  * @symrow{CF; Correction factor; \unitless}
  * @endsymtable
- * @details The formula multiplies flow rate (SCFM), minutes per hour, gas density, specific heat, temperature rise, and correction factor to obtain total heat loss.
  */