Interface WindowBase

Base interface for window components in the building. Contains shared properties for all window types. It is always nested in a wall, roof, etc. and it takes some properties from its parent. For example, the room name can come from the parent for F280 room by room calculations.

interface WindowBase {
    assembled_entity?: Entity;
    blinds?: "none" | "interior" | "reflective" | "exterior";
    direction: CardinalDirections;
    entity: Entity;
    height: number;
    overhang_height: number;
    overhang_width: number;
    shgc_entity: Entity;
    tilt: number;
    type: "Picture" | "Hinged" | "Slider";
    width: number;
}

Properties

assembled_entity?: Entity

Optional. It is consisted of a window's "entity" and "shgc_entity" in one place for convenience and certain operations.

blinds?: "none" | "interior" | "reflective" | "exterior"

Type of window blinds or shading devices.

Used to adjust solar gain calculations, and the added r-value when the exterior blinds are closed. Different blind types have different solar reduction factors.

For F280: Affects cooling load calculations by reducing solar gain. Interior blinds have less effect than exterior or reflective types.

For EnerGuide: No effect for the interior options, because it relates to occupant behavior.

Cardinal orientation of the window.

Each direction has specific solar radiation values applied to its windows.

For F280: Affects solar correction factors and the L-factor in cooling load calculations. Different orientations have different solar radiation intensity values.

For EnerGuide: Impacts the score, usually by offsetting the need for mechanical heating. Converted to HOT2000 direction codes for solar gain calculations. Exported as FacingDirection.

entity: Entity

Material composition of the window (glass, frame, etc.).

Used to determine thermal properties (R-value) and also modifies SHGC for window heat loss calculations.

For F280: Core parameter for conductive heat loss calculations

For EnerGuide: Is used to calculated the R-Value and SHGC of the exact window size, because the entity data is coming from a standard size. Exported to HOT2000 as the window construction type with its R-value properties for heat loss/gain calculations.

height: number

Height of the window in meters.

Used with width to calculate window area for heat loss, solar gain, and total_window_area calculations.

For F280: Used to calculate window area for heat loss and solar gain calculations.

For EnerGuide: Is used for adjusting SHGC and R-value from the test data. Exported to HOT2000 as height attribute in window dimensions.

overhang_height: number

Height from top of window to overhang in meters.

Used with overhang_width to calculate shading effects for solar gain reduction.

For F280 and EnerGuide: Determines effectiveness of the overhang shading. Smaller heights increase shading effectiveness.

overhang_width: number

Width of any overhang above the window in meters.

Used in solar gain calculations to determine shading effects that reduce solar heat gain.

For F280: Affects solar gain by providing shade. Wider overhangs reduce cooling loads by blocking direct sun, especially for south-facing windows.

For EnerGuide: As overhangWidth attribute, affecting solar gain calculations with shading.

shgc_entity: Entity

Solar heat gain coefficient properties for the window.

Used for calculating solar gain through windows based on orientation and SHGC value.

For F280: Critical for cooling load calculations. The SHGC determines how much solar radiation enters through the window and becomes heat.

For EnerGuide: Is used to calculated the SHGC of the exact window size, because the entity data is coming from a standard size. Exported to HOT2000 as the SHGC attribute in window elements, affecting solar gain in both heating and cooling seasons.

tilt: number

Tilt angle of the window from horizontal in degrees. Usually it is 90 degrees.

Used to adjust solar gain calculations for non-vertical windows. Affects the effective solar radiation.

For F280: Impacts solar gain calculations. Non-vertical windows receive different solar radiation based on tilt angle, even though the standard does not explicitly define a calculation method for them.

For EnerGuide: Affects solar gain calcs. Exported to HOT2000 as tilt attribute.

type: "Picture" | "Hinged" | "Slider"

Operational type of the window.

Used to categorize windows for calculation of the opaque window area, reporting, and may affect air leakage assumptions.

width: number

Width of the window in meters.

Used with height to calculate window area for heat loss, solar gain, and total_window_area calculations.

For F280: Used to calculate window area for heat loss and solar gain calculations.

For EnerGuide: Is used for adjusting SHGC and R-value from the test data. Exported to HOT2000 as height attribute in window dimensions.