honeybee_energy.properties.door module

Door Energy Properties.

class honeybee_energy.properties.door.DoorEnergyProperties(host, construction=None, vent_opening=None)

Bases: object

Energy Properties for Honeybee Door.

Parameters:

• host_door – A honeybee_core Door object that hosts these properties.

• construction – An optional Honeybee OpaqueConstruction or WindowConstruction object for the door. Note that the host Door must have the is_glass property set to True to assign a WindowConstruction, WindowConstructionShade or WindowConstructionDynamic. If None, it will be set by the parent Room ConstructionSet or the the Honeybee default generic ConstructionSet.

• vent_opening – An optional VentilationOpening to specify the operable portion of the Door. (Default: None).

Properties:

• host

• construction

• vent_opening

• is_construction_set_on_object

ToString()

apply_properties_from_dict(abridged_data, constructions)

Apply properties from a DoorEnergyPropertiesAbridged dictionary.

Parameters:

• abridged_data – A DoorEnergyPropertiesAbridged dictionary (typically coming from a Model).

• constructions – A dictionary of constructions with constructions identifiers as keys, which will be used to re-assign constructions.

duplicate(new_host=None)

Get a copy of this object.

Parameters:

new_host – A new Door object that hosts these properties. If None, the properties will be duplicated with the same host.

classmethod from_dict(data, host)

Create DoorEnergyProperties from a dictionary.

Note that the dictionary must be a non-abridged version for this classmethod to work.

Parameters:

• data – A dictionary representation of DoorEnergyProperties in the format below.

• host – A Door object that hosts these properties.

{
"type": 'DoorEnergyProperties',
"construction": {},  # OpaqueConstruction or WindowConstruction dict
"vent_opening": {}  # VentilationOpening dict
}

is_equivalent(other)

Check to see if these energy properties are equivalent to another object.

This will only be True if all properties match (except for the host) and will otherwise be False.

r_factor(units='Meters')

Get the Door R-factor [m2-K/W] (including air film resistance).

The air film resistances are computed using the orientation and height of the Door geometry.

Parameters:

units – Text for the units in which the Door geometry exists. These will be used to correctly interpret the dimensions of the geometry for heat flow calculation. (Default: Meters).

reset_construction_to_set()

Reset a construction assigned at the level of this Door to the default.

This means that the Door’s construction will be assigned by a ConstructionSet.

shgc(units='Meters')

Get the Door solar heat gain coefficient (SHGC).

If this construction is not a simple glazing system, this value is computed by summing the transmitted and conducted portions of solar irradiance under the NFRC summer conditions. The air film resistances are computed using the orientation and height of the Door geometry. If the window construction has a frame, the geometry of the frame will also be accounted for.

Parameters:

units – Text for the units in which the Door geometry exists. These will be used to correctly interpret the dimensions of the geometry for heat flow calculation. (Default: Meters).

to_dict(abridged=False)

Return energy properties as a dictionary.

Parameters:

abridged – Boolean to note whether the full dictionary describing the object should be returned (False) or just an abridged version (True). Default: False.

u_factor(units='Meters')

Get the Door U-factor [W/m2-K] (including resistances for air films).

The air film resistances are computed using the orientation and height of the Door geometry.

Parameters:

units – Text for the units in which the Door geometry exists. These will be used to correctly interpret the dimensions of the geometry for heat flow calculation. (Default: Meters).

property construction

Get or set Door Construction.

If the Construction is not set on the door-level, then it will be assigned based on the ConstructionSet assigned to the parent Room. If there is no parent Room or the parent Room’s ConstructionSet has no construction for this type of door, it will be assigned using the honeybee default generic construction set.

property host

Get the Door object hosting these properties.

property is_construction_set_on_object

Boolean noting if construction is assigned on the level of this Door.

This is opposed to having the construction assigned by a ConstructionSet.

property vent_opening

Get or set a VentilationOpening object to specify the operable portion.