Foundation¶
The description of the foundation design is provided within the twodimensional context. This profile is applied along the entire perimeter of the foundation.
The foundation insulation and structural components are defined by (up to) six subobjects. These objects allow the user to flexibly describe any foundation construction.
Example:
Foundation:
Foundation Depth: 0.0 # [m]
Polygon:
 [0, 0] # [m, m]
 [0, 20] # [m, m]
 [20, 20] # [m, m]
 [20, 0] # [m, m]
Soil: Typical Soil # Material reference
Slab:
Layers:

Material: Concrete # Material reference
Thickness: 0.2032 # [m]
Wall:
Layers:

Material: Concrete # Material reference
Thickness: 0.3048 # [m]
Height Above Grade: 0.3048 # [m]
Depth Below Slab: 0.3 # [m]
Interior Horizontal Insulation:
Width: 0.4064 # [m]
Material: XPS # Material reference
Thickness: 0.0508
Interior Vertical Insulation:
Depth: 0.2032 # [m]
Material: XPS # Material reference
Thickness: 0.0508 # [m]
Foundation Depth¶
Foundation Depth
defines the distance from the wall top to the floor. This value is used to characterize the type of foundation (slab, crawlspace, or basement). For example, a value of zero would represent a sla and a value near 2 meters would represent a basement.
Required:  Yes 
Type:  Numeric 
Units:  m 
Polygon¶
The foundation shape is defined by the description of a single polygon. The perimeter of this polygon defines the location of the interior surface of the foundation wall. The positioning of the foundation insulation and structural components are translated into threedimensional space internally.
The polygon is specified by a list of xy Cartesian vertices tracing the foundation perimeter in a clockwise fashion. When simulating in threedimensions, the polygon must be rectilinear (comprised only of right angles).
Example:
Polygon:
 [0, 20]
 [15, 20]
 [15, 30]
 [30, 30]
 [30, 17]
 [22, 17]
 [22, 0]
 [12, 0]
 [12, 10]
 [0, 10]
Required:  Yes 
Type:  List [N] of lists [2] of numerics 
Units:  m 
Exposed Perimeter¶
A true/false list corresponding to each segment of the polygon. Segments are defined between polygon vertices N and N + 1. A value of true implies that the ground adjacent to a segment is exposed to the exterior environment. Conversly, a value of false indicates that the ground adjacent to a segment neighbors another interior space.
Only exposed perimeter is considered in heat transfer calculations.
This is only used for twodimensional simulations.
Example:
Exposed Perimeter:
 true
 true
 true
 true
 false
 false
 true
 true
 true
 true
Required:  No 
Type:  List [N] of booleans 
Default:  All true 
Exposed Fraction¶
Alternative to defining the Exposed Perimeter, one may define the fraction of the total perimeter that is exposed. Using this option will revert any BOUNDARY type 2Dapprox`s to `AP (as it’s not possible to know explicitly which segments represent concave geometry).
This is only used for twodimensional simulations.
Example:
Exposed Fraction: 0.85
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  N/A (see Exposed Perimeter default) 
Soil¶
Represents the soil surrounding the building foundation.
Required:  Yes 
Type:  Material reference 
Slab¶
This defines the costruction of the floor slab in the foundation. This is not required. If there is no slab defined for a given foundation, then the floor is exposed soil.
Example:
Slab:
Layers:

Material: XPS # Material reference
Thickness: 0.0508 # [m]

Material: Concrete # Material reference
Thickness: 0.2032 # [m]
Required:  No 
Type:  Compound object 
Layers¶
Layers are specified as a list of material references, and thickness values from the outtermost layer to the innermost layer (at the floor surface). A layer of insulation can be added to model wholeslab insulation.
Required:  Yes 
Type:  List of layers (a material and a thickness) 
Emissivity¶
Interior emissivity of the slab used for interior longwave radiation calculations.
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  0.8 
Wall¶
This defines the costruction of the foundation wall. This is not required. If there is no wall defined for a given foundation, then the wall is exposed soil.
Example:
Wall:
Depth Below Slab: 0.3 # [m]
Height Above Grade: 0.3048 # [m]
Layers:

Material: XPS # Material reference
Thickness: 0.0508 # [m]

Material: Concrete # Material reference
Thickness: 0.2032 # [m]

Material: XPS # Material reference
Thickness: 0.0508 # [m]
Required:  No 
Type:  Compound object 
Height Above Grade¶
The height of the wall top relative to the grade (z = 0).
Required:  No 
Type:  Numeric 
Units:  m 
Default:  0.2 
Depth Below Slab¶
The distance from the bottom of the slab to the bottom of the foundation wall. The total wall extends down to this level.
Required:  No 
Type:  Numeric 
Units:  m 
Default:  0.3 
Layers¶
Layers are specified as a list of material references, and thickness values from the outtermost layer to the innermost layer (at the interior wall surface).
Interior Emissivity¶
Interior emissivity of the wall used for interior longwave radiation calculations.
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  0.8 
Exterior Emissivity¶
Exterior emissivity of the wall used for exterior longwave radiation calculations.
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  0.8 
Exterior Absorptivity¶
Exterior absorptivity of the wall used for calculating absorbed solar radiation.
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  0.8 
Interior Horizontal Insulation¶
This defines the position, dimensions, and material of interior horizontal insulation. Interior horizontal insulation begins at the wall’s interior surface and extends inward and downward to a userspecified width and thickness at a userspecified depth at or below the Foundation Depth.
Example:
Interior Horizontal Insulation:
Material: XPS # Material reference
Thickness: 0.0508 # [m]
Width: 0.4064 # [m]
Required:  No 
Type:  Compound object 
Depth¶
Depth of the insulation measured from the bottom of the slab to the top of the insulation.
Required:  No 
Type:  Numeric 
Units:  m 
Default:  0.0 
Width¶
Width of the insulation extending from the interior wall surface.
Required:  Yes 
Type:  Numeric 
Units:  m 
Interior Vertical Insulation¶
This defines the position, dimensions, and material of interior vertical insulation. Interior vertical insulation begins at the wall top and extends downward and inward to a userspecified depth and thickness. The depth can be specified to model partial interior wall insulation.
Example:
Interior Vertical Insulation:
Material: XPS # Material reference
Thickness: 0.0508 # [m]
Depth: 0.6096 # [m]
Required:  No 
Type:  Compound object 
Depth¶
Depth of the insulation measured from the wall top to the bottom of the insulation.
Required:  Yes 
Type:  Numeric 
Units:  m 
Exterior Horizontal Insulation¶
This defines the position, dimensions, and material of exterior horizontal insulation. Exterior horizontal insulation begins at the wall’s exterior surface and extends outward and downward to a userspecified width and thickness at a userspecified depth at or below the grade level.
Example:
Exterior Horizontal Insulation:
Material: XPS # Material reference
Thickness: 0.0508 # [m]
Width: 0.6096 # [m]
Required:  No 
Type:  Compound object 
Depth¶
Depth of the insulation measured from the exterior grade to the top of the insulation.
Required:  No 
Type:  Numeric 
Units:  m 
Default:  0.0 
Width¶
Width of the insulation extending from the interior wall surface.
Required:  Yes 
Type:  Numeric 
Units:  m 
Exterior Vertical Insulation¶
This defines the position, dimensions, and material of exterior vertical insulation. Exterior vertical insulation begins at the wall top and extends downward and outward to a userspecified depth and thickness.
Example:
Exterior Vertical Insulation:
Material: XPS # Material reference
Thickness: 0.0508 # [m]
Depth: 2.0 # [m]
Required:  No 
Type:  Compound object 
Depth¶
Depth of the insulation measured from the wall top to the bottom of the insulation.
Required:  Yes 
Type:  Numeric 
Units:  m 
Footing¶
This defines dimensions, and material of the foundation footing. The footing is vertically centered and placed immediately below the foundation wall.
The footing is optional, and has minor impacts on foundation heat transfer while the additional detail increases the required computation time. As an approximation, users may choose to extend the depth of a concrete wall to represent the footing.
Example:
Footing:
Material: Concrete # Material reference
Depth: 0.254 # [m]
Width: 0.762 # [m]
Required:  No 
Type:  Compound object 
Depth¶
Depth (from top to bottom) of the footing (not to be confused with its depth in the ground).
Required:  Yes 
Type:  Numeric 
Units:  m 
Material Blocks¶
Beyond the solid materials explicity defined by the Slab, Wall, and Insulation objects, general Material Blocks may also be used to define any number of variations within the solid domain.
Material Blocks are specified as a list of material references, and geometric inputs. Each block is defined by its position relative to the top interior corner of the foundation wall in the twodimensional context.
If a Material Blocks overlapping other materials take precendence in the order defined by the list (later blocks have higher precidence).
Example:
Material Blocks:

Material: Infill Soil # Material reference
Z Position: 0.3048 # [m]
X Position: 0.254 # [m]
Depth: 3.0 # [m]
Width: 3.0 # [m]

Material: Batt Insulation # Material reference
Z Position: 0.0 # [m]
X Position: 0.0 # [m]
Depth: 2.44 # [m]
Width: 0.0889 # [m]
Required:  No 
Type:  List of blocks 
Z Position¶
Starting position of the block relative to the origin at the top of the foundation wall. Defined as positive in the downward direction. Negative values (above the wall) are not allowed.
Required:  Yes 
Type:  Numeric 
Units:  m 
X Position¶
Starting position of the block relative to the interior of the foundation wall. Defined as positive in the outward direction. Negative values indicate a position interior to the wall.
Required:  Yes 
Type:  Numeric 
Units:  m 
Depth¶
Depth (from top to bottom) of the material block (not to be confused with its depth in the ground [see Z Position]). A positive value extends the block downward (in the positive Z direction) while a negative value extends the block upward.
Required:  Yes 
Type:  Numeric 
Units:  m 
Width¶
Width of the material block. A positive value extends the block outward (in the positive X direction) while a negative value extends the block inward.
Required:  Yes 
Type:  Numeric 
Units:  m 
Soil Absorptivity¶
Solar absorptivity of the soil or grade surface.
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  0.8 
Soil Emissivity¶
Longwave emissivity of the soil or grade surface.
Required:  No 
Type:  Numeric 
Units:  dimensionless 
Default:  0.8 
Surface Roughness¶
Represents the relief of the surface. This value is used to calculate forced convection and the wind speed near the grade surface. Roughness values in the table below are converted from the more qualitative rougness values used in DOE2 and EnergyPlus. Estimates for soil, gravel, and grass are also shown.
Example Surface  Roughness [m] 

Glass  0.00000 
Smooth Plaster  0.00044 
Clear Pine  0.00052 
Concrete  0.00208 
Brick  0.00268 
Stucco  0.00468 
Soil  0.00500 
Gravel  0.01200 
Grass  0.03000 
Required:  No 
Type:  Numeric 
Units:  m 
Default:  0.03 
Orientation¶
Defines the orientation of the building clockwise relative to North (East = \(\pi/2\), South = \(\pi\), West = \(3\pi/2\)). This is used to calculate the solar incidence and wind direction relative to exterior vertical foundation surfaces.
Required:  No 
Type:  Numeric 
Units:  radians 
Default:  0.0 
Perimeter Surface Width¶
This value is used to define a portion of the slab’s perimeter separately from the slab core. This will affect the meshing of the slab, but is intended primarily for separate output reporting for each region.
Required:  No 
Type:  Numeric 
Units:  m 
Default:  0.0 