honeybee_energy.properties.aperture module

Aperture Energy Properties.

class honeybee_energy.properties.aperture.ApertureEnergyProperties(host, construction=None, vent_opening=None)

Bases: object

Energy Properties for Honeybee Aperture.

Parameters:

• host – A honeybee_core Aperture object that hosts these properties.

• construction – An optional Honeybee WindowConstruction, WindowConstructionShade or WindowConstructionDynamic object for the aperture. 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 Aperture. (Default: None).

Properties:

• host

• construction

• vent_opening

• is_construction_set_on_object

ToString()

apply_properties_from_dict(abridged_data, constructions)

Apply properties from a ApertureEnergyPropertiesAbridged dictionary.

Parameters:

• abridged_data – A ApertureEnergyPropertiesAbridged 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.

new_host: A new Aperture object that hosts these properties.

If None, the properties will be duplicated with the same host.

classmethod from_dict(data, host)

Create ApertureEnergyProperties from a dictionary.

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

Parameters:

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

• host – A Aperture object that hosts these properties.

{
"type": 'ApertureEnergyProperties',
"construction": {},  # Window Construction dictionary
"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 Aperture R-factor [m2-K/W] (including resistances for air films).

The air film resistances are computed using the orientation and height of the Aperture 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 Aperture 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 Aperture to the default.

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

shgc(units='Meters')

Get the Aperture 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 Aperture 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 Aperture 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 Aperture U-factor [W/m2-K] (including resistances for air films).

The air film resistances are computed using the orientation and height of the Aperture 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 Aperture 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 Aperture Construction.

If the Construction is not set on the aperture-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 the aperture, it will be assigned using the honeybee default generic construction set.

property host

Get the Aperture object hosting these properties.

property is_construction_set_on_object

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

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.