Foundation Insulation

Determining the primary foundation

HEScore permits the specification of two foundations. A Foundation element for each foundation in the house is required in HPXML. The two foundations that cover the largest area are selected. This is determined by summing up the area of the FrameFloor (v2 or v3), Floor (v4), or Slab elements (depending on what kind of foundation it is). Area elements are required for all foundations unless there is only one foundation, then it is assumed to be the footprint area of the building. If there are more than two foundations, the areas of the largest two are scaled up to encompass the area of the remaining foundations while maintaining their respective area fractions relative to each other.

Foundation Type

Once a foundation is selected, the HEScore foundation type is selected from HPXML according to the following table.

HPXML to HEScore foundation type mapping

HPXML Foundation Type		HEScore Foundation Type
Basement	Conditioned=”true”	cond_basement
	Conditioned=”false” or omitted	uncond_basement
Crawlspace	Vented=”true”	vented_crawl
	Vented=”false” or omitted	unvented_crawl
SlabOnGrade		slab_on_grade
Garage		unvented_crawl
AboveApartment		above_other_unit
Combination		not translated
Ambient		vented_crawl
RubbleStone		not translated
BellyAndWing [1]		belly_and_wing
Other		not translated

[1]

BellyAndWing is first available in HPXML v4. It can be specified in earlier versions using the FoundationType/Other/extension/BellyAndWing element.

Warning

For foundation types that are not translated the translation will return an error.

Foundation wall insulation R-value

If the foundation type is a basement or crawlspace, a FoundationWall is required to be referenced via the Foundation/AttachedtoFoundationWall element. For each foundation wall R-value can be described by using nominal R-value or assembly R-value. If a user wishes to use a nominal R-value, nominal R-value for all layers need to be provided. Otherwise, assembly R-values for the whole foundation wall needs to be provided. Preference is given to assembly R-values.

If nominal R-value is specified, the R-value is the sum of the FoundationWall/Insulation/Layer/NominalRValue element values for each foundation wall. For each foundation wall, an assembly R-value for that wall is looked up based on the nearest R-value in the following table.

Basement and crawlspace wall effective R-values

Insulation Level	Effective R-value
R-0	4
R-11	11.6
R-19	16.9

When more than one HPXML FoundationWall element must be combined into one foundation wall construction for HEScore, an area weighted average R-value is calculated for the foundation walls. The area is obtained from the Area element, if present, or calculated from the Length and Height elements. The weighted average R-value is calculated by weighting the U-values by area.

\begin{align*} U_i &= \frac{1}{R_{eff,i}} \\ U_{avg} &= \frac{\sum_i{U_i A_i}}{\sum_i A_i} \\ R_{eff,avg} &= \frac{1}{U_{avg}} \\ \end{align*}

Finally, the nearest nominal insulation level is selected from Basement and crawlspace wall effective R-values.

Slab insulation R-value

If the foundation type is a slab on grade, an area weighted average R-value is calculated using the value of ExposedPerimeter as the area. (The units work out, the depth in the area drops out of the equation.) The R-value is the sum of the Slab/PerimeterInsulation/Layer/NominalRValue element values for each foundation wall. For each slab, an effective R-value is looked up based on the nearest R-value in the following table.

Slab insulation effective R-values

Insulation Level	Effective R-value
R-0	4
R-5	7.9

Then a weighted average R-value is calculated by weighting the U-values by area.

\begin{align*} U_i &= \frac{1}{R_i} \\ U_{eff,avg} &= \frac{\sum_i{U_i A_i}}{\sum_i A_i} \\ R_{eff,avg} &= \frac{1}{U_{eff,avg}} \\ \end{align*}

The effective R-value of the R-0 insulation level is then subtracted.

\[R = R_{eff,avg} - 4.0\]

Finally, the nearest insulation level is selected from the enumeration list.

Floor insulation above basement, crawlspace, or belly and wing

Warning

In HPXML v2 and v3, the FrameFloor element is used to describe the floor. In HPXML v4, the Floor element is used. The translation logic is the same between versions of HPXML, in the documentation we will use Floor, but if you are using HPXML v2 or v3, you should replace with FrameFloor.

If the foundation type is an unconditioned basement, crawlspace, or manufactured home belly and wing, a Floor element is required to be referenced via the Foundation/AttachedToFloor element. For each floor above the foundation, a weighted average using the floor area and R-value are calculated. The area is obtained from the Area element.

The floor R-value can be described by using NominalRValue or AssemblyEffectiveRValue. If a user wishes to use a nominal R-value, NominalRValue elements for all layers need to be provided. Otherwise, AssemblyEffectiveRValue element is required.

Nominal R-value

If NominalRValue is used, the nominal R-value of each layer is summed for the floor: sum(Floor/Insulation/Layer/NominalRValue). The nearest assembly code to that nominal R-value is selected from the lookup table. For example, the following Floor in xml:

<Floor>
      <Insulation>
         <Layer>
            <NominalRValue>10</NominalRValue>
         </Layer>
         <Layer>
            <NominalRValue>8</NominalRValue>
         </Layer>
      </Insulation>
</Floor>

Has a summed nominal R-value of 18, which corresponds to the closest assembly code efwf19ca and an assembly effective R-value of 22.2.

Assembly Effective R-value

If AssemblyEffectiveRValue is used, the nominal R-value nearest to assembly effective R-value from the lookup table is used.

Combining Multiple Floors

When more than one HPXML Floor element must be combined into one floor construction for HEScore, a weighted average assembly R-value is determined by weighting the U-values by area.

\begin{align*} U_i &= \frac{1}{R_{eff,i}} \\ U_{eff,avg} &= \frac{\sum_i{U_i A_i}}{\sum_i A_i} \\ R_{eff,avg} &= \frac{1}{U_{eff,avg}} \\ \end{align*}

Then the assembly code nearest to the weighted average assembly R-value from the lookup table is selected.

Lookup table for floor effective R-values

doe2code	U-value	Eff-R-value
efwf00ca	0.1750	5.7
efwf03ca	0.1211	8.3
efwf07ca	0.0859	11.6
efwf11ca	0.0665	15.0
efwf13ca	0.0598	16.7
efwf15ca	0.0543	18.4
efwf19ca	0.0458	21.8
efwf21ca	0.0425	23.5
efwf25ca	0.0372	26.9
efwf30ca	0.0321	31.1
efwf35ca	0.0283	35.4
efwf38ca	0.0264	37.9
efbw00	0.1530	6.5
efbw11	0.0564	17.7
efbw13	0.0507	19.7
efbw19	0.0407	24.6
efbw22	0.0366	27.3
efbw30	0.0292	34.3