enex_analysis.ashpb_stc_preheat

ASHPB with SolarThermalCollector — mains_preheat placement.

Phase 3 restructuring: all simulation orchestration logic (activation probe, result assembly, exergy calculation) is implemented directly in this class. SolarThermalCollector is used purely as a physics engine (calc_performance()), with no dependency on step(), assemble_results(), or calc_exergy().

Note

Theoretical overview, system boundaries, and orchestration logic for hybrid systems are detailed in Hybrid Heat Pump Systems.

Usage

from enex_analysis import SolarThermalCollector
from enex_analysis.ASHPB_STC_preheat import ASHPB_STC_preheat

stc = SolarThermalCollector(A_stc=4.0)
model = ASHPB_STC_preheat(
    stc=stc,
    ref="R134a",
    hp_capacity=15_000.0,
    T_tank_w_lower_bound=55.0,
    T_tank_w_upper_bound=65.0,
    T_mix_w_out=42.0,
)
df = model.analyze_dynamic(...)

Classes

ASHPB_STC_preheat(*, stc, **kwargs)

ASHPB + SolarThermalCollector in mains_preheat placement.

class enex_analysis.ashpb_stc_preheat.ASHPB_STC_preheat(*, stc, **kwargs)

ASHPB + SolarThermalCollector in mains_preheat placement.

Physical configuration

The STC preheats mains cold water before it enters the storage tank. The raised inlet temperature (T_tank_w_in_override_K) reduces the thermal load on the heat pump compressor.

Orchestration responsibility

This class owns all simulation logic for the STC:

• _run_subsystems: activation probe + calc_performance() → sets T_tank_w_in_override_K when active

• _augment_results: result column assembly (uses pump outlet temperature directly; no re-evaluation at solved tank temp)

• _postprocess: STC exergy calculation. Tank boundary corrections are not applied because the preheated inlet temperature is already reflected in the core X_tank_w_in [W] column (X_in_tank_add = 0).

type stc:

SolarThermalCollector

param stc:

Pure physics engine. No mode constraint required.

type stc:

SolarThermalCollector

type **kwargs:

param **kwargs:

Forwarded to AirSourceHeatPumpBoiler.

raises TypeError:

If stc is not a SolarThermalCollector instance.

__init__(*, stc, **kwargs)

Parameters:

stc (SolarThermalCollector)