Interface CrawlSpace

Represents a crawlspace structure in the building. Contains the crawlspace's dimensions, materials, ventilation type, and thermal characteristics.

interface CrawlSpace {
    above_grade_wall_area: number | "";
    area: number | "";
    below_grade_wall_area: number | "";
    corners: number;
    depth: number | "";
    exterior_perimeter: number | "";
    feature_entity: Entity;
    floorsAbove_entity: Entity;
    header?: { entity: Entity; height: number | ""; perimeter: number | "" };
    heated_slab?: boolean;
    height: number | "";
    integral_footing?: boolean;
    perimeter: number | "";
    room?: string;
    slab_entity: Entity;
    usage: "heated" | "open" | "vented";
    wall_entity: Entity;
}

Properties

above_grade_wall_area: number | ""

Surface area of crawlspace walls.

area: number | ""

Floor area of the crawlspace in square meters.

Used to calculate total_foundation_floor_area and total_crawlSpace_floor_area.

For F280: Core parameter in heat flow modeling. For heated crawlspaces, this is used directly.

below_grade_wall_area: number | ""

Crawl spaces are assumed to be above grade, use basement for below grade applications.

corners: number

Number of external corners in the crawlspace structure.

May have use in thermal bridging calculations.

depth: number | ""

Crawl spaces are assumed to be above grade, use basement for below grade applications.

exterior_perimeter: number | ""

Length of crawlspace walls exposed to exterior conditions in meters.

Used to calculate crawlSpace_exterior_perimeter and wall areas.

For F280: Determines the proportion of walls in contact with exterior soil vs. adjacent spaces for heat loss calculations.

feature_entity: Entity

Used for skirt configuration and insulation value. Affects the crawl space configuration.

floorsAbove_entity: Entity

Material composition of the floor structure above the crawlspace.

For F280: Used for thermal properties in unheated crawlspaces. When usage is not 'heated', this boundary is adiabatic and the wall/slab take the front seat for the heat loss calculations.

For EnerGuide: Exported to HOT2000 as FloorsAbove element with its R-value for the thermal boundary above the crawlspace.

header?: { entity: Entity; height: number | ""; perimeter: number | "" }

Optional header structure above the crawl space, same as above grade walls.

Type declaration

  • entity: Entity

    Material composition of the header

  • height: number | ""

    Height of the header in meters

  • perimeter: number | ""

    Length of the header in meters

heated_slab?: boolean

Whether the crawlspace floor has embedded heating (optional).

Used to identify heated foundation areas. May affect heat flow patterns in foundation calculations.

For EnerGuide: HeatedFloor attribute in floor construction if present. Default is false if not specified.

height: number | ""

Interior height of the crawlspace in meters.

Used to calculate teh volume of the air inside the crawl space, as well as the ceiling heights, if those are not explicitly defined.

integral_footing?: boolean

Whether the footing is integrated with the wall structure (optional).

Used to identify foundation configurations.

perimeter: number | ""

Total perimeter of the crawlspace in meters. even the portions that may interface with another heated space. Is for documentation purposes. It may be made equal to exterior_perimeter as long as it is large enough to encapsulate the entire crawlspace area.

Used to calculate total_foundation_perimeter.

room?: string

Name of the room this crawlspace is associated with. Links to a specific room in house.space.rooms when available.

In F280: Used to associate the crawlspace with room-level heat loss calculations.

slab_entity: Entity

See Entity. This entity is specifically used in foundation heat loss calculations for the slab component and not the floor of the living space.

For EnerGuide: Used in conjunction with the wall Entity to determine the crawl space configuration, which is also set in the HOT2000 export.

usage: "heated" | "open" | "vented"

Ventilation type of the crawlspace.

  • 'heated': Conditioned crawlspace
  • 'vented': Unconditioned with controlled ventilation
  • 'open': Unconditioned and open to elements.

Used to identify heated crawlspaces for calculations.

For F280: Critical parameter affecting multiple calculations but in general it determines whether crawl space is a part of the envelope or not.

For EnerGuide: Determines the heat loss boundaries. Also determines whether crawlspace is marked as heated in the Temperatures part of the standard.

wall_entity: Entity

Material composition of the crawlspace walls. For heated crawl spaces it behaves the same as the upper floor walls. So the "usage" property impacts it. It is still used for some thermal properties in unheated crawlspaces.