Table of Contents
The flexibility of HPXML allows specification of any number of walls and windows facing any direction. HEScore expects only one wall/window specification for each side of the building (front, back, left, right).
Each wall in the HPXML document that has an
or is missing the
ExteriorAdjacentTo subelement (assumed to be ambient) is
considered for translation to HEScore. This excludes attic knee walls, interior
walls, walls between living space and a garage, etc. since HEScore does not
model those walls. The translator then attempts to assign each wall
to the nearest side of the building, which is relative to the orientation of
the front of the building. The wall construction and exterior finish of the
largest wall by area on each side of the building are used to define the
properties sent to HEScore. An area weighted R-value of all the walls on each
side of the building is calculated as well as described in Area Weighted Wall R-value.
If there is only one wall on any side of the house, the area is not required
for that side. If a wall falls exactly between two sides of the house the area
of the wall is divided by two and half of the wall is assigned to either side.
HEScore also allows the specification of one wall for all sides of the building. If none of the walls in HPXML have orientation (or azimuth) data, the wall construction and exterior finish of the largest wall by area on each side of the building are used to define the properties sent to HEScore. An area weighted R-value of all the walls on each side of the building is calculated as well as described in Area Weighted Wall R-value. If there is only one wall and no area specified, that wall is used to determine the wall construction.
The following conditions must be met for the wall translation to succeed:
- If there is more than one wall on each side of the building each wall on that side of the building must have an
- Either all walls must have an
Orientationor none of them must.
HEScore uses a selection of construction codes to describe wall construction type, insulation levels, and siding. HPXML, as usual, uses a more flexible approach defining wall types: layers of insulation materials that each include an R-value, thickness, wall cavity information, etc. To translate the inputs from HPXML to HEScore approximations need to be made to condense the continuous inputs in HPXML to discrete inputs required for HEScore.
WallType/WoodStud is selected in HPXML, each layer of the wall insulation
is parsed and if a rigid and continuous layer is found, or if the subelement
WallType/WoodStud/ExpandedPolyStyreneSheathing is found, the wall is
specified in HEScore as “Wood Frame with Rigid Foam Sheathing.”
<Wall> <SystemIdentifier id="wall1"/> <WallType> <WoodStud> <!-- Either this element needs to be here or continuous insulation below --> <ExpandedPolystyreneSheathing>true</ExpandedPolystyreneSheathing> </WoodStud> </WallType> <Insulation> <SystemIdentifier id="wall1ins"/> <Layer> <InstallationType>continuous</InstallationType> <InsulationMaterial> <Rigid>eps</Rigid> <!-- This can have any of the valid enumerations for this element, it only cares if the Rigid element is present. --> </InsulationMaterial> <NominalRValue>5</NominalRValue> </Layer> ... </Insulation> </Wall>
Otherwise, if the
OptimumValueEngineering boolean element is set to
true, the “Wood Frame with Optimal Value Engineering” wall type in HEScore
<Wall> <SystemIdentifier id="wall2"/> <WallType> <WoodStud> <OptimumValueEngineering>true</OptimumValueEngineering> </WoodStud> <Insulation> ... </Insulation> </WallType> </Wall>
OptimumValueEngineering flag needs to be set in HPXML to
translate to this wall type. The translator will not infer this from stud
Finally, if neither of the above conditions are met, the wall is specified as simply “Wood Frame” in HEScore.
In all cases the R-value is summed for all insulation layers and the nearest discrete R-value from the list of possible R-values for that wall type is used. For walls with rigid foam sheathing, R-5 is subtracted from the nominal R-value sum to account for the R-value of the sheathing in the HEScore construction assembly.
Siding is selected according to the siding map.
WallType/StructuralBrick is found in HPXML, one of the structural brick
codes in HEScore is specified. The nearest R-value to the sum of all the
insulation layer nominal R-values is selected.
<Wall> <SystemIdentifier id="wall3"/> <WallType> <StructuralBrick/> </WallType> <Insulation> <SystemIdentifier id="wall3ins"/> <Layer> <NominalRValue>5</NominalRValue> </Layer> <Layer> <NominalRValue>5</NominalRValue> </Layer> <!-- This would have a summed R-value of 10 --> </Insulation> </Wall>
WallType/Stone is found, one of the
concrete block construction codes is used in HEScore. The nearest R-value to
the sum of all the insulation layer nominal R-values is selected. The siding is
translated using the same assumptions as wood stud walls
with the exception that vinyl, wood, or aluminum siding is not available and if
those are specified in the HPXML an error will result.
WallType/StrawBale is found in the HPXML wall, the straw bale wall
assembly code in HEScore is selected.
Siding mapping is done from the
Wall/Siding element in HPXML. Siding is
specified as the last two characters of the construction code in HEScore.
|fiber cement siding||wo|
|composite shingle siding||wo|
not translated means the translation will fail for that house.
When more than one HPXML
Wall element must be combined into one wall
construction for HEScore, the wall construction code is determined for each
Wall as described in Wall Construction. The wall construction
and exterior finish that represent the largest combined area are used to
represent the side of the house.
A weighted R-value is calculated by looking up the center-of-cavity
R-value for the wall construction, exterior finish, and nominal R-value for
Wall from the following table.
|Exterior||Wood Siding||Stucco||Vinyl||Aluminum||Brick Veneer||None|
|Wood Frame w/insulated sheathing|
|Optimum Value Engineering|
Then a weighted average is calculated by weighting the U-values values by area.
The R-0 center-of-cavity R-value () is selected for the highest weighted wall construction type represented in the calculation and is subtracted from . For construction types where there is no R-0 nominal value, the lowest nominal R-value is subtracted from the corresponding effective R-value.
Finally the R-value is rounded to the nearest insulation level in the enumeration choices for the highest weighted roof construction type included in the calculation.