The infrared.city energy model gives the heating and cooling need of a building: the heat that an ideal system must add or remove to keep the rooms comfortable. It gives the need for each storey and for the whole building, for each month and for the year. It takes the real site into account: the neighbours, the trees, the ground and the sun on each facade.

When to use it
Use the model early in a design, to compare options. For example:
- Which facade gets the most sun, and does a green wall or a shade screen help?
- What do better windows or more insulation change, storey by storey?
- What happens to a building when a new neighbour is built, or an old one is removed?
The result is screening grade. It shows which option needs less heating and cooling, and by about how much. It is not an energy certificate and not a bill. It does not give a peak load or a room temperature. It has been compared with EnergyPlus and with standard test cases, not with metered buildings.
How it works
1. What goes in. The model reads the same 3D site as the other analyses of Infrared Core: the building, its neighbours and the wider context, trees, ground and terrain, and installations such as shade sails and PV panels. It also needs the location and one full year of hourly weather. A standard EPW weather file has all the values it needs.
2. Zones. The model splits each building into zones: one zone per storey by default, or a perimeter zone and a core zone, or the rooms that you send. A wall shared with a neighbour loses no heat.
3. Heat balance, every hour. For every hour of the year, the model adds up the heat that comes into each zone and the heat that goes out:
- In: sun on the windows and walls, light reflected from the ground and from other buildings, and the heat of people, lights and equipment.
- Out: heat that flows through walls, roof, floor and windows, heat that leaves with the air, and heat that goes to the cold sky at night.
- Shade: buildings, trees and installations block part of the sun. The model traces the sky and the sun for each window, wall and roof.
When the free heat is not enough to hold the heating set point, the zone needs heating. When there is more heat than the zone can lose, it needs cooling. The calculation follows the hourly method of ISO 13790, with one thermal mass per zone.
4. What comes out. Heating and cooling need in kWh, for each month and for the year, and per m² of floor, for each storey and for each building. The result also shows how much sun each zone gets and how much its surroundings shade it.
What you can set
Every value has a default, so a run needs only the site and the weather. These are the members of the request that you can change, with their defaults:
- Insulation of walls, roof, ground floor and doors:
energy-settings.u-values(ext-wall,flat-roof,ground-floor,door). Default 0.13, 0.25, 0.30 and 1.8 W/m²K. - Windows:
energy-settings.glazing(u-value,shgc,frame-fraction,frame-u-value,edge-psi). Default glass U 1.1 W/m²K, solar gain 0.6, frame 15 %. - Window share per facade direction:
zoning.wwr. - Facade and roof materials:
materialandroof-material, per building or inenergy-settings. - Thermal mass:
energy-settings.construction-class(default medium) orinternal-heat-capacity. - Air change and thermal bridges:
ach-natural,ach-infiltration,thermal-bridge-surcharge. Default 0.5 and 0.03 per hour, bridges by ISO 13790. - Set points:
occupancy.heating-setpointandcooling-setpoint. Default 21 °C and 26 °C, every hour. - Internal gains:
occupancy.people-gains,lighting-gains,equipment-gains. Default 1.6, 1.5 and 2.0 W/m². - Hours of use:
operation(mode, hours, days) andschedules(24 hourly values). - Zones:
zoning(storey-height,perimeter-depth), or your own rooms. Default one zone per storey.
A material changes how much sun a wall or a roof takes in and reflects. A green facade or a green roof also adds a small layer of insulation. A material does not change the U-value: set that in u-values. The defaults describe a well-insulated new building. For an older building, send its own U-values.
What it reacts to

We changed one real building in Vienna 13 times, one change at a time, and ran the model after each change. The building has 7 storeys and 4,864 m² of floor. Before the changes it needs 35 kWh/m² of heating and 8.6 kWh/m² of cooling per year. Each row keeps the changes before it, except row 10.
| Change | Heating | Cooling |
|---|---|---|
| 1. Street trees | +1.1 % | −4.2 % |
| 2. Grass instead of asphalt | −0.03 % | +0.23 % |
| 3. Shade sails | +0.02 % | −0.15 % |
| 4. Shade mesh on windows | +0.15 % | −0.94 % |
| 5. PV panels on the roof | +0.41 % | −2.6 % |
| 6. Green living wall | +5.5 % | −22.6 % |
| 7. Brighter walls opposite | −0.41 % | +3.6 % |
| 8. Brighter own walls | −0.34 % | +3.2 % |
| 9. Green roof | +0.29 % | −4.5 % |
| 10. Older insulation | +17.0 % | −9.2 % |
| 11. Better insulation | −4.4 % | +2.3 % |
| 12. Triple glazing | −7.9 % | +0.71 % |
| 13. A neighbour removed | −3.7 % | +20.3 % |
Row 10 has walls U 0.35 and roof U 0.40 W/m²K and is compared with row 9. Row 11 has walls U 0.10 and roof U 0.15 W/m²K. Row 12 has U 0.7 W/m²K and solar gain 0.50.




Shade lowers the cooling need and raises the heating need a little, because the building also loses free winter sun. Brighter walls nearby reflect more daylight into the windows, so cooling goes up. Insulation and glazing change both needs, in opposite directions. The ground counts as reflected sunlight, not as cooler air.
The full set, with every change shown on its own page: download the PDF ↗.
Validation and accuracy
We compare the model with EnergyPlus 26.1, the reference tool for building energy, and with the test cases of two standards.
- Totals. On the 3-storey reference building, with default inputs in both tools, in two climates (Denver and Dulles): heating is about 5 % from EnergyPlus and cooling about 3 %. A permanent test stops a release if a value moves more than ±10 % from EnergyPlus.
- Ranking of design options. Planners compare options, so the order matters more than one total. On 72 variants of one office room in three climates (orientation, window share, wall insulation and thermal mass), when two variants differ by more than 5 % in total need, the model puts them in the same order as EnergyPlus in 99.8 to 100 % of the pairs (rank correlation 0.993 to 0.998). The bench changes one room, not the building shape.
- Standard test cases. ASHRAE 140 (BESTEST): 22 of 22 values in the reference band (EnergyPlus: 19 of 22). EN 15265: 11 of 12 cases at level C. Both with the surface films that these standards prescribe.
Screening grade. Not validated against metered buildings. No peak load and no room temperature. Use it to compare options of one building, not to predict a bill.
The method card, the standards and the limits of the model are on the validation page.
Related
- Simulation Engine Basics: what goes into a simulation and how the weather file works
- Energy balance in the simulation library: what it computes, units and outputs
- Validation: how each model is tested, and against which reference
- Advanced thermal comfort: felt heat outdoors, on the same 3D site
- The client PDF ↗: the 13 changes, one page each