heat_net ¶

HeatNet ¶

HeatNet(cp, initial_temp, mass_flow, lower_threshold, upper_threshold)

A class that represents a heating network.

Parameters:

Name	Type	Description	Default
`cp`	`float`	Specific heat capacity of the fluid in the heating network [kJ/(kg*K)].	required
`initial_temp`	`float`	Initial temperature of the heating network [°C].	required
`mass_flow`	`float`	Mass flow of the fluid in the heating network [kg/h].	required
`lower_threshold`	`float`	Lower threshold of the heating network (temperature must not fall below this value) [°C].	required
`upper_threshold`	`float`	Upper threshold of the heating network (temperature must not rise above this value) [°C].	required

Source code in src/bsm2_python/energy_management/heat_net.py

def __init__(
    self, cp: float, initial_temp: float, mass_flow: float, lower_threshold: float, upper_threshold: float
) -> None:
    self.cp = cp
    self.temperature = initial_temp
    self.mass_flow = mass_flow
    self.lower_threshold = lower_threshold
    self.upper_threshold = upper_threshold

update_temperature ¶

update_temperature(heat)

Sets new temperature based on heat input, previous temperature of HeatNet and mass_flow in the heat_network.

Implements the equation: T_{new} = T_{old} + Q / (m_dot ⋅ c_p)

Parameters:

Name	Type	Description	Default
`heat`	`float`	Heat input [kW].	required

Source code in src/bsm2_python/energy_management/heat_net.py

def update_temperature(self, heat: float) -> None:
    """Sets new temperature based on heat input, previous temperature of HeatNet and mass_flow in the heat_network.

    Implements the equation: T_{new} = T_{old} + Q / (m_dot ⋅ c_p)

    Parameters
    ----------
    heat: float
        Heat input [kW].
    """

    self.temperature += heat / (self.mass_flow * (self.cp / 3600))

calculate_heat ¶

calculate_heat(new_temperature)

Calculates heat output based on old and new temperature and mass flow in the heat_network.

Implements the equation: Q = m_dot ⋅ c_p ⋅ (T_{new} - T_{old})

Parameters:

Name	Type	Description	Default
`new_temperature`	`float`	Temperature [°C].	required

Returns:

Type	Description
`float`	Heat output [kW].

Source code in src/bsm2_python/energy_management/heat_net.py

def calculate_heat(self, new_temperature: float) -> float:
    """Calculates heat output based on old and new temperature and mass flow in the heat_network.

    Implements the equation: Q = m_dot ⋅ c_p ⋅ (T_{new} - T_{old})

    Parameters
    ----------
    new_temperature: float
        Temperature [°C].

    Returns
    -------
    float
        Heat output [kW].
    """

    return self.mass_flow * (self.cp / 3600) * (new_temperature - self.temperature)

calculate_temperature ¶

calculate_temperature(heat, temperature_old)

Calculates temperature based on heat input, previous temperature and mass_flow in the heat_network.

Implements the equation: T_{new} = T_{old} + Q / (m_dot ⋅ c_p)

Parameters:

Name	Type	Description	Default
`heat`	`float`	Heat input [kW].	required
`temperature_old`	`float`	Initial temperature [°C].	required

Returns:

Type	Description
`float`	New temperature [°C].

Source code in src/bsm2_python/energy_management/heat_net.py

def calculate_temperature(self, heat: float, temperature_old: float) -> float:
    """Calculates temperature based on heat input, previous temperature and mass_flow in the heat_network.

    Implements the equation: T_{new} = T_{old} + Q / (m_dot ⋅ c_p)

    Parameters
    ----------
    heat: float
        Heat input [kW].
    temperature_old: float
        Initial temperature [°C].

    Returns
    -------
    float
        New temperature [°C].
    """

    temperature_new = temperature_old + heat / (self.mass_flow * (self.cp / 3600))
    return temperature_new