Interface ConstructedEntity

Represents a constructed material, assembly, or equipment entity. Contains properties for thermal performance, cost, and composition.

interface ConstructedEntity {
    caption?: string;
    carbon?: number;
    components: any[];
    ef?: number;
    efficiency?: number;
    fuel?: FuelTypes;
    id: string;
    insulation_rsi?: number;
    labour?: number;
    location?: string;
    materials?: number;
    name: string;
    r?: number;
    shgc?: number;
    substance?: string;
    sw_origin?: string;
    type: string;
    [key: string]: unknown;
}

Indexable

  • [key: string]: unknown

    Additional properties allowed for flexibility.

    Enables custom properties for specific entity types. Used for specialized calculations or information.

Properties

caption?: string

Optional descriptive text.

Additional information about the entity. Used for UI display and documentation.

Due to the naming constraints, there is no guarantee that the name can be given as-is to HOT2000 export.

carbon?: number

Embodied carbon in kg CO2e per item unit.

Environmental impact measure for manufacturing the entity. Used in environmental impact assessments.

components: any[]

Components and sub-components that make up this entity. Such as the studs in a wall.

For composite entities, contains the individual elements. Used for detailed modeling and cost breakdowns.

ef?: number

Energy Factor for equipment entities. From 0 to 1.

Efficiency metric for DHW equipment. Used in energy consumption calculations.

efficiency?: number

General efficiency value (percentage).

Performance metric for mechanical systems. Used in energy consumption calculations.

fuel?: FuelTypes

Fuel type used by equipment entities.

Energy source for mechanical systems. Used to determine energy type, costs, and emissions.

id: string

Unique identifier of the Entity

insulation_rsi?: number

Insulation R-value in metric units (m²·K/W).

For Entities such as a slab, the insulation r_value can be defined separately.

labour?: number

Labour cost in dollars per item unit.

Cost of installation labour for this entity. Used in construction/renovation cost calculations.

location?: string

Geographic information about availability.

Indicates where this entity is applicable or available. Used for region-specific filtering.

materials?: number

Material cost in dollars per item unit.

Cost of materials for this entity. Used in construction/renovation cost calculations.

name: string

Display name of the entity.

Used for identification in the UI and the material database. This may not be human readable. Refer to "caption" and "nick" for that purpose.

Usually it is the "breed" of the entity and the "id" concatenated snake case.

r?: number

R-value. Note that it is in METRIC units (m²·K/W).

Thermal resistance for opaque assemblies or fenestration. Used in heat loss calculations and for code compliance.

shgc?: number

Solar Heat Gain Coefficient.

Fraction of solar radiation transmitted through fenestration. Used in solar gain calculations for windows and skylights.

substance?: string

Classification identifier for the entity.

Categorizes the entity for filtering and organization. Used in UI presentation and entity selection logic.

sw_origin?: string

The origin of the Entity, this is a legacy value from StepWin and helps update older Entities but it is advisable to always define it. If you are making your own, use "generated".

type: string

Classification of the entity.

Indicates what kind of building component or equipment the entity represents. Used for filtering and appropriate property application.