measur-tools-suite 1.0.14-beta.222 → 1.0.14-beta.225

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/bin/client.wasm +0 -0
  2. package/bin/package.json +1 -1
  3. package/docs/dox-content/calculators/{cascade_heat_low_to_high_calculator.dox → cascade_heat_high_to_low_calculator.dox} +38 -38
  4. package/docs/dox-content/calculators/process_heat_efficiency_improvement_calculator.dox +169 -0
  5. package/package.json +1 -1
package/bin/client.wasm CHANGED
Binary file
package/bin/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "measur-tools-suite",
3
- "version": "1.0.14-beta.222",
3
+ "version": "1.0.14-beta.225",
4
4
  "engines": {
5
5
  "node": "20.19.4",
6
6
  "npm": "10.8.2"
package/docs/dox-content/calculators/{cascade_heat_low_to_high_calculator.dox → cascade_heat_high_to_low_calculator.dox} RENAMED
@@ -1,45 +1,45 @@
1
1
  /**
2
- * @defgroup cascade_heat_low_to_high_calculator Cascade Heat Low-to-High Calculator
2
+ * @defgroup cascade_heat_high_to_low_calculator Cascade Heat High-to-Low Calculator
3
3
  * @ingroup process_heat_calculators
4
- * @brief Calculates energy and cost savings from cascading heat from a low-temperature process to a high-temperature process.
5
- * @details This calculator estimates the benefit of using waste heat from a low-temperature process to supply heat to a high-temperature process. The calculation uses flue gas properties, process firing rates, exhaust temperatures, available heat, and fuel cost. The method is based on standard industrial practice for process heat recovery.
4
+ * @brief Calculates energy and cost savings from cascading heat from a high-temperature process to a low-temperature process.
5
+ * @details This calculator estimates the benefit of using waste heat from a high-temperature process to supply heat to a low-temperature process. The calculation uses flue gas properties, process firing rates, exhaust temperatures, available heat, and fuel cost. The method is based on standard industrial practice for process heat recovery.
6
6
  *
7
7
  * The calculation follows a top-down approach:
8
8
  * 1. **Total Energy Savings** - Calculate total energy savings from cascading heat
9
9
  * 2. **Hourly Energy Savings** - Determine hourly energy savings based on supply and demand
10
- * 3. **Equivalent Energy Supply** - Calculate energy supplied to the high-temperature process
10
+ * 3. **Equivalent Energy Supply** - Calculate energy supplied to the low-temperature process
11
11
  * 4. **Heat Exchanger Energy Rate** - Compute energy transfer rate through the heat exchanger
12
- * 5. **Primary Flue Gas Volume** - Calculate flue gas volume from the low-temperature process
12
+ * 5. **Primary Flue Gas Volume** - Calculate flue gas volume from the high-temperature process
13
13
  * 6. **Flue Gas Properties** - Compute flue gas properties for both processes
14
14
  *
15
15
  * Relevant formulas and symbol definitions are documented below.
16
16
  *
17
17
  * @heading{Total Energy Savings}
18
- * @copydoc cascade_heat_low_to_high_total_energy_savings_formula
18
+ * @copydoc cascade_heat_high_to_low_total_energy_savings_formula
19
19
  *
20
20
  * @heading{Hourly Energy Savings}
21
- * @copydoc cascade_heat_low_to_high_hourly_energy_savings_formula
21
+ * @copydoc cascade_heat_high_to_low_hourly_energy_savings_formula
22
22
  *
23
23
  * @heading{Equivalent Energy Supply}
24
- * @copydoc cascade_heat_low_to_high_eq_energy_supply_formula
24
+ * @copydoc cascade_heat_high_to_low_eq_energy_supply_formula
25
25
  *
26
26
  * @heading{Heat Exchanger Energy Rate}
27
- * @copydoc cascade_heat_low_to_high_hx_energy_rate_formula
27
+ * @copydoc cascade_heat_high_to_low_hx_energy_rate_formula
28
28
  *
29
29
  * @heading{Primary Flue Gas Volume}
30
- * @copydoc cascade_heat_low_to_high_flue_volume_formula
30
+ * @copydoc cascade_heat_high_to_low_flue_volume_formula
31
31
  *
32
32
  * @heading{Flue Gas Properties}
33
- * @copydoc cascade_heat_low_to_high_flue_gas_properties
33
+ * @copydoc cascade_heat_high_to_low_flue_gas_properties
34
34
  */
35
35
 
36
36
  /**
37
- * @defgroup cascade_heat_low_to_high_total_energy_savings_formula Total Energy Savings Formula
38
- * @ingroup cascade_heat_low_to_high_calculator
37
+ * @defgroup cascade_heat_high_to_low_total_energy_savings_formula Total Energy Savings Formula
38
+ * @ingroup cascade_heat_high_to_low_calculator
39
39
  * @brief Total energy savings from cascading heat.
40
40
  * @details The total energy savings is calculated by multiplying the hourly energy savings by the effective operating hours.
41
41
  *
42
- * @formula{cascade-low-to-high-total-energy-savings; E_{savings} = E_{hourly} \cdot H_{eff}}
42
+ * @formula{cascade-high-to-low-total-energy-savings; E_{savings} = E_{hourly} \cdot H_{eff}}
43
43
  *
44
44
  * @subheading{Symbols}
45
45
  * @symtable
@@ -50,44 +50,44 @@
50
50
  */
51
51
 
52
52
  /**
53
- * @defgroup cascade_heat_low_to_high_hourly_energy_savings_formula Hourly Energy Savings Formula
54
- * @ingroup cascade_heat_low_to_high_calculator
53
+ * @defgroup cascade_heat_high_to_low_hourly_energy_savings_formula Hourly Energy Savings Formula
54
+ * @ingroup cascade_heat_high_to_low_calculator
55
55
  * @brief Hourly energy savings from cascading heat.
56
- * @details The hourly energy savings is the minimum of the equivalent energy supply and the high-temperature process firing rate.
56
+ * @details The hourly energy savings is the minimum of the equivalent energy supply and the low-temperature process firing rate.
57
57
  *
58
- * @formula{cascade-low-to-high-hourly-energy-savings; E_{hourly} = \min(E_{supply}, F_{high})}
58
+ * @formula{cascade-high-to-low-hourly-energy-savings; E_{hourly} = \min(E_{supply}, F_{low})}
59
59
  *
60
60
  * @subheading{Symbols}
61
61
  * @symtable
62
62
  * @symrow{E_{hourly}; Hourly energy savings; \MMBtu\per\hour}
63
63
  * @symrow{E_{supply}; Equivalent energy supply; \MMBtu\per\hour}
64
- * @symrow{F_{high}; High-temperature process firing rate; \MMBtu\per\hour}
64
+ * @symrow{F_{low}; Low-temperature process firing rate; \MMBtu\per\hour}
65
65
  * @endsymtable
66
66
  */
67
67
 
68
68
  /**
69
- * @defgroup cascade_heat_low_to_high_eq_energy_supply_formula Equivalent Energy Supply Formula
70
- * @ingroup cascade_heat_low_to_high_calculator
71
- * @brief Equivalent energy supply to the high-temperature process.
72
- * @details The equivalent energy supply is calculated by dividing the heat exchanger energy rate by the available heat of the high-temperature process.
69
+ * @defgroup cascade_heat_high_to_low_eq_energy_supply_formula Equivalent Energy Supply Formula
70
+ * @ingroup cascade_heat_high_to_low_calculator
71
+ * @brief Equivalent energy supply to the low-temperature process.
72
+ * @details The equivalent energy supply is calculated by dividing the heat exchanger energy rate by the available heat of the low-temperature process.
73
73
  *
74
- * @formula{cascade-low-to-high-eq-energy-supply; E_{supply} = \frac{Q_{hx}}{AH_{high}}}
74
+ * @formula{cascade-high-to-low-eq-energy-supply; E_{supply} = \frac{Q_{hx}}{AH_{low}}}
75
75
  *
76
76
  * @subheading{Symbols}
77
77
  * @symtable
78
78
  * @symrow{E_{supply}; Equivalent energy supply; \MMBtu\per\hour}
79
79
  * @symrow{Q_{hx}; Heat exchanger energy rate; \MMBtu\per\hour}
80
- * @symrow{AH_{high}; Available heat of high-temp process; \unitless}
80
+ * @symrow{AH_{low}; Available heat of low-temp process; \unitless}
81
81
  * @endsymtable
82
82
  */
83
83
 
84
84
  /**
85
- * @defgroup cascade_heat_low_to_high_hx_energy_rate_formula Heat Exchanger Energy Rate Formula
86
- * @ingroup cascade_heat_low_to_high_calculator
85
+ * @defgroup cascade_heat_high_to_low_hx_energy_rate_formula Heat Exchanger Energy Rate Formula
86
+ * @ingroup cascade_heat_high_to_low_calculator
87
87
  * @brief Energy transfer rate through the heat exchanger.
88
88
  * @details The heat exchanger energy rate is calculated by multiplying the flue gas volume, specific heat, density, and temperature difference, then dividing by the conversion factor.
89
89
  *
90
- * @formula{cascade-low-to-high-hx-energy-rate; Q_{hx} = \frac{V_{flue} \cdot C_{p} \cdot \rho_{flue} \cdot \Delta T}{CF}}
90
+ * @formula{cascade-high-to-low-hx-energy-rate; Q_{hx} = \frac{V_{flue} \cdot C_{p} \cdot \rho_{flue} \cdot \Delta T}{CF}}
91
91
  *
92
92
  * @subheading{Symbols}
93
93
  * @symtable
@@ -101,29 +101,29 @@
101
101
  */
102
102
 
103
103
  /**
104
- * @defgroup cascade_heat_low_to_high_flue_volume_formula Primary Flue Gas Volume Formula
105
- * @ingroup cascade_heat_low_to_high_calculator
106
- * @brief Flue gas volume from the low-temperature process.
104
+ * @defgroup cascade_heat_high_to_low_flue_volume_formula Primary Flue Gas Volume Formula
105
+ * @ingroup cascade_heat_high_to_low_calculator
106
+ * @brief Flue gas volume from the high-temperature process.
107
107
  * @details The flue gas volume is calculated using the firing rate, stoichiometric air volume, excess air, and fuel heating value.
108
108
  *
109
- * @formula{cascade-low-to-high-flue-volume; V_{flue} = \frac{F_{low} \cdot SAV_{low} \cdot (1 + EA_{low}) \cdot CF}{HV_{fuel}} + \frac{F_{low} \cdot CF}{HV_{fuel}}}
109
+ * @formula{cascade-high-to-low-flue-volume; V_{flue} = \frac{F_{high} \cdot SAV_{high} \cdot (1 + EA_{high}) \cdot CF}{HV_{fuel}} + \frac{F_{high} \cdot CF}{HV_{fuel}}}
110
110
  *
111
111
  * @subheading{Symbols}
112
112
  * @symtable
113
113
  * @symrow{V_{flue}; Flue gas volume; \scf\per\hour}
114
- * @symrow{F_{low}; Low-temperature process firing rate; \MMBtu\per\hour}
115
- * @symrow{SAV_{low}; Stoichiometric air volume; \scf\per\MMBtu}
116
- * @symrow{EA_{low}; Excess air (fraction); \unitless}
114
+ * @symrow{F_{high}; High-temperature process firing rate; \MMBtu\per\hour}
115
+ * @symrow{SAV_{high}; Stoichiometric air volume; \scf\per\MMBtu}
116
+ * @symrow{EA_{high}; Excess air (fraction); \unitless}
117
117
  * @symrow{CF; Conversion factor (e.g., 1,000,000 for MMBtu); \unitless}
118
118
  * @symrow{HV_{fuel}; Fuel heating value; \btu\per\scf}
119
119
  * @endsymtable
120
120
  */
121
121
 
122
122
  /**
123
- * @defgroup cascade_heat_low_to_high_flue_gas_properties Flue Gas Properties
124
- * @ingroup cascade_heat_low_to_high_calculator
123
+ * @defgroup cascade_heat_high_to_low_flue_gas_properties Flue Gas Properties
124
+ * @ingroup cascade_heat_high_to_low_calculator
125
125
  * @brief Flue gas properties for both processes.
126
- * @details Flue gas properties such as stoichiometric air volume, excess air, available heat, specific heat, and density are calculated for both the low-temperature and high-temperature processes using standard methods.
126
+ * @details Flue gas properties such as stoichiometric air volume, excess air, available heat, specific heat, and density are calculated for both the high-temperature and low-temperature processes using standard methods.
127
127
  *
128
128
  * @note See @ref gas_flue_gas_material_calculator for details on property calculations.
129
129
  */
package/docs/dox-content/calculators/process_heat_efficiency_improvement_calculator.dox ADDED
@@ -0,0 +1,169 @@
1
+ /**
2
+ * @defgroup process_heat_efficiency_improvement_calculator Process Heat Efficiency Improvement Calculator
3
+ * @ingroup process_heat_calculators
4
+ * @brief Calculates efficiency improvement and fuel savings for a fuel-fired furnace.
5
+ * @details This calculator estimates the benefit of efficiency improvements in a fuel-fired furnace by computing excess air, heat input, air properties, available heat, fuel savings, and new energy input. The calculation is based on standard thermodynamic relationships and is implemented in the @ref processHeatEfficiencyImprovement function.
6
+ *
7
+ * The calculation follows a top-down approach:
8
+ * 1. **Excess Air Calculation**: Compute current and new excess air from flue gas oxygen and air multipliers.
9
+ * 2. **Heat Input Calculation**: Compute current and new heat input from flue gas temperature and coefficients.
10
+ * 3. **Air Specific Heat Calculation**: Compute current and new air specific heat from combustion air temperature and coefficients.
11
+ * 4. **Air Correction Calculation**: Compute current and new air correction using air specific heat, flue gas temperature, and excess air.
12
+ * 5. **Combustion Air Correction Calculation**: Compute current and new combustion air correction using air specific heat, combustion air temperature, and excess air.
13
+ * 6. **Available Heat Calculation**: Compute current and new available heat as the sum of heat input, air correction, and combustion air correction.
14
+ * 7. **Fuel Savings Calculation**: Compute new fuel savings as the percent improvement in available heat.
15
+ * 8. **New Energy Input Calculation**: Compute new energy input based on current energy input and fuel savings.
16
+ *
17
+ * @heading{Excess Air Calculation}
18
+ * @copydoc pheic_excess_air_step
19
+ *
20
+ * @heading{Heat Input Calculation}
21
+ * @copydoc pheic_heat_input_step
22
+ *
23
+ * @heading{Air Specific Heat Calculation}
24
+ * @copydoc pheic_air_specific_heat_step
25
+ *
26
+ * @heading{Air Correction Calculation}
27
+ * @copydoc pheic_air_correction_step
28
+ *
29
+ * @heading{Combustion Air Correction Calculation}
30
+ * @copydoc pheic_combustion_air_correction_step
31
+ *
32
+ * @heading{Available Heat Calculation}
33
+ * @copydoc pheic_available_heat_step
34
+ *
35
+ * @heading{Fuel Savings Calculation}
36
+ * @copydoc pheic_fuel_savings_step
37
+ *
38
+ * @heading{New Energy Input Calculation}
39
+ * @copydoc pheic_new_energy_input_step
40
+ */
41
+
42
+ /**
43
+ * @defgroup pheic_excess_air_step Excess Air Calculation
44
+ * @ingroup process_heat_efficiency_improvement_calculator
45
+ * @brief Calculates current and new excess air.
46
+ * @details Computes the excess air percentage for both current and improved conditions based on measured flue gas oxygen and process-specific multipliers. Excess air is a key indicator of combustion efficiency and impacts fuel usage.
47
+ *
48
+ * @formula{pheic-excess-air; EA = \frac{100 \cdot S_A \cdot (\frac{O_2}{100})}{D_B - O_2M \cdot (\frac{O_2}{100})}}
49
+ *
50
+ * @symtable
51
+ * @symrow{EA; Excess air; \percent}
52
+ * @symrow{S_A; Stoichiometric air multiplier (8.52381); \unitless}
53
+ * @symrow{O_2; Flue gas oxygen (dry); \percent}
54
+ * @symrow{D_B; Denominator base (2.0); \unitless}
55
+ * @symrow{O_2M; O2 denominator multiplier (9.52381); \unitless}
56
+ * @endsymtable
57
+ */
58
+
59
+ /**
60
+ * @defgroup pheic_heat_input_step Heat Input Calculation
61
+ * @ingroup process_heat_efficiency_improvement_calculator
62
+ * @brief Calculates current and new heat input.
63
+ * @details Calculates the effective heat input to the process for both current and improved conditions, using flue gas temperature and empirical coefficients. Heat input reflects the energy delivered to the system.
64
+ *
65
+ * @formula{pheic-heat-input; HI = H_B + H_C \cdot T_{FG}}
66
+ *
67
+ * @symtable
68
+ * @symrow{HI; Heat input; \degreeFahrenheit}
69
+ * @symrow{H_B; Heat input base (95.0); \degreeFahrenheit}
70
+ * @symrow{H_C; Heat input temp coeff (-0.025); \degreeFahrenheit}
71
+ * @symrow{T_{FG}; Flue gas temperature; \degreeFahrenheit}
72
+ * @endsymtable
73
+ */
74
+
75
+ /**
76
+ * @defgroup pheic_air_specific_heat_step Air Specific Heat Calculation
77
+ * @ingroup process_heat_efficiency_improvement_calculator
78
+ * @brief Calculates current and new air specific heat.
79
+ * @details Determines the specific heat capacity of combustion air for both current and improved conditions, as a function of air temperature. This value is important for quantifying the energy required to heat the combustion air.
80
+ *
81
+ * @formula{pheic-air-specific-heat; C_{p,air} = C_B + C_C \cdot T_{CA}}
82
+ *
83
+ * @symtable
84
+ * @symrow{C_{p,air}; Air specific heat; \btu\per\pound\degreeFahrenheit}
85
+ * @symrow{C_B; Air specific heat base (0.017828518); \btu\per\pound\degreeFahrenheit}
86
+ * @symrow{C_C; Air specific heat temp coeff (0.000002556); \btu\per\pound\degreeFahrenheit}
87
+ * @symrow{T_{CA}; Combustion air temperature; \degreeFahrenheit}
88
+ * @endsymtable
89
+ */
90
+
91
+ /**
92
+ * @defgroup pheic_air_correction_step Air Correction Calculation
93
+ * @ingroup process_heat_efficiency_improvement_calculator
94
+ * @brief Calculates current and new air correction.
95
+ * @details Calculates the energy correction associated with heating excess air, for both current and improved conditions. This correction accounts for the energy lost to heating air that does not participate in combustion.
96
+ *
97
+ * @formula{pheic-air-correction; AC = -\left(A_B + C_{p,air} \cdot T_{FG}\right) \cdot \frac{EA}{100}}
98
+ *
99
+ * @symtable
100
+ * @symrow{AC; Air correction; \btu}
101
+ * @symrow{A_B; Air correction base (-1.07891327); \btu}
102
+ * @symrow{C_{p,air}; Air specific heat; \btu\per\pound\degreeFahrenheit}
103
+ * @symrow{T_{FG}; Flue gas temperature; \degreeFahrenheit}
104
+ * @symrow{EA; Excess air; \percent}
105
+ * @endsymtable
106
+ */
107
+
108
+ /**
109
+ * @defgroup pheic_combustion_air_correction_step Combustion Air Correction Calculation
110
+ * @ingroup process_heat_efficiency_improvement_calculator
111
+ * @brief Calculates current and new combustion air correction.
112
+ * @details Computes the energy correction for heating the total combustion air (including excess air), for both current and improved conditions. This step quantifies the energy required to bring all combustion air to the desired temperature.
113
+ *
114
+ * @formula{pheic-combustion-air-correction; CAC = \left(CA_B + C_{p,air} \cdot T_{CA}\right) \cdot \left(1 + \frac{EA}{100}\right)}
115
+ *
116
+ * @symtable
117
+ * @symrow{CAC; Combustion air correction; \btu}
118
+ * @symrow{CA_B; Combustion air correction base (-1.078913827); \btu}
119
+ * @symrow{C_{p,air}; Air specific heat; \btu\per\pound\degreeFahrenheit}
120
+ * @symrow{T_{CA}; Combustion air temperature; \degreeFahrenheit}
121
+ * @symrow{EA; Excess air; \percent}
122
+ * @endsymtable
123
+ */
124
+
125
+ /**
126
+ * @defgroup pheic_available_heat_step Available Heat Calculation
127
+ * @ingroup process_heat_efficiency_improvement_calculator
128
+ * @brief Calculates current and new available heat.
129
+ * @details Sums the heat input and both air corrections to determine the available heat for the process, for both current and improved conditions. Available heat represents the fraction of input energy that is actually usable for the process.
130
+ *
131
+ * @formula{pheic-available-heat; AH = HI + AC + CAC}
132
+ *
133
+ * @symtable
134
+ * @symrow{AH; Available heat; \percent}
135
+ * @symrow{HI; Heat input; \degreeFahrenheit}
136
+ * @symrow{AC; Air correction; \btu}
137
+ * @symrow{CAC; Combustion air correction; \btu}
138
+ * @endsymtable
139
+ */
140
+
141
+ /**
142
+ * @defgroup pheic_fuel_savings_step Fuel Savings Calculation
143
+ * @ingroup process_heat_efficiency_improvement_calculator
144
+ * @brief Calculates new fuel savings.
145
+ * @details Calculates the percentage of fuel saved by implementing the efficiency improvement, based on the increase in available heat. This value quantifies the benefit of the improvement in terms of reduced fuel consumption.
146
+ *
147
+ * @formula{pheic-fuel-savings; FS = \frac{AH_{new} - AH_{current}}{AH_{new}} \cdot 100}
148
+ *
149
+ * @symtable
150
+ * @symrow{FS; Fuel savings; \percent}
151
+ * @symrow{AH_{new}; New available heat; \percent}
152
+ * @symrow{AH_{current}; Current available heat; \percent}
153
+ * @endsymtable
154
+ */
155
+
156
+ /**
157
+ * @defgroup pheic_new_energy_input_step New Energy Input Calculation
158
+ * @ingroup process_heat_efficiency_improvement_calculator
159
+ * @brief Calculates new energy input.
160
+ * @details Determines the new required energy input to the process after efficiency improvements, accounting for the calculated fuel savings. This step provides the expected reduction in energy demand.
161
+ *
162
+ * @formula{pheic-new-energy-input; EI_{new} = EI_{current} \cdot \left(1 - \frac{FS}{100}\right)}
163
+ *
164
+ * @symtable
165
+ * @symrow{EI_{new}; New energy input; \MMBtu\per\hour}
166
+ * @symrow{EI_{current}; Current energy input; \MMBtu\per\hour}
167
+ * @symrow{FS; Fuel savings; \percent}
168
+ * @endsymtable
169
+ */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "measur-tools-suite",
3
- "version": "1.0.14-beta.222",
3
+ "version": "1.0.14-beta.225",
4
4
  "engines": {
5
5
  "node": "20.19.4",
6
6
  "npm": "10.8.2"