Shortcut for creating MpcInput with defaults.

Call compute_mpc and return only the MpcOutput (discard state). Most tests only need the output; the few that inspect the returned state can

Create a mock BT climate entity with sensible defaults.

Return MpcParams with sane test defaults (fast updates, no hold-time). Parameters listed before the comment always override the dataclass default

Build a minimal HA State object.

Round the value based on the allowed decimal 'step' size. Parameters ---------- value : float the value to round step : f

Trigger a change in the trv state.

Build a mock event whose context differs from bt.context.

Process one temperature reading and return what changed.

Offset from _NOW by *minutes*.

Run the predictive controller and emit a valve recommendation. Parameters ---------- inp: Current measurements and context. p

Build a BetterThermostat stand-in carrying the attrs weather.py touches.

Build a hass mock wiring states.get and services.async_call.

Build a TRV State with typical attributes.

Compute the current HVAC action without mutating *hysteresis*. Rules ----- - OFF mode → OFF regardless of temperatures. - Open window

Handle temperature changes. Parameters ---------- self : self instance of better_thermostat event : Event obj

Build a mock event with the given new_state.

Return compute_hvac_action kwargs with sensible defaults.

Convert value to float or print error message. Parameters ---------- value : str | int | float | None the value to convert to

Process one temperature reading and return what changed.

Build a minimal HA State object.

Check if a string is a float. Parameters ---------- potential_float : the value to check Returns ------- bool

Control a single TRV by setting temperature, HVAC mode, calibration, and valve position. All operations are executed within self._temp_lock to en

Create and track an asyncio task with automatic cleanup on completion. Parameters ---------- coro : Coroutine The

Compute PID-based valve opening percentage. Parameters ---------- params: PID tuning parameters. inp_target_temp_C: T

Create a StateManager with a mocked Store (empty initial state).

Apply hysteresis so heating restarts only below target - tolerance.

Update state from climate entity.

Check optional sensors and update degraded mode status. Sets self.degraded_mode to True if any optional sensor is unavailable. Updates self.u

Trigger a change in the cooler state.

Build a mock event whose context differs from bt.context.

Distribute a group MPC valve command across TRVs based on internal temps. The **warmest TRV** is used as the reference and receives exactly `

Create a mock EntityRegistry.

Create a mock HA Store with configurable async_load return.

Switch to *preset*. Returns new target temperature, or ``None``.

Add a new measurement for a certain day (value: float).

Detect systematic bias in prediction errors using Student's t-test. If the mean error deviates significantly from 0 relative to standard deviatio

Compute an expected valve position from the heating power. Given the global `heating_power` estimate and the target/current temperature, a he

Remap HVAC mode to correct mode if nessesary. Parameters ---------- self : FIXME hvac_mode : str HVAC mode to

Create a mock BetterThermostat instance with common defaults. Parameters ---------- trv_state : str or None The state to return f

Check if an entity is available without side effects. Parameters ---------- hass : Home Assistant instance entity : str

Check only critical entities (TRVs). Returns True if all TRVs are available. Does not block on optional sensors. Returns ------- boo

Process control commands from the queue and coordinate TRV control. This async task runs continuously, processing control requests from the c

Convert outbound states for TRV control. Returns the payload for setting the TRV state.

Build a minimal mock BetterThermostat instance for calibration tests. ``bt_hvac_mode`` is set to ``HVACMode.OFF`` so that MPC / TPI / PID int

Read a temperature attribute from a foreign state and return it in °C. The single inbound boundary for foreign temperatures: it resolves the sour

Check configured weather entity over roughly the next two days. The forecast horizon is normalised to about two days regardless of the entity

Convert value to float and ensure it is in Celsius. If *unit_of_measurement* indicates Fahrenheit the value is converted to Celsius after the

Return the PIDState for key or None if missing. This is a small helper used externally to read persisted/learned gains.

Hydrate MPC states from a previously exported mapping.

Migrate data from the four legacy Store files into the unified store. Skips silently when the unified store already contains data (i.e. the m

Create a MaintenanceTrvInfo with sensible defaults.

Build a TRV State carrying a target temperature (and optional unit).

Build a ``real_trvs[entity_id]`` dict for testing.

Return a serializable mapping of MPC states, optionally filtered by key prefix.

Deserialize raw dicts from legacy stores into the unified state. Parameters ---------- state_mgr: The StateManager to populate.

Calculate local delta to adjust the setpoint of the TRV based on the air temperature of the external sensor. This calibration is for devices with

Get the history for two days and evaluates the necessary for heating. Returns ------- bool True if the average temperature is

Clamp *value* into ``[lo, hi]``.

Return ``True`` iff ``value`` is a plausible indoor temperature in °C. Rejects ``None`` and any value outside ``MIN_REASONABLE_TEMPERATURE`` ..

Simplified version of Home Assistant's reduce_attribute helper.

Resolve the restored heating target. With a usable numeric *saved* value, clamp it into ``[min_temp, max_temp]`` (defaults 5.0 / 30.0). When

Build a weather entity state advertising forecast support and a temp.

Apply the new external temperature and trigger updates.

Compute TPI duty cycle and on/off durations. Parameters ---------- inp: Current measurements and context. params: Con

Reconstruct a RuntimeState from a raw dict (loaded from Store).

Round to decimals if not None.

Derive min/max/step temperature from TRV states.

Add a TRV configuration.

Build a minimal stand-in for a HA State with state and attributes.

Mean of the valid TRV target temperatures, each converted to Celsius. Returns ``None`` when no TRV exposes a usable target temperature.

Get set of calibration algorithms currently in use by any TRV.

Create a StateManager with a mocked Store.

Restore previous state from HA state machine or fall back to defaults.

Check weather predictions or ambient air temperature if available. Parameters ---------- self : self instance of better_therm

Normalize a calibration_mode field from TRV advanced data.

Normalize a hvac_mode value to a proper HVACMode enum when possible. Accepts ------- value : HVACMode | str - HVACMode enum: retu

Set MPC state for a key and mark dirty.

Determine whether heating should be active based on hysteresis. Band: ``[target - tolerance, target)`` * Start heating when ``cur_temp < targ

Return a default real_trvs entry for a single TRV.

Set up room temperature, humidity, cooler and window sensors.

Create a mock ConfigEntry.

Create a StateManager with a mocked Store.

Build a sensor State.

Deserialize a single MPC state dict into an MpcState dataclass.

Determine valve control settings based on boost mode or calibration. Returns a tuple of (valve_settings_dict, source_name). valve_settings_di

Return a BT-level (group) key for MPC state tracking. All TRVs under the same BT instance share this key so that a single MPC model learns th

Compute and commit the HVAC action, return the result.

Compute the offset to push setpoint below TRV temp when valve fraction is zero. Returns the offset so that callers can set: _calibrated_s