honeybee_energy.ventcool.control module

Object to dictate setpoints and schedule for ventilative cooling.

class honeybee_energy.ventcool.control.VentilationControl(*args, **kwargs)[source]

Bases: object

Object to dictate setpoints and schedule for ventilative cooling.

Note the all of the default setpoints of this object are set to always perform ventilative cooling such that users can individually decide which setpoints are relevant to a given ventilation strategy.

Parameters
  • min_indoor_temperature – A number between -100 and 100 for the minimum indoor temperature at which to ventilate in Celsius. Typically, this variable is used to initiate ventilation. (Default: -100).

  • max_indoor_temperature – A number between -100 and 100 for the maximum indoor temperature at which to ventilate in Celsius. This can be used to set a maximum temperature at which point ventilation is stopped and a cooling system is turned on. (Default: 100).

  • min_outdoor_temperature – A number between -100 and 100 for the minimum outdoor temperature at which to ventilate in Celsius. This can be used to ensure ventilative cooling doesn’t happen during the winter even if the Room is above the min_indoor_temperature. (Default: -100).

  • max_outdoor_temperature – A number between -100 and 100 for the maximum outdoor temperature at which to ventilate in Celsius. This can be used to set a limit for when it is considered too hot outside for ventilative cooling. (Default: 100).

  • delta_temperature – A number between -100 and 100 for the temperature differential in Celsius between indoor and outdoor below which ventilation is shut off. This should usually be a positive number so that ventilation only occurs when the outdoors is cooler than the indoors. Negative numbers indicate how much hotter the outdoors can be than the indoors before ventilation is stopped. (Default: -100).

  • schedule – An optional ScheduleRuleset or ScheduleFixedInterval for the ventilation over the course of the year. Note that this is applied on top of any setpoints. The type of this schedule should be On/Off and values should be either 0 (no possibility of ventilation) or 1 (ventilation possible). (Default: “Always On”)

Properties:
  • min_indoor_temperature

  • max_indoor_temperature

  • min_outdoor_temperature

  • max_outdoor_temperature

  • delta_temperature

  • schedule

ToString()[source]

Overwrite .NET ToString.

duplicate()[source]

Get a copy of this object.

classmethod from_dict(data)[source]

Create a VentilationControl from a dictionary.

Parameters

data – A python dictionary in the following format

{
"type": 'VentilationControl',
"min_indoor_temperature": 22,
"max_indoor_temperature": 26,
"min_outdoor_temperature": 12,
"max_outdoor_temperature": 32,
"delta_temperature": -4,
"schedule": {}  # dictionary of a schedule
}
classmethod from_dict_abridged(data, schedule_dict)[source]

Create a VentilationControl from an abridged dictionary.

Parameters
  • data – A VentilationControlAbridged dictionary with the format below.

  • schedule_dict – A dictionary with schedule identifiers as keys and honeybee schedule objects as values. These will be used to assign the schedule to the VentilationControl object.

{
"type": 'VentilationControlAbridged',
"min_indoor_temperature": 22,
"max_indoor_temperature": 26,
"min_outdoor_temperature": 12,
"max_outdoor_temperature": 32,
"delta_temperature": -4,
"schedule": ""  # identifier of a schedule
}
lock()
to_dict(abridged=False)[source]

Ventilation Control dictionary representation.

unlock()
property delta_temperature

Get or set the indoor/outdoor temperature difference for ventilation (C).

property max_indoor_temperature

Get or set a number for the maximum indoor temperature for ventilation (C).

property max_outdoor_temperature

Get or set a number for the maximum outdoor temperature for ventilation (C).

property min_indoor_temperature

Get or set a number for the minimum indoor temperature for ventilation (C).

property min_outdoor_temperature

Get or set a number for the minimum outdoor temperature for ventilation (C).

property schedule

Get or set an On/Off schedule for the ventilation.

Note that this is applied on top of any setpoints.