honeybee_energy.material.glazing module

Glazing materials representing panes of glass within window constructions.

They can exist anywhere within a window construction as long as they are not adjacent to other glazing materials. The one exception to this is the EnergyWindowMaterialSimpleGlazSys, which is meant to represent an entire window assembly (including glazing, gaps, and frame), and therefore must be the only material in its parent construction.

class honeybee_energy.material.glazing.EnergyWindowMaterialGlazing(identifier, thickness=0.003, solar_transmittance=0.85, solar_reflectance=0.075, visible_transmittance=0.9, visible_reflectance=0.075, infrared_transmittance=0, emissivity=0.84, emissivity_back=0.84, conductivity=0.9)[source]

Bases: _EnergyWindowMaterialGlazingBase

A single glass pane corresponding to a layer in 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.

  • thickness – Number for the thickness of the glass layer [m]. Default: 0.003 meters (3 mm).

  • solar_transmittance – Number between 0 and 1 for the transmittance of solar radiation through the glass at normal incidence. Default: 0.85 for clear glass.

  • solar_reflectance – Number between 0 and 1 for the reflectance of solar radiation off of the front side of the glass at normal incidence, averaged over the solar spectrum. Default: 0.075.

  • visible_transmittance – Number between 0 and 1 for the transmittance of visible light through the glass at normal incidence. Default: 0.9 for clear glass.

  • visible_reflectance – Number between 0 and 1 for the reflectance of visible light off of the front side of the glass at normal incidence. Default: 0.075.

  • infrared_transmittance – Long-wave transmittance of the glass at normal incidence. Default: 0.

  • emissivity – Number between 0 and 1 for the infrared hemispherical emissivity of the front side of the glass. Default: 0.84, which is typical of clear glass.

  • emissivity_back – Number between 0 and 1 for the infrared hemispherical emissivity of the back side of the glass. Default: 0.84, which is typical of clear glass.

  • conductivity – Number for the thermal conductivity of the glass [W/m-K]. Default: 0.9.

Properties:

  • identifier

  • display_name

  • thickness

  • solar_transmittance

  • solar_reflectance

  • solar_reflectance_back

  • visible_transmittance

  • visible_reflectance

  • visible_reflectance_back

  • infrared_transmittance

  • emissivity

  • emissivity_back

  • conductivity

  • dirt_correction

  • solar_diffusing

  • resistivity

  • u_value

  • r_value

  • solar_absorptance

  • visible_absorptance

  • solar_transmissivity

  • visible_transmissivity

  • user_data

  • properties

ToString()

Overwrite .NET ToString.

duplicate()

Get a copy of this construction.

classmethod from_dict(data)[source]

Create a EnergyWindowMaterialGlazing from a dictionary.

Parameters:

data – A python dictionary in the following format

{
"type": 'EnergyWindowMaterialGlazing',
"identifier": 'Lowe_Glazing_00030_045_090',
"display_name": 'Low-e Glazing',
"thickness": 0.003,
"solar_transmittance": 0.45,
"solar_reflectance": 0.36,
"visible_transmittance": 0.714,
"visible_reflectance": 0.207,
"infrared_transmittance": 0,
"emissivity": 0.84,
"emissivity_back": 0.0466,
"conductivity": 0.9
}
classmethod from_idf(idf_string)[source]

Create EnergyWindowMaterialGlazing from an EnergyPlus text string.

Parameters:

idf_string – A text string fully describing an EnergyPlus material.

lock()
to_dict()[source]

Energy Window Material Glazing dictionary representation.

to_idf()[source]

Get an EnergyPlus string representation of the material.

WindowMaterial:Glazing,
    CLEAR 3MM,       !- Name
    SpectralAverage, !- Optical Data Type
    ,                !- Window Glass Spectral Data Set Name
    0.003,           !- Thickness {m}
    0.837,           !- Solar Transmittance at Normal Incidence
    0.075,           !- Front Side Solar Reflectance at Normal Incidence
    0.075,           !- Back Side Solar Reflectance at Normal Incidence
    0.898,           !- Visible Transmittance at Normal Incidence
    0.081,           !- Front Side Visible Reflectance at Normal Incidence
    0.081,           !- Back Side Visible Reflectance at Normal Incidence
    0.0,             !- Infrared Transmittance at Normal Incidence
    0.84,            !- Front Side Infrared Hemispherical Emissivity
    0.84,            !- Back Side Infrared Hemispherical Emissivity
    0.9,             !- Conductivity {W/m-K}
    0.54,            !- Dirt Correction Factor
    0.09;            !- Solar Diffusing
unlock()
property conductivity

Get or set the conductivity of the glazing layer [W/m-K].

property dirt_correction

Get or set the hemispherical emissivity of the back side of the glass.

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 emissivity

Get or set the hemispherical emissivity of the front side of the glass.

property emissivity_back

Get or set the hemispherical emissivity of the back side of the glass.

property identifier

Get or set the text string for material identifier.

property infrared_transmittance

Get or set the infrared transmittance of the glass at normal incidence.

property is_gas_material

Boolean to note whether the material is a gas gap layer.

property is_glazing_material

Boolean to note whether the material is a glazing layer.

property is_shade_material

Boolean to note whether the material is a shade layer.

property is_window_material

Boolean to note whether the material can be used for window surfaces.

property properties

Get properties for extensions.

property r_value

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

Note that, when setting the R-value, the thickness of the material will remain fixed and only the conductivity will be adjusted.

property resistivity

Get or set the resistivity of the glazing layer [m-K/W].

property solar_absorptance

Get the solar absorptance of the glass at normal incidence.

property solar_diffusing

Get or set the solar diffusing property of the glass.

property solar_reflectance

Get or set the front solar reflectance of the glass at normal incidence.

property solar_reflectance_back

Get or set the back solar reflectance of the glass at normal incidence.

property solar_transmissivity

Get the solar transmissivity of the glass at normal incidence.

property solar_transmittance

Get or set the solar transmittance of the glass at normal incidence.

property thickness

Get or set the thickness of the glass material layer [m].

property u_value

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

Note that, when setting the R-value, the thickness of the material will remain fixed and only the conductivity will be adjusted.

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 the visible absorptance of the glass at normal incidence.

property visible_reflectance

Get or set the front visible reflectance of the glass at normal incidence.

property visible_reflectance_back

Get or set the back visible reflectance of the glass at normal incidence.

property visible_transmissivity

Get the visible transmissivity of the glass at normal incidence.

property visible_transmittance

Get or set the visible transmittance of the glass at normal incidence.

class honeybee_energy.material.glazing.EnergyWindowMaterialSimpleGlazSys(identifier, u_factor, shgc, vt=0.6)[source]

Bases: _EnergyWindowMaterialGlazingBase

A material to describe an entire glazing system, including glass, gaps, and frame.

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.

  • u_factor – A number for the U-factor of the glazing system [W/m2-K] including standard air gap resistances on either side of the system.

  • shgc – A number between 0 and 1 for the solar heat gain coefficient of the glazing system. This includes both directly transmitted solar heat as well as solar heat that is absorbed by the glazing system and conducts towards the interior.

  • vt – A number between 0 and 1 for the visible transmittance of the glazing system. Default: 0.6.

Properties:

  • identifier

  • display_name

  • u_factor

  • shgc

  • vt

  • r_factor

  • u_value

  • r_value

  • solar_transmittance

  • solar_reflectance

  • solar_reflectance_back

  • solar_absorptance

  • visible_transmittance

  • visible_reflectance

  • visible_reflectance_back

  • visible_absorptance

  • thickness

  • user_data

  • properties

ToString()

Overwrite .NET ToString.

duplicate()

Get a copy of this construction.

classmethod from_dict(data)[source]

Create a EnergyWindowMaterialSimpleGlazSys from a dictionary.

Parameters:

data – A python dictionary in the following format

{
"type": 'EnergyWindowMaterialSimpleGlazSys',
"identifier": 'Double_Lowe_Glazing_200_040_060',
"display_name": 'Double Low-e Glazing System',
"u_factor": 2.0,
"shgc": 0.4,
"vt": 0.6
}
classmethod from_idf(idf_string)[source]

Create EnergyWindowMaterialSimpleGlazSys from an EnergyPlus text string.

Parameters:

idf_string – A text string fully describing an EnergyPlus material.

lock()
to_dict()[source]

Energy Window Material Simple Glazing System dictionary representation.

to_idf()[source]

Get an EnergyPlus string representation of the material.

WindowMaterial:SimpleGlazingSystem,
    SimpleWindow:DOUBLE PANE WINDOW , !- Name
    2.716 , !-  U-Factor
    0.763 , !-  Solar Heat Gain Coefficient
    0.812 ; !-  Visible Transmittance
unlock()
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 identifier

Get or set the text string for material identifier.

property is_gas_material

Boolean to note whether the material is a gas gap layer.

property is_glazing_material

Boolean to note whether the material is a glazing layer.

property is_shade_material

Boolean to note whether the material is a shade layer.

property is_window_material

Boolean to note whether the material can be used for window surfaces.

property properties

Get properties for extensions.

property r_factor

Get or set the glazing system R-factor (including air film resistance).

property r_value

R-value of the material layer [m2-K/W] (excluding air film resistance).

This is the R-value of glazing system as understood by EnergyPlus.

property shgc

Get or set the glazing system solar heat gain coefficient (SHGC).

property solar_absorptance

Get the solar absorptance of the glazing system at normal incidence.

This is the solar absorptance as understood by EnergyPlus.

property solar_reflectance

Get the solar reflectance of the glazing system at normal incidence.

property solar_reflectance_back

Get the solar reflectance of the glazing system at normal incidence.

property solar_transmittance

Get the solar transmittance of the glazing system at normal incidence.

property thickness

Get the thickess of the glazing system as interpreted by EnergyPlus [m].

property u_factor

Get or set the glazing system U-factor (including air film resistance).

property u_value

U-value of the material layer [W/m2-K] (excluding air film resistance).

This is the U-value of glazing system material layer as understood by EnergyPlus.

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 the visible absorptance of the glazing system at normal incidence.

This is the visible absorptance as understood by EnergyPlus.

property visible_reflectance

Get the visible reflectance of the glazing system at normal incidence.

This is the visible reflectance as understood by EnergyPlus.

property visible_reflectance_back

Get the visible reflectance of the glazing system at normal incidence.

property visible_transmittance

Get the visible transmittance of the glazing system at normal incidence.

property vt

Get or set the visible transmittance.