Foundation¶
The description of the foundation design is provided within the two-dimensional context. This profile is applied along the entire perimeter of the foundation.
The foundation insulation and structural components are defined by (up to) six sub-objects. 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 three-dimensional space internally.
The polygon is specified by a list of x-y Cartesian vertices tracing the foundation perimeter in a clockwise fashion. When simulating in three-dimensions, 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 two-dimensional 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 two-dimensional 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 whole-slab insulation.
Required: | Yes |
Type: | List of layers (a material and a thickness) |
Emissivity¶
Interior emissivity of the slab used for interior long-wave 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 long-wave radiation calculations.
Required: | No |
Type: | Numeric |
Units: | dimensionless |
Default: | 0.8 |
Exterior Emissivity¶
Exterior emissivity of the wall used for exterior long-wave 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 user-specified width and thickness at a user-specified 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 user-specified 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 user-specified width and thickness at a user-specified 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 user-specified 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 two-dimensional 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: In-fill 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¶
Long-wave 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 DOE-2 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 |