Studio Matrx Monthly · Volume 1 · Issue 3 · August 2026
Amogh N P
 In loving memory of Amogh N P — Architect · Designer · Visionary 
Weather Data & EPW FilesLesson 1.2
BPS for Architecture, Planning & Urban Design/Module 1 · Climate & Weather Data

Lesson 1.2 · Climate & Weather Data

Weather Data & EPW Files

The 8,760-hour file that drives every energy, comfort and daylight result

13 min Interactive lessonFree · open lessonByAmogh N P· Architect & interior designer
The hook

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.

ONE EPW = 8760 HOURLY ROWS each row: dry-bulb, RH, direct+diffuse solar, wind speed/dir, ... Dry-bulb temp Relative humidity Global solar Wind speed JANJUNDEC Change this file and every energy, comfort and daylight number changes with it.
Zoom
An EPW weather file visualised as four of its hourly tracks over a year - dry-bulb temperature, relative humidity, global solar radiation and wind speed. In reality each of the 8,760 rows carries dozens of columns; change this one file and every downstream result changes with it.

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: A STITCHED TYPICAL YEAR 2009201220152018 Pick the most typical JAN, FEB, ... from different real years TYPICAL METEOROLOGICAL YEAR (one 8760-hour file) Typical, not extreme: a TMY averages out the freak heatwave you may still need to size for.
Zoom
How a Typical Meteorological Year is built: an algorithm scans many real years and splices the single most statistically typical January, February and so on into one representative 8,760-hour file. The result models the normal climate well - and, by design, averages away the extremes.

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.

Weather-data terms & sources

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.

Hands-on workshop

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.

Given & goal
Goal: download, inspect and sanity-check a weather file
Inputs: a browser, a text editor or spreadsheet (Ladybug optional)
Time: ~30 minutes
  1. 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.).
  2. 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.
  3. 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.
  4. 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.
  5. 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.

The worked example

Three altitudes on the same idea

Read the band that fits you — or all three.

For the architectPerformance-driven design decisions

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.

For the interior designerComfort, daylight & healthy interiors

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.

For the studentSkills, portfolio & green-building jobs

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.

Misconception check

A TMY weather file tells me the worst conditions my building must survive.

It does the opposite. A Typical Meteorological Year is stitched from the most statistically typical months across many years, precisely so it represents the long-run normal climate - which means it deliberately smooths away heatwaves, cold snaps and freak humid spells. Those extremes are exactly what size a cooling system or cause a comfort failure, and a TMY underweights them. Use a TMY to estimate typical annual performance; use a separate extreme, design or hot-real-year file when the question is 'can it cope with the worst?'. Reporting a peak load off a TMY, or assuming it bounds the worst case, is a classic and costly error. Always match the weather file to the question you are asking.
Try it

Do it yourself

Check your understanding of the weather file.

  1. 1How many data rows does an EPW hold, and what does each represent?
  2. 2Name four quantities stored in every hourly row of an EPW.
  3. 3What is a TMY, and why does it deliberately exclude extreme conditions?
  4. 4Why might two EPW files both labelled with the same city disagree?
  5. 5What is 'representativeness', and why can an airport weather station mislead a city-centre design?
Take this with you

The one line to carry out

An EPW is 8,760 hourly rows of temperature, humidity, sun and wind that every simulation reads first - so choosing a representative, recent file, and naming it, is half of doing the study honestly. A typical year models the normal; extremes need a different file.
Take it further
References & further reading

Peer-reviewed journals & authoritative standards

  1. 01EnergyPlus Weather Data (EPW files)US Department of Energy, 2026.
  2. 02EnergyPlus - Whole-building energy simulation engineUS Department of Energy, 2026.
  3. 03Ladybug Tools - Environmental analysis for GrasshopperLadybug Tools LLC, 2026.
  4. 04Climate ConsultantUCLA Energy Design Tools, 2026.
Related lessons
Recap
The EPW weather file is the single most important simulation input: 8,760 hourly rows of dry-bulb temperature, humidity, three solar components, wind and more. Most are Typical Meteorological Years, stitched from many years' most typical months - great for average performance, poor for extremes. Files come from the free EnergyPlus collection in several vintages, so name the one you use, compare designs against the same file, and always question how well the station represents your actual site.
Carry forward →

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.

A

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 →