measur-tools-suite 1.0.14-beta.156 → 1.0.14-beta.159

package/bin/package.json

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

package/docs/calculators/gas_cooling_heat_loss_calculator.dox

@@ -0,0 +1,30 @@
+/**
+ * @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.
+ * @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
+ */
+
+/**
+ * @defgroup gas_cooling_heat_loss_formula Gas Cooling Heat Loss Formula
+ * @ingroup gas_cooling_heat_loss_calculator
+ * @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{\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.
+ */

package/docs/calculators/liquid_cooling_heat_loss_calculator.dox

@@ -0,0 +1,32 @@
+/**
+ * @defgroup liquid_cooling_heat_loss_calculator Liquid Cooling Heat Loss Calculator
+ * @ingroup heat_loss_calculators
+ * @brief Calculates heat loss due to liquid cooling in process heating equipment.
+ * @details This calculator estimates the heat removed by liquid cooling systems, using flow rate, liquid 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 liquids other than water.
+ * @note If the cooling liquid is water, use the @ref water_cooling_heat_loss_calculator instead for more accurate water property calculations.
+ *
+ * @heading{Total Liquid Cooling Heat Loss}
+ * @copydoc liquid_cooling_heat_loss_formula
+ *
+ *
+ * @note For heat losses due to gas cooling see @ref gas_cooling_heat_loss_calculator.
+ *
+ * @see Perry’s Chemical Engineers’ Handbook; NIST Engineering Statistics
+ */
+
+/**
+ * @defgroup liquid_cooling_heat_loss_formula Liquid Cooling Heat Loss Formula
+ * @ingroup liquid_cooling_heat_loss_calculator
+ * @formula{liquid-cooling-heat-loss; Q_\text{cool} = FR \cdot 60 \cdot \rho_{l,lb/ft^3} \cdot SH \cdot \Delta T \cdot CF}
+ * @subheading{Symbols}
+ * @symtable
+ * @symrow{Q_\text{cool}; Liquid cooling heat loss; \btu\per\hour}
+ * @symrow{FR; Liquid flow rate; \gallon\per\minute}
+ * @symrow{60; Minutes per hour (GPM to GPH conversion); \unitless}
+ * @symrow{\rho_{l,lb/ft^3}; Liquid density; \pound\per\cubic\foot}
+ * @symrow{SH; Specific heat of liquid; \btu\per\pound\per\degreeFahrenheit}
+ * @symrow{\Delta T; Temperature rise (outlet - inlet); \degreeFahrenheit}
+ * @symrow{CF; Correction factor; \unitless}
+ * @endsymtable
+ * @details The formula multiplies flow rate (GPM), minutes per hour, liquid density, specific heat, temperature rise, and correction factor to obtain total heat loss.
+ */

package/docs/calculators/wall_heat_loss_calculator.dox

@@ -7,8 +7,7 @@
  * of process heating equipment to the surrounding environment. This can occur via convection and radiation. Wall losses
  * are high for systems that are poorly insulated or use poorly designed materials or surfaces. The calculator computes
  * the total heat loss as the sum of convective and radiative heat losses, adjusted by a correction factor. Relevant
- * formulas and factors are documented below. Heat losses due to openings in the unit are covered by the
- * @ref opening_heat_loss_calculator, @ref leakage_heat_loss_calculator, or @ref atmosphere_heat_loss_calculator.
+ * formulas and factors are documented below.
  *
  * @heading{Total Heat Loss}
  * @copydoc wall_total_heat_loss_formula

package/docs/calculators/water_cooling_heat_loss_calculator.dox

@@ -10,6 +10,9 @@
  * @heading{Water Density Calculation}
  * @copydoc water_density_formula
  *
+ * @note For heat losses due to liquid cooling see @ref liquid_cooling_heat_loss_calculator or for gas cooling see @ref gas_cooling_heat_loss_calculator.
+ *
+ *
  * @see Perry’s Chemical Engineers’ Handbook; NIST Engineering Statistics; Tanaka et al. (2001)
  */
 

package/docs/mainpage.dox

@@ -15,16 +15,16 @@
  * analysis alongside simple equipment and property calculators. Both the system assessment tools and the simple
  * calculators can be used as stand-alone tools for more focused analysis.
  *
+ * - @ref process_heating_assessments
+ *   - @ref heat_loss_calculators
  * - @ref compressed_air_assessments
  * - @ref fan_system_assessments
  * - @ref process_cooling_assessments
- * - @ref process_heating_assessments
  * - @ref pumping_system_assessments
  * - @ref steam_system_assessments
  * - @ref water_assessments
  * - @ref waste_water_assessments
  * - @ref treasure_hunt_calculators
- * - @ref heat_loss_calculators
  *
  * @defgroup compressed_air_assessments Compressed Air Assessments
  *

package/package.json

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