honeybee_energy.material.frame module

Window frame materials.

The materials here can only be applied as frames to window constructions.

class honeybee_energy.material.frame.EnergyWindowFrame(identifier, width, conductance, edge_to_center_ratio=1, outside_projection=0, inside_projection=0, thermal_absorptance=0.9, solar_absorptance=0.7, visible_absorptance=None)[source]

Bases: _EnergyMaterialBase

A window frame assigned to a Window Construction.

Parameters:

  • identifier – Text string for a unique Material ID. 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.

  • width – Number for the width of frame in plane of window [m]. The frame width is assumed to be the same on all sides of window.

  • conductance –

    Number for the thermal conductance of the frame material measured from inside to outside of the frame surface (no air films) and taking 2D conduction effects into account [W/m2-K]. Values for typical frame materials are as follows.

    • Aluminum with Thermal Break - 56.4 W/m2-K

    • Aluminum One-Sided (Flush) - 10.7 W/m2-K

    • Wood - 3.5 W/m2-K

    • Vinyl - 2.3 W/m2-K

  • edge_to_center_ratio – Number between 0 and 4 for the ratio of the glass conductance near the frame (excluding air films) divided by the glass conductance at the center of the glazing (excluding air films). This is used only for multi-pane glazing constructions. This ratio should usually be greater than 1.0 since the spacer material that separates the glass panes is usually more conductive than the gap between panes. A value of 1 effectively indicates no spacer. Values should usually be obtained from the LBNL WINDOW program so that the unique characteristics of the window construction can be accounted for. (Default: 1).

  • outside_projection – Number for the distance that the frame projects outward from the outside face of the glazing [m]. This is used to calculate shadowing of frame onto glass, solar absorbed by the frame, IR emitted and absorbed by the frame, and convection from frame. (Default: 0).

  • inside_projection – Number for the distance that the frame projects inward from the inside face of the glazing [m]. This is used to calculate solar absorbed by the frame, IR emitted and absorbed by the frame, and convection from frame. (Default: 0).

  • thermal_absorptance – A number between 0 and 1 for the fraction of incident long wavelength radiation that is absorbed by the material. (Default: 0.9).

  • solar_absorptance – A number between 0 and 1 for the fraction of incident solar radiation absorbed by the material. (Default: 0.7).

  • visible_absorptance – A number between 0 and 1 for the fraction of incident visible wavelength radiation absorbed by the material. Default is None, which will yield the same value as solar_absorptance.

Properties:

  • identifier

  • display_name

  • width

  • conductance

  • edge_to_center_ratio

  • outside_projection

  • inside_projection

  • thermal_absorptance

  • solar_absorptance

  • visible_absorptance

  • solar_reflectance

  • visible_reflectance

  • u_value

  • r_value

  • user_data

  • properties

ToString()

Overwrite .NET ToString.

duplicate()

Get a copy of this construction.

classmethod from_dict(data)[source]

Create a EnergyWindowFrame from a dictionary.

Parameters:

data – A python dictionary in the following format

{
"type": 'EnergyWindowFrame',
"identifier": 'Wood_Frame_050_032',
"display_name": 'Pine Wooden Frame',
"width": 0.05,
"conductance": 3.2,
"edge_to_center_ratio": 2.6,
"outside_projection": 0.05,
"inside_projection": 0.1,
"thermal_absorptance": 0.9,
"solar_absorptance": 0.7,
"visible_absorptance": 0.7
}
classmethod from_idf(idf_string)[source]

Create an EnergyWindowFrame from an EnergyPlus text string.

Parameters:

idf_string – A text string fully describing an EnergyPlus material.

lock()
to_dict()[source]

EnergyWindowFrame dictionary representation.

to_idf()[source]

Get an EnergyPlus string representation of the window frame.

WindowProperty:FrameAndDivider,
    TestFrameAndDivider, ! Frame/Divider Name
    0.05, ! Frame Width
    0.04, ! Frame Outside Projection
    0.03, ! Frame Inside Projection
    5.0,  ! Frame Conductance
    1.3,  ! Ratio of Frame-Edge Glass Conductance to Center-Of-Glass Conductance
    0.8,  ! Frame Solar Absorptance
    0.8,  ! Frame Visible Absorptance
unlock()
property conductance

Get or set the conductance of the frame material [W/m2-K].

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 edge_to_center_ratio

Get or set the ratio between the edge and center glass conductances.

property identifier

Get or set the text string for material identifier.

property inside_projection

Get or set the distance the frame projects from the inside [m].

property outside_projection

Get or set the distance the frame projects from the outside [m].

property properties

Get properties for extensions.

property r_value

Get or set the R-value of the frame material in [m2-K/W] (excluding films).

property solar_absorptance

Get or set the solar absorptance of the frame material.

property solar_reflectance

Get or set the front solar reflectance of the frame material.

property thermal_absorptance

Get or set the thermal absorptance of the frame material.

property u_value

Get or set the U-value of the frame material [W/m2-K] (excluding films).

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 visible_absorptance

Get or set the visible absorptance of the frame material.

property visible_reflectance

Get or set the front visible reflectance of the frame material.

property width

Get or set the width of frame in plane of window [m].