enex_analysis.ashpb_stc_tank

ASHPB with SolarThermalCollector — tank_circuit 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_tank import ASHPB_STC_tank

stc = SolarThermalCollector(A_stc=4.0)
model = ASHPB_STC_tank(
    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_tank(*, stc, **kwargs)

ASHPB + SolarThermalCollector in tank_circuit placement.

class enex_analysis.ashpb_stc_tank.ASHPB_STC_tank(*, stc, **kwargs)

ASHPB + SolarThermalCollector in tank_circuit placement.

Physical configuration

The STC collector loop is connected directly to the storage tank. The STC draws water from the tank, heats it via solar energy, and returns it through the pump. The STC is activated only when the collector outlet temperature exceeds the current tank temperature.

Orchestration responsibility

This class owns all simulation logic for the STC:

• _run_subsystems: activation probe + calc_performance()

• _augment_results: result column assembly (re-evaluates at solved tank temperature for accuracy)

• _postprocess: STC exergy calculation and tank boundary correction (X_tot, Xc_tank)

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)