enex_analysis.gas_boiler

Gas boiler model for steady-state and dynamic energy analysis.

Models a direct-supply gas boiler without a storage tank. The system chain is: Combustion Chamber → Mixing Valve → Service Water. Full energy, entropy, and exergy balances are computed at each operating point.

Classes

GasBoiler([eta_comb, T_serv_w, T_sup_w, ...])

Direct-supply gas boiler with energy / entropy / exergy accounting.
class enex_analysis.gas_boiler.GasBoiler(eta_comb=0.9, T_serv_w=45.0, T_sup_w=15.0, T_exh=70.0, T_comb_setpoint=60.0, dV_w_serv_m3s=0.0001)[source]

Direct-supply gas boiler with energy / entropy / exergy accounting.

The boiler heats mains water to T_comb_setpoint and mixes it with bypass water through a mixing valve to deliver service water at T_serv_w. No thermal storage tank is used.

__init__(eta_comb=0.9, T_serv_w=45.0, T_sup_w=15.0, T_exh=70.0, T_comb_setpoint=60.0, dV_w_serv_m3s=0.0001)[source]
analyze_steady(T0, Q_heat_target, *, return_dict=True)[source]

Run a steady-state performance snapshot.

Parameters:

  • T0 (float)

  • Q_heat_target (float)

  • return_dict (bool)

Return type:

dict | DataFrame

analyze_dynamic(simulation_period_sec, dt_s, dhw_usage_schedule, T0_schedule, heater_capacity_const=None, heater_capacity_schedule=None, result_save_csv_path=None)[source]

Run a time-stepping dynamic simulation.

Parameters:

  • simulation_period_sec (int) – Total simulation duration [s].

  • dt_s (int) – Time step size [s].

  • dhw_usage_schedule (list of tuple) – DHW schedule as (start_str, end_str, fraction) entries.

  • T0_schedule (array-like) – Dead-state temperature per time step [°C].

  • heater_capacity_const (float, optional) – Fixed heater power [W].

  • heater_capacity_schedule (array-like, optional) – Time-varying heater power [W].

  • result_save_csv_path (str, optional) – Path to save result CSV.

Returns:

Per-timestep simulation results.

Return type:

pd.DataFrame