honeybee_energy.hvac.heatcool.evapcool module

Direct evaporative cooling systems (with optional heating).

class honeybee_energy.hvac.heatcool.evapcool.EvaporativeCooler(identifier, vintage='ASHRAE_2019', equipment_type=None, unit_ventilators=False, sensible_heat_recovery=0, latent_heat_recovery=0, vent_availability_schedule=None)[source]

Bases: _HeatCoolBase

Direct evaporative cooling systems (with optional heating).

Each room/zone will receive its own air loop sized to meet the sensible load, which contains an evaporative cooler that directly adds humidity to the room air to cool it. The loop contains an outdoor air mixer, which is used whenever the outdoor air has a lower wet bulb temperature than the return air from the room. In the event that the combination of outdoor and room return air air is too humid, a backup single-speed direct expansion (DX) cooling coil will be used. Heating loads can be met with various options, including several types of baseboards, a furnace, or gas unit heaters.

Parameters:

  • identifier – Text string for system identifier. Must be < 100 characters and not contain any EnergyPlus special characters. This will be used to identify the object across a model and in the exported IDF.

  • vintage –

    Text for the vintage of the template system. This will be used to set efficiencies for various pieces of equipment within the system. Choose from the following.

    • DOE_Ref_Pre_1980

    • DOE_Ref_1980_2004

    • ASHRAE_2004

    • ASHRAE_2007

    • ASHRAE_2010

    • ASHRAE_2013

    • ASHRAE_2016

    • ASHRAE_2019

  • equipment_type –

    Text for the specific type of the system and equipment. (Default: the first option below) Choose from.

    • EvapCoolers_ElectricBaseboard

    • EvapCoolers_BoilerBaseboard

    • EvapCoolers_ASHPBaseboard

    • EvapCoolers_DHWBaseboard

    • EvapCoolers_Furnace

    • EvapCoolers_UnitHeaters

    • EvapCoolers

  • unit_ventilators – Boolean to note whether individual zone ventilators are included with the basic heating and cooling system (True) or the system only performs heating and cooling without any ventilation (False). Unlike a DOAS, unit ventilators do not pass the outdoor air through heating or cooling coils to condition it for the space. However, heat recovery effectiveness can be specified, which can temper the air supplied to the zone by the ventilator with exhaust air. All air flow through this ventilator is always balanced for each zone between supply and exhaust and the total flow rate is determined by checking the ventilation and exhaust requirements of the rooms to which the system is assigned. (Default: False).

  • sensible_heat_recovery – A number between 0 and 1 for the effectiveness of sensible heat recovery within unit ventilators if specified. (Default: 0).

  • latent_heat_recovery – A number between 0 and 1 for the effectiveness of latent heat recovery within unit ventilators if specified. (Default: 0).

  • vent_availability_schedule – An optional On/Off discrete schedule to specify when unit ventilators shut off (assuming that the unit_ventilators is True). This will not only reduce heating and cooling load by preventing outdoor air from flowing but will also shut off the fans, which can result in more energy savings when spaces served by the ventilators are completely unoccupied. If None, the unit ventilators will be always on. (Default: None).

Properties:

  • identifier

  • display_name

  • vintage

  • equipment_type

  • unit_ventilators

  • sensible_heat_recovery

  • latent_heat_recovery

  • vent_availability_schedule

  • has_air_loop

  • has_district_heating

  • has_district_cooling

  • balances_exhaust

  • user_data

  • properties

ToString()

Overwrite .NET ToString.

duplicate()

Get a copy of this object.

classmethod from_dict(data)

Create a HVAC object from a dictionary.

Parameters:

data – A HeatCool dictionary in following the format below.

{
"type": "",  # text for the class name of the HVAC
"identifier": "Classroom1_System",  # identifier for the HVAC
"display_name": "Standard System",  # name for the HVAC
"vintage": "ASHRAE_2019",  # text for the vintage of the template
"equipment_type": "",  # text for the HVAC equipment type
"unit_ventilators": True,  # boolean for unit ventilators
"sensible_heat_recovery": 0.75,  # sensible heat recovery effectiveness
"latent_heat_recovery": 0.7,  # latent heat recovery effectiveness
"vent_availability_schedule": {},  # Schedule for DOAS availability or None
"properties": { ... } # HeatCoolSystemProperties as a dict
}
classmethod from_dict_abridged(data, schedule_dict)

Create a HVAC object from an abridged dictionary.

Parameters:

  • data – A HeatCool abridged dictionary in following the format below.

  • schedule_dict – A dictionary with schedule identifiers as keys and honeybee schedule objects as values (either ScheduleRuleset or ScheduleFixedInterval). These will be used to assign the schedules to the Setpoint object.

{
"type": "",  # text for the class name of the HVAC
"identifier": "Classroom1_System",  # identifier for the HVAC
"display_name": "Standard System",  # name for the HVAC
"vintage": "ASHRAE_2019",  # text for the vintage of the template
"equipment_type": "",  # text for the HVAC equipment type
"unit_ventilators": True,  # boolean for unit ventilators
"sensible_heat_recovery": 0.75,  # sensible heat recovery effectiveness
"latent_heat_recovery": 0.7,  # latent heat recovery effectiveness
"vent_availability_schedule": ""  # Schedule id for ventilation availability
"properties": { ... } # dict of the HeatCoolSystemProperties
}
lock()
to_dict(abridged=False)

HeatCool system dictionary representation.

Parameters:

abridged – Boolean to note whether the full dictionary describing the object should be returned (False) or just an abridged version (True). This input currently has no effect but may eventually have one if schedule-type properties are exposed on this template.

to_ideal_air_equivalent()

Get a version of this HVAC as an IdealAirSystem.

unlock()
COOL_ONLY_TYPES = ('EvapCoolers', 'FCU_Chiller', 'FCU_ACChiller', 'FCU_DCW', 'ResidentialAC', 'WindowAC')
EQUIPMENT_TYPES = ('EvapCoolers_ElectricBaseboard', 'EvapCoolers_BoilerBaseboard', 'EvapCoolers_ASHPBaseboard', 'EvapCoolers_DHWBaseboard', 'EvapCoolers_Furnace', 'EvapCoolers_UnitHeaters', 'EvapCoolers')
HEAT_ONLY_TYPES = ('ElectricBaseboard', 'BoilerBaseboard', 'ASHPBaseboard', 'DHWBaseboard', 'GasHeaters', 'ResidentialHPNoCool', 'ResidentialFurnace')
VINTAGES = ('DOE_Ref_Pre_1980', 'DOE_Ref_1980_2004', 'ASHRAE_2004', 'ASHRAE_2007', 'ASHRAE_2010', 'ASHRAE_2013', 'ASHRAE_2016', 'ASHRAE_2019')
property balances_exhaust

Always False for HeatCool systems.

property display_name

Get or set a string for the object name without any character restrictions.

If not set, this will be equal to the identifier.

property equipment_type

Get or set text for the system’s equipment specification.

For example, ‘VAV chiller with gas boiler reheat’.

property has_air_loop

Always False for HeatCool systems.

property has_district_cooling

Get a boolean for whether the HVAC system has district cooling.

property has_district_heating

Get a boolean for whether the HVAC system has district heating.

property identifier

Get or set the text string for HVAC system identifier.

property latent_heat_recovery

Get or set a number for the effectiveness of latent heat recovery.

property properties

Get properties for extensions.

property schedules

Get an array of all the schedules associated with the HVAC system.

property sensible_heat_recovery

Get or set a number for the effectiveness of sensible heat recovery.

property unit_ventilators

Get or set a boolean for whether the system includes unit ventilators.

property user_data

Get or set an optional dictionary for additional meta data for this object.

This will be None until it has been set. All keys and values of this dictionary should be of a standard Python type to ensure correct serialization of the object to/from JSON (eg. str, float, int, list, dict)

property vent_availability_schedule

Get or set am on/off schedule for availability of the ventilators.

property vintage

Get or set text to indicate the vintage of the template system.

Choose from the following options:

  • DOE_Ref_Pre_1980

  • DOE_Ref_1980_2004

  • ASHRAE_2004

  • ASHRAE_2007

  • ASHRAE_2010

  • ASHRAE_2013

  • ASHRAE_2016

  • ASHRAE_2019