Struct HeatingStatsEntry

pub struct HeatingStatsEntry {
    pub date: NaiveDate,
    pub energy: f64,
    pub ambient_temperature_average_value: f64,
    pub ambient_temperature_average_counter: i64,
    pub water_temperature_average_value: f64,
    pub water_temperature_average_counter: i64,
    pub heating_control_runtime: i64,
}

Holds the statistical data of heating for one day. It is filled with post-processed data from a database query which is then updated by the control application.

Fields

date: NaiveDate

calendar date of the entry after having postprocessed the SQL data read as String

energy: f64

energy used for heating on a specific date in kWh

ambient_temperature_average_value: f64

average ambient temperature value on a specific date in °C

ambient_temperature_average_counter: i64

counter how many samples were used to calculate the average value

water_temperature_average_value: f64

average water temperature value on a specific date in °C

water_temperature_average_counter: i64

counter how many samples were used to calculate the average value

heating_control_runtime: i64

counter how many seconds the heating control was active on a specific date

Implementations

impl HeatingStatsEntry

pub fn new(conn: &mut PooledConn) -> HeatingStatsEntry

Creates a new HeatingStatsEntry initialized for the current local date.

This constructor is used when there’s no existing heating statistics record for the current day in the database. It sets the date field to today’s date and initializes all statistical counters and values to zero.

Returns

A new HeatingStatsEntry struct with default values for the current date.

pub fn update( &mut self, water_temperature_opt: Option<f64>, ambient_temperature_opt: Option<f64>, energy_increment: f64, )

Updates the heating statistics entry with new sensor readings and energy consumption data.

This method incorporates new samples to incrementally calculate average water and ambient temperatures, sum up energy consumption, and track the heating control’s active runtime.

Arguments

• water_temperature_opt - An Option<f64> representing the latest water temperature reading. If Some, it contributes to the average; if None, the water temperature average remains unchanged.
• ambient_temperature_opt - An Option<f64> representing the latest ambient air temperature reading. If Some, it contributes to the average; if None, the ambient temperature average remains unchanged.
• energy_increment - The amount of energy (in kWh) consumed by the heater since the last update.

Trait Implementations

impl Clone for HeatingStatsEntry

fn clone(&self) -> HeatingStatsEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Display for HeatingStatsEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the HeatingStatsEntry struct into a multi-line, human-readable string.

This implementation is primarily intended for debugging and logging, providing a clear overview of the heating statistics for a given date, including average temperatures, energy consumption, and control runtime.

Arguments

• f - A mutable reference to the formatter, as required by the fmt::Display trait.

Returns

A fmt::Result indicating whether the formatting operation was successful.