breos.battery.apply_indoor_temperature_model#
- breos.battery.apply_indoor_temperature_model(outdoor_temperature, setpoint_c=22.0, coupling_alpha=0.3, floor_c=15.0, ceiling_c=35.0)[source]#
Transform outdoor temperature to indoor temperature for battery simulation.
Residential batteries are installed indoors where building thermal mass buffers outdoor extremes. This stateless preprocessing applies a weighted blend with clamp before temperatures enter the simulation loop.
T_indoor = clamp(alpha * T_outdoor + (1 - alpha) * T_setpoint, floor, ceiling)
- Parameters:
outdoor_temperature (
Series) – Outdoor ambient temperature series (°C)setpoint_c (
float) – Indoor comfort midpoint (°C)coupling_alpha (
float) – How much outdoor temp influences indoor (0=insulated, 1=outdoor)floor_c (
float) – Minimum indoor temperature (°C)ceiling_c (
float) – Maximum indoor temperature (°C)
- Return type:
- Returns:
Indoor temperature series (°C), same index as input