honeybee-schema 1.59.1__py3-none-any.whl

honeybee_schema/energy/hvac/allair.py

@@ -0,0 +1,257 @@
+"""All-air HVAC systems, providing ventilation and meeting thermal demand with air."""
+from pydantic import Field, constr
+from enum import Enum
+
+from ._template import _TemplateSystem
+
+
+class AllAirEconomizerType(str, Enum):
+    no_economizer = 'NoEconomizer'
+    differential_dry_bulb = 'DifferentialDryBulb'
+    differential_enthalpy = 'DifferentialEnthalpy'
+    differential_dry_bulb_and_enthalpy = 'DifferentialDryBulbAndEnthalpy'
+    fixed_dry_bulb = 'FixedDryBulb'
+    fixed_enthalpy = 'FixedEnthalpy'
+    electronic_enthalpy = 'ElectronicEnthalpy'
+
+
+class _AllAirBase(_TemplateSystem):
+    """Base class for all-air systems.
+
+    All-air systems provide both ventilation and heating + cooling demand with
+    the same stream of warm/cool air. As such, they often grant tight control
+    over zone humidity. However, because such systems often involve the
+    cooling of air only to reheat it again, they are often more energy intensive
+    than systems that separate ventilation from the meeting of thermal loads.
+    """
+
+    economizer_type: AllAirEconomizerType = Field(
+        AllAirEconomizerType.no_economizer,
+        description='Text to indicate the type of air-side economizer used on '
+        'the system (from the AllAirEconomizerType enumeration).'
+    )
+
+    sensible_heat_recovery: float = Field(
+        0,
+        ge=0,
+        le=1,
+        description='A number between 0 and 1 for the effectiveness of sensible '
+        'heat recovery within the system.'
+    )
+
+    latent_heat_recovery: float = Field(
+        0,
+        ge=0,
+        le=1,
+        description='A number between 0 and 1 for the effectiveness of latent '
+        'heat recovery within the system.'
+    )
+
+    demand_controlled_ventilation: bool = Field(
+        False,
+        description='Boolean to note whether demand controlled ventilation should be '
+        'used on the system, which will vary the amount of ventilation air according '
+        'to the occupancy schedule of the Rooms.'
+    )
+
+
+class VAVEquipmentType(str, Enum):
+    vav_chill_gbr = 'VAV_Chiller_Boiler'
+    vav_chill_ashp = 'VAV_Chiller_ASHP'
+    vav_chill_dhw = 'VAV_Chiller_DHW'
+    vav_chill_pfp = 'VAV_Chiller_PFP'
+    vav_chill_gcr = 'VAV_Chiller_GasCoil'
+    vav_ac_chill_gbr = 'VAV_ACChiller_Boiler'
+    vav_ac_chill_ashp = 'VAV_ACChiller_ASHP'
+    vav_ac_chill_dhw = 'VAV_ACChiller_DHW'
+    vav_ac_chill_pfp = 'VAV_ACChiller_PFP'
+    vav_ac_chill_gcr = 'VAV_ACChiller_GasCoil'
+    vav_dcw_gbr = 'VAV_DCW_Boiler'
+    vav_dcw_ashp = 'VAV_DCW_ASHP'
+    vav_dcw_dhw = 'VAV_DCW_DHW'
+    vav_dcw_pfp = 'VAV_DCW_PFP'
+    vav_dcw_gcr = 'VAV_DCW_GasCoil'
+
+
+class PVAVEquipmentType(str, Enum):
+    pvav_gbr = 'PVAV_Boiler'
+    pvav_ashp = 'PVAV_ASHP'
+    pvav_dhw = 'PVAV_DHW'
+    pvav_pfp = 'PVAV_PFP'
+    pvav_ger = 'PVAV_BoilerElectricReheat'
+
+
+class PSZEquipmentType(str, Enum):
+    psz_e_base = 'PSZAC_ElectricBaseboard'
+    psz_gb_base = 'PSZAC_BoilerBaseboard'
+    psz_dhw_base = 'PSZAC_DHWBaseboard'
+    psz_guh = 'PSZAC_GasHeaters'
+    psz_ec = 'PSZAC_ElectricCoil'
+    psz_gc = 'PSZAC_GasCoil'
+    psz_gb = 'PSZAC_Boiler'
+    psz_ashp = 'PSZAC_ASHP'
+    psz_dhw = 'PSZAC_DHW'
+    psz_ac = 'PSZAC'
+    psz_dcw_e_base = 'PSZAC_DCW_ElectricBaseboard'
+    psz_dcw_gb_base = 'PSZAC_DCW_BoilerBaseboard'
+    psz_dcw_guh = 'PSZAC_DCW_GasHeaters'
+    psz_dcw_ec = 'PSZAC_DCW_ElectricCoil'
+    psz_dcw_gc = 'PSZAC_DCW_GasCoil'
+    psz_dcw_gb = 'PSZAC_DCW_Boiler'
+    psz_dcw_ashp = 'PSZAC_DCW_ASHP'
+    psz_dcw_dhw = 'PSZAC_DCW_DHW'
+    psz_dcw_ac = 'PSZAC_DCW'
+    psz_hp = 'PSZHP'
+
+
+class PTACEquipmentType(str, Enum):
+    ptac_e_base = 'PTAC_ElectricBaseboard'
+    ptac_gb_base = 'PTAC_BoilerBaseboard'
+    ptac_dhw_base = 'PTAC_DHWBaseboard'
+    ptac_guh = 'PTAC_GasHeaters'
+    ptac_ec = 'PTAC_ElectricCoil'
+    ptac_gc = 'PTAC_GasCoil'
+    ptac_gb = 'PTAC_Boiler'
+    ptac_ashp = 'PTAC_ASHP'
+    ptac_dhw = 'PTAC_DHW'
+    ptac = 'PTAC'
+    pthp = 'PTHP'
+
+
+class FurnaceEquipmentType(str, Enum):
+    furnace = 'Furnace'
+    furnace_electric = 'Furnace_Electric'
+
+
+class VAV(_AllAirBase):
+    """Variable Air Volume (VAV) HVAC system (aka. System 7 or 8).
+
+    All rooms/zones are connected to a central air loop that is kept at a constant
+    central temperature of 12.8C (55F). The central temperature is maintained by a
+    cooling coil, which runs whenever the combination of return air and fresh outdoor
+    air is greater than 12.8C, as well as a heating coil, which runs whenever
+    the combination of return air and fresh outdoor air is less than 12.8C.
+
+    Each air terminal for the connected rooms/zones contains its own reheat coil,
+    which runs whenever the room is not in need of the cooling supplied by the 12.8C
+    central air.
+
+    The central cooling coil is always a chilled water coil, which is connected to a
+    chilled water loop operating at 6.7C (44F). All heating coils are hot water coils
+    except when Gas Coil equipment_type is used (in which case coils are gas)
+    or when Parallel Fan-Powered (PFP) boxes equipment_type is used (in which case
+    coils are electric resistance). Hot water temperature is 82C (180F) for
+    boiler/district heating and 49C (120F) when ASHP is used.
+
+    VAV systems are the traditional baseline system for commercial buildings
+    taller than 5 stories or larger than 14,000 m2 (150,000 ft2) of floor area.
+    """
+
+    type: constr(regex='^VAV$') = 'VAV'
+
+    equipment_type: VAVEquipmentType = Field(
+        VAVEquipmentType.vav_chill_gbr,
+        description='Text for the specific type of system equipment from the '
+        'VAVEquipmentType enumeration.'
+    )
+
+
+class PVAV(_AllAirBase):
+    """Packaged Variable Air Volume (PVAV) HVAC system (aka. System 5 or 6).
+
+    All rooms/zones are connected to a central air loop that is kept at a constant
+    central temperature of 12.8C (55F). The central temperature is maintained by a
+    cooling coil, which runs whenever the combination of return air and fresh outdoor
+    air is greater than 12.8C, as well as a heating coil, which runs whenever
+    the combination of return air and fresh outdoor air is less than 12.8C.
+
+    Each air terminal for the connected rooms/zones contains its own reheat coil,
+    which runs whenever the room is not in need of the cooling supplied by the 12.8C
+    central air.
+
+    The central cooling coil is always a two-speed direct expansion (DX) coil.
+    All heating coils are hot water coils except when Gas Coil equipment_type is
+    used (in which case the central coil is gas and all reheat is electric)
+    or when Parallel Fan-Powered (PFP) boxes equipment_type is used (in which case
+    coils are electric resistance). Hot water temperature is 82C (180F) for
+    boiler/district heating and 49C (120F) when ASHP is used.
+
+    PVAV systems are the traditional baseline system for commercial buildings
+    with than 4-5 stories or between 2,300 m2 and 14,000 m2 (25,000 ft2 and
+    150,000 ft2) of floor area.
+    """
+
+    type: constr(regex='^PVAV$') = 'PVAV'
+
+    equipment_type: PVAVEquipmentType = Field(
+        PVAVEquipmentType.pvav_gbr,
+        description='Text for the specific type of system equipment from the '
+        'VAVEquipmentType enumeration.'
+    )
+
+
+class PSZ(_AllAirBase):
+    """Packaged Single-Zone (PSZ) HVAC system (aka. System 3 or 4).
+
+    Each room/zone receives its own air loop with its own single-speed direct expansion
+    (DX) cooling coil, which will condition the supply air to a value in between
+    12.8C (55F) and 50C (122F) depending on the heating/cooling needs of the room/zone.
+    As long as a Baseboard equipment_type is NOT selected, heating will be supplied
+    by a heating coil in the air loop. Otherwise, heating is accomplished with
+    baseboards and the air loop only supplies cooling and ventilation air.
+    Fans are constant volume.
+
+    PSZ systems are the traditional baseline system for commercial buildings
+    with less than 4 stories or less than 2,300 m2 (25,000 ft2) of floor area.
+    They are also the default for all retail with less than 3 stories and all public
+    assembly spaces.
+    """
+
+    type: constr(regex='^PSZ$') = 'PSZ'
+
+    equipment_type: PSZEquipmentType = Field(
+        PSZEquipmentType.psz_e_base,
+        description='Text for the specific type of system equipment from the '
+        'PVAVEquipmentType enumeration.'
+    )
+
+
+class PTAC(_TemplateSystem):
+    """Packaged Terminal Air Conditioning (PTAC/HP) HVAC system. (aka. System 1 or 2).
+
+    Each room/zone receives its own packaged unit that supplies heating, cooling
+    and ventilation. Cooling is always done via a single-speed direct expansion (DX)
+    cooling coil. Heating can be done via a heating coil in the unit or via an
+    external baseboard. Fans are constant volume.
+
+    PTAC/HP systems are the traditional baseline system for residential buildings.
+    """
+
+    type: constr(regex='^PTAC$') = 'PTAC'
+
+    equipment_type: PTACEquipmentType = Field(
+        PTACEquipmentType.ptac_e_base,
+        description='Text for the specific type of system equipment from the '
+        'PTACEquipmentType enumeration.'
+    )
+
+
+class ForcedAirFurnace(_TemplateSystem):
+    """Forced Air Furnace HVAC system (aka. System 9 or 10).
+
+    Forced air furnaces are intended only for spaces only requiring heating and
+    ventilation. Each room/zone receives its own air loop with its own gas heating
+    coil, which will supply air at a temperature up to 50C (122F) to meet the
+    heating needs of the room/zone. Fans are constant volume.
+
+    ForcedAirFurnace systems are the traditional baseline system for storage
+    spaces that only require heating.
+    """
+
+    type: constr(regex='^ForcedAirFurnace$') = 'ForcedAirFurnace'
+
+    equipment_type: FurnaceEquipmentType = Field(
+        FurnaceEquipmentType.furnace,
+        description='Text for the specific type of system equipment from the '
+        'FurnaceEquipmentType enumeration.'
+    )

honeybee_schema/energy/hvac/detailed.py

@@ -0,0 +1,20 @@
+"""Detailed HVAC system schema defined using Ironbug."""
+from pydantic import Field, constr
+from .._base import IDdEnergyBaseModel
+
+
+class DetailedHVAC(IDdEnergyBaseModel):
+    """Detailed HVAC system object defined using IronBug or OpenStudio .NET bindings."""
+
+    type: constr(regex='^DetailedHVAC$') = 'DetailedHVAC'
+
+    specification: dict = Field(
+        ...,
+        description='A JSON-serializable dictionary representing the full '
+        'specification of the detailed system. This can be obtained by calling '
+        'the ToJson() method on any IronBug HVAC system and then serializing '
+        'the resulting JSON string into a Python dictionary using the native '
+        'Python json package. Note that the Rooms that the HVAC is assigned to '
+        'must be specified as ThermalZones under this specification in order '
+        'for the resulting Model this HVAC is a part of to be valid.'
+    )

honeybee_schema/energy/hvac/doas.py

@@ -0,0 +1,248 @@
+"""HVAC systems with DOAS, separating ventilation and meeting thermal demand."""
+from pydantic import Field, constr
+from enum import Enum
+
+from ._template import _TemplateSystem, RadiantFaceTypes
+
+
+class _DOASBase(_TemplateSystem):
+    """Base class for Dedicated Outdoor Air System (DOAS) HVACs.
+
+    DOAS systems separate minimum ventilation supply from the satisfaction of heating
+    + cooling demand. Ventilation air tends to be supplied at neutral temperatures
+    (close to room air temperature) and heating / cooling loads are met with additional
+    pieces of zone equipment (eg. Fan Coil Units (FCUs)).
+
+    Because DOAS systems only have to cool down and re-heat the minimum ventilation air,
+    they tend to use less energy than all-air systems. They also tend to use less energy
+    to distribute heating + cooling by pumping around hot/cold water or refrigerant
+    instead of blowing hot/cold air. However, they do not provide as good of control
+    over humidity and so they may not be appropriate for rooms with high latent loads
+    like auditoriums, kitchens, laundromats, etc.
+    """
+
+    sensible_heat_recovery: float = Field(
+        0,
+        ge=0,
+        le=1,
+        description='A number between 0 and 1 for the effectiveness of sensible '
+        'heat recovery within the system.'
+    )
+
+    latent_heat_recovery: float = Field(
+        0,
+        ge=0,
+        le=1,
+        description='A number between 0 and 1 for the effectiveness of latent '
+        'heat recovery within the system.'
+    )
+
+    demand_controlled_ventilation: bool = Field(
+        False,
+        description='Boolean to note whether demand controlled ventilation should be '
+        'used on the system, which will vary the amount of ventilation air according '
+        'to the occupancy schedule of the Rooms.'
+    )
+
+    doas_availability_schedule: str = Field(
+        None,
+        min_length=1,
+        max_length=100,
+        description='An optional On/Off discrete schedule to set when the dedicated '
+        'outdoor air system (DOAS) shuts off. This will not only prevent any outdoor '
+        'air from flowing thorough the system but will also shut off the fans, which '
+        'can result in more energy savings when spaces served by the DOAS are '
+        'completely unoccupied. If None, the DOAS will be always on.'
+    )
+
+
+class FCUwithDOASEquipmentType(str, Enum):
+    fcu_chill_gb = 'DOAS_FCU_Chiller_Boiler'
+    fcu_chill_ashp = 'DOAS_FCU_Chiller_ASHP'
+    fcu_chill_dhw = 'DOAS_FCU_Chiller_DHW'
+    fcu_chill_base = 'DOAS_FCU_Chiller_ElectricBaseboard'
+    fcu_chill_guh = 'DOAS_FCU_Chiller_GasHeaters'
+    fcu_chill = 'DOAS_FCU_Chiller'
+    fcu_ac_chill_gb = 'DOAS_FCU_ACChiller_Boiler'
+    fcu_ac_chill_ashp = 'DOAS_FCU_ACChiller_ASHP'
+    fcu_ac_chill_dhw = 'DOAS_FCU_ACChiller_DHW'
+    fcu_ac_chill_base = 'DOAS_FCU_ACChiller_ElectricBaseboard'
+    fcu_ac_chill_guh = 'DOAS_FCU_ACChiller_GasHeaters'
+    fcu_ac_chill = 'DOAS_FCU_ACChiller'
+    fcu_dcw_gb = 'DOAS_FCU_DCW_Boiler'
+    fcu_dcw_ashp = 'DOAS_FCU_DCW_ASHP'
+    fcu_dcw_dhw = 'DOAS_FCU_DCW_DHW'
+    fcu_dcw_base = 'DOAS_FCU_DCW_ElectricBaseboard'
+    fcu_dcw_guh = 'DOAS_FCU_DCW_GasHeaters'
+    fcu_dcw = 'DOAS_FCU_DCW'
+
+
+class WSHPwithDOASEquipmentType(str, Enum):
+    wshp_fc_gb = 'DOAS_WSHP_FluidCooler_Boiler'
+    wshp_ct_gb = 'DOAS_WSHP_CoolingTower_Boiler'
+    wshp_gshp = 'DOAS_WSHP_GSHP'
+    wshp_dcw_dhw = 'DOAS_WSHP_DCW_DHW'
+
+
+class VRFwithDOASEquipmentType(str, Enum):
+    vrf = 'DOAS_VRF'
+
+
+class RadiantwithDOASEquipmentType(str, Enum):
+    radiant_chill_gb = 'DOAS_Radiant_Chiller_Boiler'
+    radiant_chill_ashp = 'DOAS_Radiant_Chiller_ASHP'
+    radiant_chill_dhw = 'DOAS_Radiant_Chiller_DHW'
+    radiant_ac_chill_gb = 'DOAS_Radiant_ACChiller_Boiler'
+    radiant_ac_chill_ashp = 'DOAS_Radiant_ACChiller_ASHP'
+    radiant_ac_chill_dhw = 'DOAS_Radiant_ACChiller_DHW'
+    radiant_dcw_gb = 'DOAS_Radiant_DCW_Boiler'
+    radiant_dcw_ashp = 'DOAS_Radiant_DCW_ASHP'
+    radiant_dcw_dhw = 'DOAS_Radiant_DCW_DHW'
+
+
+class FCUwithDOASAbridged(_DOASBase):
+    """Fan Coil Unit (FCU) with DOAS HVAC system.
+
+    All rooms/zones in the system are connected to a Dedicated Outdoor Air System
+    (DOAS) that supplies a constant volume of ventilation air at the same temperature
+    to all rooms/zones. The ventilation air temperature will vary from 21.1C (70F)
+    to 15.5C (60F) depending on the outdoor air temperature (the DOAS supplies cooler air
+    when outdoor conditions are warmer). The ventilation air temperature is maintained
+    by a chilled water cooling coil and a heating coil. The heating coil is a hot
+    water coil except when electric baseboards or gas heaters are specified, in
+    which case the heating coil is a single-speed direct expansion (DX) heat pump
+    with a backup electrical resistance coil.
+
+    Each room/zone also receives its own Fan Coil Unit (FCU), which meets the heating
+    and cooling loads of the space. The cooling coil in the FCU is always chilled
+    water cooling coil, which is connected to a chilled water loop operating
+    at 6.7C (44F). The heating coil is a hot water coil except when when electric
+    baseboards or gas heaters are specified. Hot water temperature is 82C (180F) for
+    boiler/district heating and 49C (120F) when ASHP is used.
+
+    The FCU with DOAS template is relatively close in performance to active chilled
+    beams (ACBs). When using this template to represent ACBs, care must be taken
+    to ensure that the DOAS ventilation air requirement is sufficient to extract
+    the heating cooling from the ACB. If so, then this FCUwithDOAS template can be
+    used but with the energy use of the FCU fans ignored.
+    """
+
+    type: constr(regex='^FCUwithDOASAbridged$') = 'FCUwithDOASAbridged'
+
+    equipment_type: FCUwithDOASEquipmentType = Field(
+        FCUwithDOASEquipmentType.fcu_chill_gb,
+        description='Text for the specific type of system equipment from the '
+        'FCUwithDOASEquipmentType enumeration.'
+    )
+
+
+class WSHPwithDOASAbridged(_DOASBase):
+    """Water Source Heat Pump (WSHP) with DOAS HVAC system.
+
+    All rooms/zones in the system are connected to a Dedicated Outdoor Air System
+    (DOAS) that supplies a constant volume of ventilation air at the same temperature
+    to all rooms/zones. The ventilation air temperature will vary from 21.1C (70F)
+    to 15.5C (60F) depending on the outdoor air temperature (the DOAS supplies cooler air
+    when outdoor conditions are warmer). The ventilation air temperature is maintained
+    by a chilled water cooling coil and a hot water heating coil except when the
+    ground source heat pump (GSHP) option is selected. In this case, the ventilation
+    air temperature is maintained by a two-speed direct expansion (DX) cooling coil
+    and a single-speed DX heating coil with backup electrical resistance heat.
+
+    Each room/zone also receives its own Water Source Heat Pump (WSHP), which meets
+    the heating and cooling loads of the space. All WSHPs are connected to the
+    same water condenser loop, which has its temperature maintained by the
+    equipment_type (eg. Boiler with Cooling Tower).
+    """
+
+    type: constr(regex='^WSHPwithDOASAbridged$') = 'WSHPwithDOASAbridged'
+
+    equipment_type: WSHPwithDOASEquipmentType = Field(
+        WSHPwithDOASEquipmentType.wshp_fc_gb,
+        description='Text for the specific type of system equipment from the '
+        'WSHPwithDOASEquipmentType enumeration.'
+    )
+
+
+class VRFwithDOASAbridged(_DOASBase):
+    """Variable Refrigerant Flow (VRF) with DOAS HVAC system.
+
+    All rooms/zones in the system are connected to a Dedicated Outdoor Air System
+    (DOAS) that supplies a constant volume of ventilation air at the same temperature
+    to all rooms/zones. The ventilation air temperature will vary from 21.1C (70F)
+    to 15.5C (60F) depending on the outdoor air temperature (the DOAS supplies cooler air
+    when outdoor conditions are warmer). The ventilation air temperature is maintained
+    by a single speed direct expansion (DX) cooling coil along with a single-speed
+    direct expansion (DX) heat pump with a backup electrical resistance coil.
+
+    Each room/zone also receives its own Variable Refrigerant Flow (VRF) terminal,
+    which meets the heating and cooling loads of the space. All room/zone terminals
+    are connected to the same outdoor unit, meaning that either all rooms must be
+    in cooling or heating mode together.
+    """
+
+    type: constr(regex='^VRFwithDOASAbridged$') = 'VRFwithDOASAbridged'
+
+    equipment_type: VRFwithDOASEquipmentType = Field(
+        VRFwithDOASEquipmentType.vrf,
+        description='Text for the specific type of system equipment from the '
+        'VRFwithDOASEquipmentType enumeration.'
+    )
+
+
+class RadiantwithDOASAbridged(_DOASBase):
+    """Low Temperature Radiant with DOAS HVAC system.
+
+    This HVAC template will change the floor and/or ceiling constructions
+    of the Rooms that it is applied to, replacing them with a construction that
+    aligns with the radiant_type property (eg. CeilingMetalPanel).
+
+    All rooms/zones in the system are connected to a Dedicated Outdoor Air System
+    (DOAS) that supplies a constant volume of ventilation air at the same temperature
+    to all rooms/zones. The ventilation air temperature will vary from 21.1C (70F)
+    to 15.5C (60F) depending on the outdoor air temperature (the DOAS supplies cooler air
+    when outdoor conditions are warmer). The ventilation air temperature is maintained
+    by a two-speed direct expansion (DX) cooling coil and a single-speed DX
+    heating coil with backup electrical resistance heat.
+
+    The heating and cooling needs of the space are met with the radiant constructions,
+    which use chilled water at 12.8C (55F) and a hot water temperature somewhere
+    between 32.2C (90F) and 49C (120F) (warmer temperatures are used in colder
+    climate zones).
+
+    Note that radiant systems are particularly limited in cooling capacity and
+    using them may result in many unmet hours. To reduce unmet hours, one can
+    remove carpets, reduce internal loads, reduce solar and envelope gains during
+    peak times, add thermal mass, and use an expanded comfort range.
+    """
+
+    type: constr(regex='^RadiantwithDOASAbridged$') = 'RadiantwithDOASAbridged'
+
+    equipment_type: RadiantwithDOASEquipmentType = Field(
+        RadiantwithDOASEquipmentType.radiant_chill_gb,
+        description='Text for the specific type of system equipment from the '
+        'RadiantwithDOASEquipmentType enumeration.'
+    )
+
+    radiant_face_type: RadiantFaceTypes = Field(
+        RadiantFaceTypes.floor,
+        description='Text to indicate which faces are thermally active by default. '
+        'Note that this property has no effect when the rooms to which the HVAC '
+        'system is assigned have constructions with internal source materials. '
+        'In this case, those constructions will dictate the thermally active '
+        'surfaces.'
+    )
+
+    minimum_operation_time: float = Field(
+        1.0,
+        gt=0,
+        description='A number for the minimum number of hours of operation '
+        'for the radiant system before it shuts off.'
+    )
+
+    switch_over_time: float = Field(
+        24.0,
+        gt=0,
+        description='A number for the minimum number of hours for when the system '
+        'can switch between heating and cooling.'
+    )