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()¶
- 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 thickess 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()¶
- 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.