Lesson 1.2Lesson 1.2 · Climate & Weather Data
Weather Data & EPW Files
The 8,760-hour file that drives every energy, comfort and daylight result
Change the weather file and every number in your simulation changes with it. It is the most important input you will pick.
Ask a simulation engine to model your building and it will shrug until you hand it a weather file. That file - an EPW - is 8,760 rows, one per hour, of temperature, humidity, sun and wind. It is the reality your design is tested against.
Most designers pick it in three careless clicks and never think about it again. That is a mistake. The EPW is a citeable assumption, and choosing the right one - the right location, the right vintage, the right typical-versus-extreme - is half of doing an honest study.
The EPW is a citeable assumption. Name it. Compare on the same file.
The file every simulation reads first
An energy model, a comfort study, a daylight run - none of them know anything about the weather until you hand them a weather file, and in almost every tool that file is an EPW: EnergyPlus Weather format. It is a plain-text file with a short header (location, latitude, longitude, elevation, time zone) followed by 8,760 rows - one for every hour of a year. Each row carries the hour's dry-bulb temperature, dew point and relative humidity, atmospheric pressure, the three solar components (global horizontal, direct normal, diffuse horizontal irradiance), wind speed and direction, sky cover, and more - dozens of columns in all.
This is the single most important input in building performance simulation, and the most overlooked. The physics engine is just machinery; the EPW is the reality it runs against. Feed it the weather of Delhi and your Chennai design will look wrong for reasons that have nothing to do with the design. Every kWh, every comfort hour, every daylight lux the model reports is the EPW acting on your geometry and materials. That is why professionals say a simulation is only as good as its weather file.
It helps to picture what those columns actually drive. The dry-bulb temperature column sets the heat flowing through every wall and window and the load on any cooling system. The humidity columns decide latent loads and whether evaporative cooling can work at all. The three solar columns - direct, diffuse and global - feed both solar heat gain through glass and every daylight calculation, and they are why a west window matters more than a north one. The wind columns drive natural ventilation and infiltration. So the EPW is not background data; it is the direct, hour-by-hour cause of nearly everything the simulation reports. A designer who has actually opened one, scrolled its rows and seen these columns for real never again treats the weather file as a checkbox.
8,760 rows. The engine is machinery; the EPW is the world.
What TMY means - and what it deliberately leaves out
Most EPW files are a Typical Meteorological Year (TMY). This is not a single real year of data; it is a synthetic year stitched together from many years of records - the algorithm looks across (say) 15-30 years and picks the most statistically typical January from one year, the most typical February from another, and so on, then splices the twelve chosen months into one representative 8,760-hour file. The point is to represent the long-run normal climate rather than the quirks of any one year - if you simply grabbed the single most recent calendar year, you might land on a freak-hot or unusually mild one and bias every result, so the stitching deliberately averages that luck out.
That design choice has a consequence you must respect: a TMY smooths away extremes. The record-breaking heatwave, the freak cold snap, the once-in-a-decade still-and-humid week - these are exactly the conditions that size a cooling system or cause a comfort failure, and a typical year underweights them. So a TMY answers 'how will this building perform in an average year?' well, and 'will it cope with the worst day?' poorly. For that second question you use a different file - an extreme or design year, or a specific hot real year - and you will meet that idea again when sizing equipment. Match the file to the question.
TMY = typical, NOT worst-case. Size for extremes with a different file.
Where files come from - and why two 'Mumbai' files disagree
You do not make EPWs by hand; you download them. The EnergyPlus Weather (energyplus.net/weather) collection is the standard free source, with thousands of locations worldwide, and tools like Ladybug can fetch and map them for you. But there are several TMY families - TMY3, IWEC and IWEC2 (international), the newer TMYx built from recent hourly records - and they are derived from different periods and stations. So you can legitimately find two files both labelled 'Mumbai' that differ, because they summarise different years of data from possibly different weather stations.
This is not a defect to fear but a fact to manage. When you report a result, you name the weather file you used, just as you would cite a source. If you compare two designs, run both against the same file so the difference is the design, not the data. And prefer a recent-vintage file (TMYx) where you can, because a warming climate means a 1980s-2000 TMY may already understate today's cooling loads. The file is a citeable assumption; treat it like one. In practice, a good habit is to write the exact file name and vintage into the model's notes and into any report figure caption, so that a reader - or you, six months later - can reproduce the run and knows precisely which slice of climate history the numbers describe.
Representativeness: the weather station is not your site
An EPW describes conditions at a specific weather station - very often an airport, sitting on open, flat, windy ground far from any city. Your building may be on a dense street, beside a lake, up a hill, or deep in a heat-island city core that runs several degrees warmer than the airport at night. The gap between the station's climate and your site's actual micro-climate is a real source of error, and no amount of engine precision closes it if the input is off.
Good practice is to ask, every time: how representative is this file of my actual site? Sometimes you pick the nearest of several stations more carefully; sometimes you apply a morphing or urban-heat adjustment; sometimes you simply flag the limitation in your report. The deeper lesson connects straight back to Module 0: a simulation result is an estimate with error bars, and the weather file is one of the biggest bars. Choosing and naming it well is not admin - it is half of doing the study honestly. Get the EPW right and everything downstream has a chance; get it wrong and precision elsewhere is wasted.
Beyond the typical year: design, calibration and future files
The TMY is the workhorse, but it is not the only weather file you will meet, and knowing the family helps you match the file to the question. Design-day or extreme-year files weight the hot or cold extremes so equipment can be sized for conditions a typical year would never show - remembering, as Module 0 stressed, that the sizing calculation itself is an engineer's responsibility, not the modeller's. Actual meteorological year (AMY) files carry the real, un-smoothed weather of one specific past year, used when you calibrate a model against a building's measured bills: you must run the model on the same year the meter recorded, not a typical year, or the comparison is meaningless.
And increasingly there are morphed future weather files - a TMY adjusted by a climate-change scenario to represent, say, the 2050s or 2080s. These matter because a building designed today will operate for decades into a warming climate, and a facade or cooling strategy that just scrapes through on a 2000-vintage TMY can fail against a 2050 file. Running your design against both a current and a future file is fast, sobering, and quietly becoming best practice - it tests whether the design is robust or merely adequate for the climate we used to have. The through-line across all of these is the same discipline: the weather file encodes a specific question - typical performance, worst-case sizing, calibration, or future resilience - so you choose it deliberately and name it in the report. There is no single 'correct' weather file; there is only the file that matches what you are trying to learn, and the honesty to say which one you used.
EPW (EnergyPlus Weather)
The standard hourly weather file format, 8,760 rows
Read by EnergyPlus, Ladybug, Radiance and most tools; header plus one row per hour of the year.
TMY / TMY3 / TMYx
Typical Meteorological Year datasets
Synthetic 'typical' years; TMYx uses recent records, so it often reflects a warming climate better than older TMY3/IWEC.
EnergyPlus Weather collection
Free global library of EPW files (energyplus.net/weather)
The standard source; several vintages per city can differ, so name the exact file you used.
Design / extreme weather year
A file weighted to extremes for equipment sizing
Used where a TMY underestimates peak loads; sizing itself is an engineer's responsibility.
Workshop - open and interrogate a real EPW
You will download a weather file for a real city and look inside it, so an EPW stops being an abstraction and becomes something you can read, question and cite.
A browser and a text editor or spreadsheet. Optional: Ladybug Tools in Rhino/Grasshopper to visualise the file on a map and as charts.
Goal: download, inspect and sanity-check a weather file Inputs: a browser, a text editor or spreadsheet (Ladybug optional) Time: ~30 minutes
- 1Go to the EnergyPlus Weather site and download the EPW for your nearest city. Note the exact file name and its TMY vintage (TMY3, IWEC2, TMYx, etc.).
- 2Open it in a text editor. Read the first header line - location, latitude, longitude, elevation, time zone - then scroll to the data and confirm there are ~8,760 hourly rows. Identify the dry-bulb temperature and relative-humidity columns.
- 3Pull out a few sanity checks: roughly what is the hottest hourly temperature in the file, and the coldest? Do they match your climate read from lesson 1.1? If not, ask why.
- 4Find a second file for the same city (a different vintage, or the nearest alternative station) and compare the two headers and peak temperatures. Note how much they differ - this is why naming your file matters.
- 5Write two lines: which file you would use for this site and why, and one way its weather station may not represent your actual site (heat island, altitude, water body, exposure).
You’ll walk away with
A short note recording the EPW file you chose (name and vintage), its header facts, a peak-temperature sanity check against your climate read, and one honest caveat about how well it represents your site.
Three altitudes on the same idea
Read the band that fits you — or all three.
The weather file is the assumption behind every performance claim you will make about the building. If you tell a client the design cuts cooling energy by a third, that number lives or dies on the EPW behind it. Pick a representative, recent file, name it in your report, and compare options against the same file - so the story you tell is about the architecture, not the data.
The same room can feel very different under two weather files, because comfort responds to real hourly humidity and temperature - not averages. When a daylight or comfort study informs your glazing, shading or layout, know which EPW it used and whether it fits the actual site. A leafy courtyard or a heat-island street can shift the micro-climate well away from the airport the file describes.
Knowing what an EPW is - and being able to download, read and cite one - already puts you ahead of most graduates. Get an EPW for your studio site, open it in Ladybug or a text editor, and see the 8,760 rows for yourself. Reporting which weather file you used, and why, signals exactly the rigour that sustainability consultancies look for.
“A TMY weather file tells me the worst conditions my building must survive.”
Do it yourself
Check your understanding of the weather file.
- 1How many data rows does an EPW hold, and what does each represent?
- 2Name four quantities stored in every hourly row of an EPW.
- 3What is a TMY, and why does it deliberately exclude extreme conditions?
- 4Why might two EPW files both labelled with the same city disagree?
- 5What is 'representativeness', and why can an airport weather station mislead a city-centre design?
The one line to carry out
Peer-reviewed journals & authoritative standards
- 01EnergyPlus Weather Data (EPW files) — US Department of Energy, 2026.
- 02EnergyPlus - Whole-building energy simulation engine — US Department of Energy, 2026.
- 03Ladybug Tools - Environmental analysis for Grasshopper — Ladybug Tools LLC, 2026.
- 04Climate Consultant — UCLA Energy Design Tools, 2026.
The EPW carries the sun's raw numbers, but to place shading and orientation you need to see the sun move. Next we turn those solar columns into geometry - altitude, azimuth and the sun-path diagram.
The author
Amogh N P
Architect, interior designer, and creative polymath. Studio Matrx began in his notebooks — his vision of design made honest, useful, and open to everyone. Its Academy is written and taught in his memory, and free, forever.
More about Amogh →