measur-tools-suite 1.2.1-beta.13 → 1.2.1-beta.14

package/.agents/handoffs/compressed-air-desktop-migration.md

@@ -106,12 +106,16 @@
 - `calculateBaselineProfile(compressors, profileRows, options): CompressorProfileRowV`
   - Inputs: `CompressorProfileCompressorV`, `CompressorProfileRowV`, `CompressorProfileOptions`.
   - Outputs: registered vector of calculated compressor rows. Caller must call `delete()`.
+- `CompressorProfileCompressor.unloadPointCapacityPct`
+  - Map from Desktop `compressor.compressorControls.unloadPointCapacity`.
+  - Units: percent. Pass zero only when Suite should derive the value from the unload airflow and full-load airflow points.
 - `calculateProfileTotals(compressors, profileRows): CompressorProfileTotalV`
   - Inputs: compressor vector, calculated row vector.
   - Outputs: registered vector of total rows. Caller must call `delete()`.
 - `reallocateProfileFlow(compressors, previousProfileRows, demandRows, options, runtimeStates, trimSelections): CompressorProfileRowV`
   - Inputs: compressor vector, prior row vector, demand total vector, options, runtime state vector, trim selection vector.
   - Outputs: registered vector of adjusted compressor rows. Caller must call `delete()`.
+  - Base-trim mode uses `trimSelections` to select the trim compressor. If demand is within trim capacity, only the trim compressor runs. When demand exceeds trim capacity, Suite selects the smallest base-compressor set that covers the excess over trim capacity, chooses the lowest full-load power combination within that size, evaluates selected bases before the trim compressor, and recalculates a selected base below full load if full load would exceed remaining demand. The trim compressor is evaluated last and receives any remaining airflow.
 - `calculateProfileSavings(baselineRows, adjustedRows, input): CompressorProfileSavingsResult`
   - Inputs: baseline row vector, adjusted row vector, electricity cost dollars/kWh, interval hours, operating days, auxiliary energy kWh/year, implementation cost dollars, salvage dollars.
   - Outputs: annual baseline/adjusted energy kWh, annual baseline/adjusted cost dollars, energy savings kWh, cost savings dollars, percent savings, payback months.

package/bin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "measur-tools-suite",
-  "version": "1.2.1-beta.13",
+  "version": "1.2.1-beta.14",
   "engines": {
     "node": "20.19.4",
     "npm": "10.8.2"

package/bin/ts_def_modules/compressedAir/assessment/compressor_system_profile.d.ts

@@ -43,6 +43,8 @@ export interface CompressorProfileCompressor {
     blowdownTimeSec: number;
     /** Unload sump pressure, units psig. */
     unloadSumpPressurePsig: number;
+    /** Explicit unload capacity, units percent; pass zero to derive from performance points. */
+    unloadPointCapacityPct: number;
     /** Modulation floor fraction, dimensionless. */
     noLoadPowerFractionForModulation: number;
     /** Modulating pressure range, units psig. */

package/docs/dox-content/calculators/compressedAir/assessment/compressor_system_profile.dox

@@ -55,7 +55,9 @@
  *          point is treated as the standard 100 percent unload-capacity setting. This keeps
  *          the cycle model anchored at full-load airflow when the assessment has no separate
  *          unload-point airflow value, rather than interpreting the missing point as zero
- *          unload capacity.
+ *          unload capacity. When an assessment supplies an explicit unload-capacity setting,
+ *          that percentage is used directly; otherwise the percentage is derived from the
+ *          unload airflow point and the full-load airflow point.
  *
  * @formula{compressor-profile-system-airflow-fraction;
  *   f_{Q,sys,i} = \frac{Q_i}{\sum_j Q_{FL,j}}
@@ -112,9 +114,16 @@
  * @details Load-sharing operation looks at the available compressor combinations that can meet
  *          the requested demand and selects the combination with the lowest total package
  *          power. The selected compressors split demand equally where possible. Base-trim
- *          operation keeps a selected trim compressor available for each day type, then
- *          evaluates feasible base-compressor combinations around that trim compressor and
- *          selects the lowest-power combination that can meet demand.
+ *          operation keeps a selected trim compressor available for each day type. The trim
+ *          compressor is the adjustable compressor. If the requested airflow is within trim
+ *          capacity, only the trim compressor runs. When demand exceeds trim capacity, the
+ *          algorithm finds the smallest number of base compressors that can cover the excess
+ *          airflow over trim capacity, then chooses the lowest full-load power combination
+ *          within that size. The selected base compressors are evaluated before the trim
+ *          compressor. Each selected base is first tried at full load, but if that would
+ *          exceed the remaining demand, that base compressor is recalculated at the smaller
+ *          remaining airflow. The trim compressor is evaluated last and supplies any
+ *          remaining airflow.
  *
  * @formula{compressor-profile-combination-power;
  *   P_{combo} = \sum_{i \in S} P_i(Q_i)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "measur-tools-suite",
-  "version": "1.2.1-beta.13",
+  "version": "1.2.1-beta.14",
   "engines": {
     "node": "20.19.4",
     "npm": "10.8.2"

package/ts_def/ts_def_modules/compressedAir/assessment/compressor_system_profile.d.ts

@@ -43,6 +43,8 @@ export interface CompressorProfileCompressor {
     blowdownTimeSec: number;
     /** Unload sump pressure, units psig. */
     unloadSumpPressurePsig: number;
+    /** Explicit unload capacity, units percent; pass zero to derive from performance points. */
+    unloadPointCapacityPct: number;
     /** Modulation floor fraction, dimensionless. */
     noLoadPowerFractionForModulation: number;
     /** Modulating pressure range, units psig. */