1 of 26

1 :: Constructions

Search Constructions

- [source code]

Search for available Constructions within the honeybee energy standards library.

Inputs

keywords
Optional keywords to be used to narrow down the output list of constructions. If nothing is input here, all available constructions will be output.
join_words
If False or None, this component will automatically split any strings of multiple keywords (spearated by spaces) into separate keywords for searching. This results in a greater liklihood of finding an item in the search but it may not be appropropriate for all cases. You may want to set it to True when you are searching for a specific phrase that includes spaces. Default: False.

Outputs

opaque_constrs
A list of opaque constructions within the honeybee energy standards library (filtered by keywords_ if they are input).
window_constrs
A list of window constructions within the honeybee energy standards library (filtered by keywords_ if they are input).
shade_constrs
A list of shade constructions within the honeybee energy standards library (filtered by keywords_ if they are input).

Search Materials

- [source code]

Search for available Materials within the honeybee energy standards library.

Inputs

keywords
Optional keywords to be used to narrow down the output list of materials. If nothing is input here, all available materials will be output.
join_words
If False or None, this component will automatically split any strings of multiple keywords (spearated by spaces) into separate keywords for searching. This results in a greater liklihood of finding an item in the search but it may not be appropropriate for all cases. You may want to set it to True when you are searching for a specific phrase that includes spaces. Default: False.

Outputs

opaque_mats
A list of opaque materials within the honeybee energy standards library (filtered by keywords_ if they are input).
window_mats
A list of window materials within the honeybee energy standards library (filtered by keywords_ if they are input).

Deconstruct Construction

- [source code]

Deconstruct an opaque or window construction into its constituient materials.

Inputs

constr [Required]
An opaque or window construction to be deconstructed. This can also be text for an opaque or window construction to be looked up in the construction library.

Outputs

materials
List of material objects that make up the construction (ordered from outside to inside).
layers
List of material identifiers that make up the construction (ordered from outside to inside).
r_val_si
R-value of the construction in m2-K/W. Note that R-values do NOT include the resistance of air films on either side of the construction.
r_val_ip
R-value of the construction in h-ft2-F/Btu. Note that R-values do NOT include the resistance of air films on either side of the construction.
u_fac_si
U-factor of the construction in W/m2-K. Note that U-factors include the resistance of air films on either side of the construction.
u_fac_ip
U-factor of the construction in Btu/h-ft2-F. Note that U-factors include the resistance of air films on either side of the construction.
shgc
The estimated solar heat gain coefficient (SHGC) of the construction. This value is produced by finding the solution to the relationship between U-value, Solar Transmittance, and SHGC as defined for the simple glazing system material in EnergyPlus. More information can be found at https://bigladdersoftware.com/epx/docs/9-5/engineering-reference/ on this partticular sub-page of the engineering reference: window-calculation-module.html#step-4.-determine-layer-solar-transmittance
t_sol
The unshaded shortwave solar transmittance of the construction at normal incidence. Note that 'unshaded' in this case means that all blind + shade materials in the construction are ignored.
t_vis
The unshaded visible transmittance of the window at normal incidence. Note that 'unshaded' in this case means that all blind + shade materials in the construction are ignored.

Deconstruct ConstructionSet

- [source code]

Deconstruct a construction set into its constituient exterior constructions.

Inputs

constr_set [Required]
A construction set to be deconstructed. This can also be text for a construction set to be looked up in the construction set library.

Outputs

exterior_wall
A construction object for the set's exterior walls.
exterior_roof
A construction object for the set's exterior roofs.
exposed_floor
A construction object for the set's exposed floors.
ground_wall
A construction object for the set's underground walls.
ground_roof
A construction object for the set's underground roofs.
ground_floor
A construction object for the set's ground-contact floors.
window
A construction object for apertures with an Outdoors boundary condition and a Wall face type for their parent face.
skylight
A construction object for apertures with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.
operable
A construction object for apertures with an Outdoors boundary condition and True is_operable property.
exterior_door
A construction object for opaque doors with an Outdoors boundary condition and a Wall face type for their parent face.
overhead_door
A construction object for opaque doors with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.
glass_door
A construction object for all glass doors with an Outdoors boundary condition.

Deconstruct ConstructionSet Interior

Deconstruct a construction set into its constituient interior constructions.

Inputs

constr_set [Required]
A construction set to be deconstructed. This can also be text for a construction set to be looked up in the construction set library.

Outputs

interior_wall
A construction object for the set's interior walls.
ceiling
A construction object for the set's interior roofs.
interior_floor
A construction object for the set's interior floors.
interior_window
A construction object for all apertures with a Surface boundary condition.
interior_door
A construction object for all opaque doors with a Surface boundary condition.
int_glass_door
A construction object for all glass doors with a Surface boundary condition.

Deconstruct Material

- [source code]

Deconstruct a material into its constituient attributes and values.

Inputs

mat [Required]
A material to be deconstructed. This can also be text for a material to be looked up in the material library.

Outputs

values
List of values for the attributes that define the material.
attr_names
List of text that is the same length as the values, which notes the attribute name for each value.
r_val_si
R-value of the material in m2-K/W. Note that R-values do NOT include the resistance of air films on either side of the material.
r_val_ip
R-value of the material in h-ft2-F/Btu. Note that R-values do NOT include the resistance of air films on either side of the material.

Apply ConstructionSet

- [source code]

Apply ConstructionSet to Honeybee Rooms or a Model.

Inputs

rooms [Required]

Honeybee Rooms to which the input _constr_set should be assigned. This can also be a Honeybee Model for which all Rooms will be assigned the ConstructionSet.

constr_set [Required]

A Honeybee ConstructionSet to be applied to the input _room. This can also be text for a construction set to be looked up in the construction set library.

Outputs

rooms

The input Rooms with their construction sets edited.

Apply Opaque Construction

Apply OpaqueConstruction to Honeybee Faces, Doors or Room walls.

This component supports the assigning of different constructions based on cardinal orientation, provided that a list of OpaqueConstructions are input to the _constr.

Inputs

hb_objs [Required]

Honeybee Faces, Doors, Rooms or a Model to which the input _constr should be assigned. For the case of a Room or a Model, the construction will only be applied to the Room's outdoor walls. Note that, if you need to assign a construction to all the roofs, floors, etc. of a Room, the best practice is to create a ConstructionSet and assing that to the Room.

constr [Required]

A Honeybee OpaqueConstruction to be applied to the input _hb_objs. This can also be text for a construction to be looked up in the opaque construction library. If an array of text or construction objects are input here, different constructions will be assigned based on cardinal direction, starting with north and moving clockwise.

Outputs

hb_objs

The input honeybee objects with their constructions edited.

Apply Shade Construction

- [source code]

Apply a ShadeConstruction to Honeybee Shade objects. Alternatively, it can assign a ShadeConstruction to all of the child shades of an Aperture, Door, Face, or a Room.

This component supports the assigning of different constructions based on cardinal orientation, provided that a list of ShadeConstructions are input to the _constr.

Inputs

hb_objs [Required]
Honeybee Shades, Apertures, Doors, Faces, or Rooms to which the input _constr should be assigned. For the case of a Honeybee Aperture, Door, Face or Room, the ShadeConstruction will be assigned to only the child shades directly assigned to that object. So passing in a Room will not change the construction of shades assigned to Apertures of the Room's Faces. If this is the desired outcome, then the Room should be deconstructed into its child objects before using this component.
constr [Required]
A Honeybee ShadeConstruction to be applied to the input _hb_objs. This can also be text for a construction to be looked up in the shade construction library. If an array of text or construction objects are input here, different constructions will be assigned based on cardinal direction, starting with north and moving clockwise.

Outputs

hb_objs
The input honeybee objects with their constructions edited.

Apply Window Construction

- [source code]

Apply WindowConstruction or WindowConstructionShade to Honeybee Apertures or glass Doors. Alternatively, it can assign WindowConstructions to the child apertures of input Faces or the apertures within Room walls.

This component supports the assigning of different constructions based on cardinal orientation, provided that a list of WindowConstructions are input to the _constr.

Inputs

hb_objs [Required]

Honeybee Apertures, Faces, Doors, Rooms or a Model to which the input _constr should be assigned. For the case of a Room or a Model, the construction will only be applied to the apertures in the the Room's outdoor walls. Note that, if you need to assign a construction to all the skylights, glass doors, etc. of a Room, the best practice is to create a ConstructionSet and assing that to the Room.

constr [Required]

A Honeybee WindowConstruction or WindowConstructionShade to be applied to the input _hb_objs. This can also be text for a construction to be looked up in the window construction library. If an array of text or construction objects are input here, different constructions will be assigned based on cardinal direction, starting with north and moving clockwise.

Outputs

hb_objs

The input honeybee objects with their constructions edited.

Opaque Construction

- [source code]

Create an EnergyPlus opaque construction. Material inputs can be either the identifiers of materials within the library or a custom material made with any of the EnergyPlus Material components.

Note that the _materials should be ordered from outermost (exterior) layer to the innermost (interior) layer.

Inputs

name
Text to set the name for the Construction and to be incorporated into a unique Construction identifier.
materials [Required]
List of materials in the construction (from exterior to interior). These materials can be either fully-detailed material objects built with the material components or text for a material identifier to be looked up in the opaque material library. Note that a native Grasshopper "Merge" component can be used to help order the materials correctly for the input here.

Outputs

constr
An opaque construction that can be assigned to Honeybee Faces or ConstructionSets.

Shade Construction

- [source code]

Create an EnergyPlus shade construction. Note that Shade objects in EnergyPlus do not have layers and are only defined by their exterior reflectance.

Inputs

name
Text to set the name for the Construction and to be incorporated into a unique Construction identifier.
sol_ref
A number between 0 and 1 for the solar reflectance of the construction. Default: 0.2.
vis_ref
A number between 0 and 1 for the visible reflectance of the construction. Default: 0.2.
specular
A boolean to note whether the reflection off the shade should be diffuse (False) or specular (True). Set to True if the construction is representing a glass facade or a mirror material. Default: False.

Outputs

constr
A shade construction that can be assigned to Honeybee Shades or ConstructionSets.

Window Construction

- [source code]

Create an EnergyPlus window construction. Material inputs can be either the identifiers of materials within the library or a custom material made with any of the EnergyPlus Material components.

Note that the _materials should be ordered from outermost (exterior) layer to the innermost (interior) layer.

Inputs

name

Text to set the name for the Construction and to be incorporated into a unique Construction identifier.

materials [Required]

List of materials in the construction (from exterior to interior). These materials can be either fully-detailed material objects built with the material components or text for a material identifier to be looked up in the window material library. Note that a native Grasshopper "Merge" component can be used to help order the materials correctly for the input here.

frame

An optional window frame material to denote the frame that surrounds the window construction. Frame materials can be created using the "HB Window Frame" component.

Outputs

constr

A window construction that can be assigned to Honeybee Apertures or ConstructionSets.

Window Construction Shade

- [source code]

Create an EnergyPlus window construction that includes shades/blinds or a dynamically- controlled glass pane.

The result can be assigned to any Aperture or ConstructionSet just like any other WindowConstruction.

Inputs

name
Text to set the name for the Construction and to be incorporated into a unique Construction identifier.
win_constr [Required]
A WindowConstruction object that serves as the "switched off" version of the construction (aka. the "bare construction"). The shade material and shade location will be used to modify this starting construction. This can also be text for a construction identifier to be looked up in the window construction library.
shd_material [Required]
An Shade Material or an Blind Material that serves as the shading layer for this construction. This can also be a Glass Material, which will indicate that the WindowConstruction has a dynamically- controlled glass pane like an electrochromic window assembly. This can also be text for a material identifier to be looked up in the window material library.
shd_location
Text to indicate where in the window assembly the shade material is located. (Default: "Interior"). Choose from the following 3 options:
- Interior
- Between
- ExteriorNote that the WindowConstruction must have at least one gas gap to use the "Between" option. Also note that, for a WindowConstruction with more than one gas gap, the "Between" option defalts to using the inner gap as this is the only option that EnergyPlus supports.
control_type
An integer or text to indicate how the shading device is controlled, which determines when the shading is “on” or “off.” (Default: "AlwaysOn"). Choose from the options below (units for the values of the corresponding setpoint are noted in parentheses next to each option): 0 = AlwaysOn 1 = OnIfHighSolarOnWindow (W/m2) 2 = OnIfHighHorizontalSolar (W/m2) 3 = OnIfHighOutdoorAirTemperature (C) 4 = OnIfHighZoneAirTemperature (C) 5 = OnIfHighZoneCooling (W) 6 = OnNightIfLowOutdoorTempAndOffDay (C) 7 = OnNightIfLowInsideTempAndOffDay (C) 8 = OnNightIfHeatingAndOffDay (W)
setpoint
A number that corresponds to the specified control_type. This can be a value in (W/m2), (C) or (W) depending upon the control type.
schedule
An optional ScheduleRuleset or ScheduleFixedInterval to be applied on top of the control type. If None, the control type will govern all behavior of the construction.

Outputs

constr
A shaded window construction that can be assigned to Honeybee Apertures or ConstructionSets.

Opaque Material

- [source code]

Create a standard opaque material, which can be plugged into the "HB Opaque Construction" component.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
thickness [Required]
Number for the thickness of the material layer [m].
conductivity [Required]
Number for the thermal conductivity of the material [W/m-K].
density [Required]
Number for the density of the material [kg/m3].
spec_heat [Required]
Number for the specific heat of the material [J/kg-K].
roughness
Text describing the relative roughness of the material. Must be one of the following: 'VeryRough', 'Rough', 'MediumRough', 'MediumSmooth', 'Smooth', 'VerySmooth'. (Default: 'MediumRough').
therm_absp
A number between 0 and 1 for the fraction of incident long wavelength radiation that is absorbed by the material. (Default: 0.9).
sol_absp
A number between 0 and 1 for the fraction of incident solar radiation absorbed by the material. (Default: 0.7).
vis_absp
A number between 0 and 1 for the fraction of incident visible wavelength radiation absorbed by the material. Default value is the same as the sol_absp.

Outputs

mat
A standard opaque material that can be assigned to a Honeybee Opaque construction.

Opaque Material No Mass

- [source code]

Create an opaque material that has no mass, which can be plugged into the "HB Opaque Construction" component.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
r_value [Required]
Number for the R-value of the material [m2-K/W].
roughness
Text describing the relative roughness of a particular material. Must be one of the following: 'VeryRough', 'Rough', 'MediumRough', 'MediumSmooth', 'Smooth', 'VerySmooth'. (Default: 'MediumRough').
therm_absp
A number between 0 and 1 for the fraction of incident long wavelength radiation that is absorbed by the material. (Default: 0.9).
sol_absp
A number between 0 and 1 for the fraction of incident solar radiation absorbed by the material. (Default: 0.7).
vis_absp
A number between 0 and 1 for the fraction of incident visible wavelength radiation absorbed by the material. Default value is the same as the sol_absp.

Outputs

mat
A no-mass opaque material that can be assigned to a Honeybee Opaque construction.

Glass Material

- [source code]

Create a window material to describe a single glass pane corresponding to a layer in a window construction. This material can be plugged into the "HB Window Construction" component.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
thickness [Required]
Number for the thickness of the glass layer [m]. Typical values range from 0.003 meters (3 mm) to 0.012 meters (12 mm).
transmittance
Number between 0 and 1 for the transmittance of both solar radiation and visible light through the glass at normal incidence. (Default: 0.85 for clear uncoated glass).
reflectance
Number between 0 and 1 for the reflectance of both solar radiation and visible light off of the front side of the glass at normal incidence. (Default: 0.075 for clear uncoated glass).
t_infrared
Long-wave transmittance of the glass at normal incidence. (Default: 0).
emiss_front
Number between 0 and 1 for the infrared hemispherical emissivity of the front side of the glass. (Defaul: 0.84, which is typical of clear glass).
emiss_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 in W/m-K. (Default: 0.9, whih is typical of clear glass).

Outputs

mat
A window material that describes a single glass pane and can be assigned to a Honeybee Window construction.

Shade Material

- [source code]

Create a material for a shade layer in a window construction (like a roller shade). This material can be plugged into the "HB Window Construction" component.

Reflectance and emissivity properties are assumed to be the same on both sides of the shade. Shades are considered to be perfect diffusers.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
thickness [Required]
Number for the thickness of the shade layer in meters.
transmittance
Number between 0 and 1 for the transmittance of both solar radiation and visible light through the shade. (Default: 0.4, which is typical of a white diffusing shade).
reflectance
Number between 0 and 1 for the reflectance of both solar radiation and visible light off of the shade. (Default: 0.5, which is typical of a white diffusing shade).
t_infrared
Long-wave hemisperical transmittance of the shade. (Default: 0).
emissivity
Number between 0 and 1 for the infrared hemispherical emissivity of the shade. (Default: 0.9, which is typical of most diffusing shade materials).
conductivity
Number for the thermal conductivity of the shade in W/m-K. (Default: 0.05, typical of cotton shades).
dist_to_glass
A number between 0.001 and 1.0 for the distance between the shade and neighboring glass layers [m]. (Default: 0.05 (50 mm)).
open_mult
Factor between 0 and 1 that is multiplied by the area at the top, bottom and sides of the shade for air flow calculations. (Default: 0.5).
permeability
The fraction of the shade surface that is open to air flow. Must be between 0 and 0.8. (Default: 0 for no permeability).

Outputs

mat
A material for a shade layer in a window construction (like a roller shade) that can be assigned to a Honeybee Window construction.

Window Frame

- [source code]

Create a window frame matrial that can be assigned to a Window Construction by plugging it into the frame_ input of the "HB Window Construction" component.

Inputs

name

Text to set the name for the material and to be incorporated into a unique material identifier.

width [Required]

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 [Required]

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_cent

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_proj

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_proj

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).

therm_absp

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

sol_absp

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

vis_absp

A number between 0 and 1 for the fraction of incident visible wavelength radiation absorbed by the material. Default value is the same as the sol_absp.

Outputs

frame

A window frame material that can be assigned to a Honeybee Window construction.

Window Material

- [source code]

Create a simple window material to describe an entire glazing system, including glass, gaps, and frame. This material can be plugged into the "HB Window Construction" component.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
u_factor [Required]
A number for the U-factor of the glazing system [W/m2-K] including standard air gap resistances on either side of the glazing system.
shgc [Required]
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.
t_vis
A number between 0 and 1 for the visible transmittance of the glazing system. (Default: 0.6).

Outputs

mat
A window material that describes an entire glazing system, including glass, gaps, and frame and can be assigned to a Honeybee Window construction.

Blind Material

- [source code]

Create a material for a blind layer in a window construction. This material can be plugged into the "HB Window Construction" component.

Window blind properties consist of flat, equally-spaced slats.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
vertical
Set to "True" to have the blinds be vertically-oriented and set to "False" to have them be horizontally-oriented. (Default: False for horizontal).
slat_width
The width of slat measured from edge to edge [m]. (Default: 0.025 m).
slat_separation
The distance between each of the slats [m]. (Default: 0.01875 m).
slat_thickness
A number between 0 and 0.1 for the thickness of the slat in meters. (Default: 0.001 m).
slat_angle
A number between 0 and 180 for the angle between the slats and the glazing normal in degrees. 90 signifies slats that are perpendicular to the glass. (Default: 45).
conductivity
Number for the thermal conductivity of the blind material [W/m-K]. (Default: 221, typical of aluminum blinds).
transmittance
Number between 0 and 1 for the transmittance of solar radiation and visible light through the blind material. (Default: 0).
reflectance
Number between 0 and 1 for the reflectance of solar radiation and visible light off of the blind material. (Default: 0.5, which is typical of a painted white blind).
t_infrared
Long-wave hemisperical transmittance of the blind material. (Default: 0).
emissivity
Number between 0 and 1 for the infrared hemispherical emissivity of the blind material. (Default: 0.9, which is typical of most painted blinds).
dist_to_glass
A number between 0.001 and 1.0 for the distance between the blind edge and neighboring glass layers [m]. (Default: 0.05 m).
open_mult
Factor between 0 and 1 that is multiplied by the area at the top, bottom and sides of the blind for air flow calculations. (Default: 0.5).

Outputs

mat
A material for a blind layer in a window construction that can be assigned to a Honeybee Window construction.

Custom Window Gap Material

- [source code]

Create a custom gas gap material that corresponds to a layer in a window construction. This material can be plugged into the "HB Window Construction" component.

This object allows you to specify specific values for conductivity, viscosity and specific heat through the following formula: property = A + (B * T) where: A, B = regression coefficients for the gas T = temperature [K]

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
thickness [Required]
Number for the thickness of the gas gap layer in meters.
conductivity_a [Required]
First conductivity coefficient. Or condictivity in [W/m-K] if b coefficient is 0.
viscosity_a [Required]
First viscosity coefficient. Or viscosity in [kg/m-s] if b coefficient is 0.
specific_heat_a [Required]
First specific heat coefficient. Or the specific heat in [J/kg-K] if b coefficient is 0.
conductivity_b
Second conductivity coefficient. (Default: 0).
viscosity_b
Second viscosity coefficient. (Default: 0).
specific_heat_b
Second specific heat coefficient. (Default: 0).
spec_heat_ratio
A number for the the ratio of the specific heat a contant pressure, to the specific heat at constant volume. (Default: 1.0 for Air).
mol_weight
Number between 20 and 200 for the mass of 1 mol of the substance in grams. (Default: 20.0).

Outputs

mat
A custom gas gap material that describes a layer in a window construction and can be assigned to a Honeybee Window construction.

Vegetation Material

Create a vegetation material representing both plants and soil, which can be plugged into the "HB Opaque Construction" component.

Note that the underlying models for this material were developed using horizontal roofs and caution should be taken when applying ito to vertical walls.

Inputs

name

Text to set the name for the material and to be incorporated into a unique material identifier.

plant_height

A number between 0.005 and 1.0 for the height of plants in the vegetation layer [m]. (Default: 0.2 m).

leaf_area_ind

A number between 0.001 and 5.0 for the projected leaf area per unit area of soil surface (aka. Leaf Area Index or LAI). Note that the fraction of vegetation cover is calculated directly from LAI using an empirical relation. (Default: 1.0).

leaf_reflect

A number between 0.05 and 0.5 for the fraction of incident solar radiation that is reflected by the leaf surfaces. Solar radiation includes the visible spectrum as well as infrared and ultraviolet wavelengths. Typical values are 0.18 to 0.25. (Default: 0.22).

leaf_emiss

A number between 0.8 and 1.0 for the ratio of thermal radiation emitted from leaf surfaces to that emitted by an ideal black body at the same temperature. (Default: 0.95).

soil_reflect

A number between 0 and 1 for the fraction of incident solar radiation reflected by the soil material. (Default: 0.3).

soil_emiss

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

stomat_resist

A number between 50 and 300 for the resistance of the plants to moisture transport [s/m]. Plants with low values of stomatal resistance will result in higher evapotranspiration rates than plants with high resistance. (Default: 180).

thickness

Number for the thickness of the soil layer [m]. (Default: 0.1).

conductivity

Number for the thermal conductivity of the soil [W/m-K]. (Default: 0.35).

density

Number for the density of the soil [kg/m3]. (Default: 1100).

spec_heat

Number for the specific heat of the soil [J/kg-K]. (Default: 1200).

Outputs

mat

A vegetation material that can be assigned to a Honeybee Opaque construction.

Window Construction Dynamic

Create an EnergyPlus window construction with any number of dynamic states.

Inputs

name
Text to set the name for the Construction and to be incorporated into a unique Construction identifier.
constructions [Required]
List of materials in the construction (from exterior to interior). These materials can be either fully-detailed material objects built with the material components or text for a material identifier to be looked up in the window material library. Note that a native Grasshopper "Merge" component can be used to help order the materials correctly for the input here.
schedule [Required]
A control schedule that dictates which constructions that are active at given times throughout the simulation. Inputs can be either the identifiers of schedules within the library or custom schedules made with any of the honeybee schedule components. The values of the schedule should be intergers and range from 0 to one less then the number of constructions. Zero indicates that the first construction is active, one indicates that the second on is active, etc. The schedule type limits of this schedule should be "Control Level." If building custom schedule type limits that describe a particular range of states, the type limits should be "Discrete" and the unit type should be "Mode," "Control," or some other fractional unit.

Outputs

constr
A dynamic window construction that can be assigned to Honeybee Apertures or ConstructionSets.

Window Gap Material

Create a window gas gap material that corresponds to a layer in a window construction. This material can be plugged into the "HB Window Construction" component.

Inputs

name
Text to set the name for the material and to be incorporated into a unique material identifier.
thickness
Number for the thickness of the air gap layer in meters. (Default: 0.0125 m).
gas_types
A list of text describing the types of gas in the gap. Text must be one of the following: 'Air', 'Argon', 'Krypton', 'Xenon'.
gas_ratios
A list of text describing the volumetric fractions of gas types in the mixture. This list must align with the gas_types input list. Default: Equal amout of gases for each type.

Outputs

mat
A window gas gap material that describes a layer in a window construction and can be assigned to a Honeybee Window construction.