Studio Matrx Monthly · Volume 1 · Issue 4 · September 2026
Amogh N P
 In loving memory of Amogh N P — Architect · Designer · Visionary 
Weather Files & TMYLesson 2.1
Climate Analytics & Future-Weather Resilience/Module 2 · Climate & Weather Data

Lesson 2.1 · Climate & Weather Data

Weather Files & TMY

Almost every energy calculation and comfort check begins with a weather file - a synthetic year of hourly weather stitched from decades of the past - so knowing exactly what is inside it, and the stable-climate assumption baked into its bones, is the first real skill of climate analytics

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

Before a single wall is drawn, the simulation asks one question: what is the weather? The answer arrives as a file of 8,760 numbers - and every one of them is history.

When an engineer checks whether a building will overheat, or how much energy it will burn keeping cool, the calculation needs to know the weather the building lives in - hour by hour, all year. That knowledge arrives as a weather file: a plain data set of roughly 8,760 rows, one for each hour of a year, each row recording the temperature, the humidity, how much sun is falling, how hard the wind blows, and a handful of other numbers. Feed that file into a simulation and it can march through a whole year of the building's life, hour by hour, working out when it is comfortable and when it is not. The weather file is, quietly, the single most important input in the whole exercise: change it and every result changes.

So it is worth knowing exactly what a weather file is, where its numbers come from, and - crucially - what assumption is baked into it. The most common kind is a typical meteorological year, or TMY: not a record of any real year that actually happened, but a synthetic composite, assembled by taking the most 'typical' January from perhaps thirty years of records, the most typical February from those same years, and so on, then stitching the twelve chosen months into one representative year. It is a clever, useful construction - and it looks toward the *past*, because there is no other data to build it from. That is the quiet catch this lesson exposes: a weather file describes a climate assembled from decades of history, and it carries a hidden assumption that the climate is stable enough for that history to still describe the present. In a warming world that assumption is failing, and the file you trust is quietly out of date.

A weather file = ~8,760 hourly rows (temp + humidity + solar + wind). The standard TMY is a synthetic 'typical' year stitched from the past - smoothed of extremes + backward-looking. It assumes a stable climate. That assumption has broken.

What a weather file actually contains

Open a weather file and, past the header, you find a long table: roughly 8,760 rows, one per hour of the year, each carrying a set of numbers that together describe the weather at that moment. A few of these columns do most of the work in building analysis. The dry-bulb temperature is the ordinary air temperature a thermometer reads - the headline number, and the one that most directly drives heating and cooling. Beside it sits a measure of moisture: the dew-point temperature or the relative humidity, telling you how much water vapour the air holds. Humidity matters enormously and is easy to underrate - it governs how muggy a space feels, how well sweat and evaporation can cool a body, and how hard a cooling system must work to dry the air, not just chill it.

The next block describes the sun. A weather file usually splits solar radiation into components - the global horizontal (total falling on a flat surface), the direct beam (straight from the sun's disc), and the diffuse (scattered by sky and cloud) - each in watts per square metre. These numbers let a simulation work out how much heat pours through each window and wall depending on orientation and time of day, and how much daylight a room receives. Then comes the wind: its speed and the direction it blows from, which drive natural ventilation, infiltration through gaps, and convective heat loss from the building's skin. Around these headline fields sit others - atmospheric pressure, cloud cover, sometimes rainfall, sky temperature, ground temperature and illuminance.

What matters is the shape of the thing: a weather file is not a single 'climate' number but an hour-by-hour story of a year, rich enough that a simulation can replay the year and feel every swing - the cool of a dawn, the blaze of a June afternoon, the humid stillness before a monsoon burst. That richness is exactly why the file is so powerful and so consequential: it is the entire weather world the virtual building will ever experience. Get the file right and the analysis has a fighting chance of being meaningful; get it wrong, or out of date, and every careful calculation downstream inherits the error. Which raises the obvious question - where do these thousands of numbers come from?

One weather file = 8,760 hourly rows (one per hour of a year) Each row is a snapshot of the weather for that hour at that location MONTH DAY HOUR | DRY-BULB C DEW-POINT C RH % | GLOBAL DIRECT DIFFUSE | WIND m/s DIR 6 21 14 | 34.2 21.6 48 | 780 610 170 | 3.4 220 6 21 15 | 35.1 21.9 45 | 690 520 170 | 3.9 235 6 21 16 | 35.4 22.1 45 | 540 360 180 | 4.1 240 TEMPERATURE & MOISTURE SOLAR RADIATION (W/m2) WIND how hot, how humid drives comfort & cooling how much sun drives heat gain & light how the air moves drives ventilation cooling
Zoom
One weather file is roughly 8,760 hourly rows. Each row records temperature and humidity (how hot and how muggy), solar radiation (how much sun) and wind (how the air moves) - the whole weather world the virtual building will experience.

A weather file = ~8,760 hourly rows. Each row: dry-bulb temp + humidity (how hot, how muggy) + solar (how much sun) + wind (how the air moves). It is the whole weather world the virtual building lives in.

The typical meteorological year - a synthetic composite of the past

The thousands of numbers in a weather file are not invented, and they are not a forecast; they are drawn from real measurements. But here a subtlety appears. You might expect a design weather file to be simply 'a real recorded year' - say, 2019 at this airport. The trouble is that any single real year is an accident: it might have had a freak heatwave, a strangely wet spring, an unusually mild winter. Design to one odd year and you design to that year's quirks. So the profession invented the typical meteorological year (TMY) - a way to distil many years of records into one representative, 'typical' year.

The method, in outline, is this. Take a long run of historical data at a station - commonly twenty to thirty years. For each calendar month, compare that month across all the years and pick the single real month whose weather is statistically closest to the long-term average for that month - the most 'typical' January, the most representative July, and so on, judged across temperature, humidity, solar and wind together. Then stitch the twelve chosen months - each a real month from a possibly different year - into one synthetic year, smoothing the joins so the transitions are seamless. The result is a composite: a year that never actually happened, assembled from twelve real months that did, chosen to represent the ordinary, expected conditions at that place.

This is genuinely clever and genuinely useful. A TMY strips out the flukes of any one year and gives a stable, reproducible baseline that everyone can design and compare against - which is exactly why energy codes and simulation tools lean on it. But notice two things that will matter for the rest of this course. First, a TMY is deliberately typical, so by construction it plays down extremes - the very heatwaves that increasingly threaten buildings are smoothed away in favour of the average. Second, and more fundamental, a TMY can only be built from data that already exists, which means it looks entirely backward, into the past. It is a beautifully engineered rear-view mirror. In a stable climate that is fine. In a warming one, as we will see, it quietly describes a world that is slipping away.

Building a TMY: pick the most "typical" real month from ~20-30 years HISTORICAL RECORD (each cell = one real month at this station) Year Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 1998 [ ] [ ] [ ] [x] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] 2001 [ ] [x] [ ] [ ] [ ] [ ] [ ] [ ] [x] [ ] [ ] [ ] 2005 [x] [ ] [ ] [ ] [x] [ ] [ ] [ ] [ ] [ ] [ ] [x] 2010 [ ] [ ] [x] [ ] [ ] [x] [ ] [x] [ ] [ ] [x] [ ] 2016 [ ] [ ] [ ] [ ] [ ] [ ] [x] [ ] [ ] [x] [ ] [ ] [x] = the month chosen as most representative for that slot TMY = Jan05 + Feb01 + Mar10 + Apr98 + May05 + Jun10 + ... stitched into ONE synthetic year It is a composite of real months - typical, not any single year that ever happened.
Zoom
A typical meteorological year is stitched together by choosing the single most representative real month for each calendar slot from twenty to thirty years of records - a synthetic 'typical' year that never actually happened, and one built entirely from the past.

TMY = pick the most 'typical' real Jan from 30 yrs, most typical Feb, ... stitch 12 real months into ONE synthetic year. Strips out flukes - but also smooths away extremes, and only uses PAST data.

EPW files and the weather-data ecosystem

In practice, all of this arrives in a file format, and the one you will meet most often is the EPW - the EnergyPlus Weather file, a plain-text format that has become a common currency across simulation tools worldwide. An EPW opens as a readable table: eight header lines naming the location, its latitude and longitude, elevation, time zone and the source and period of the data, followed by the 8,760 hourly rows carrying the fields we met earlier. Because it is an open, documented, text-based format, almost every serious building-energy and comfort tool can read it, and large public libraries of EPW files exist for thousands of locations around the world, free to download.

It helps to know the vocabulary around these files, because 'weather file' is a family, not a single thing. A TMY file (and its regional cousins, assembled by national meteorological or energy agencies) is the typical-year composite we just described - the default for standard design and code work. Sitting beside it you may find files labelled for extreme or hot years, built to represent an unusually severe year rather than a typical one, used to stress-test a design; and the future weather files that later modules explore, which take a historical file and adjust it to reflect a projected future climate. Some files also carry design-day summaries - concise statistical extremes (a very hot summer condition, a very cold winter one) used for sizing equipment rather than running a full-year simulation.

Two practical honesties belong here. First, the header is not decoration: it tells you *which station*, over *which years*, the file was built from - and a file assembled from 1991 to 2010 is already describing a decades-old climate the moment you open it. Always read the provenance before trusting the numbers. Second, coverage is deeply uneven: rich, well-instrumented regions have dense, high-quality files, while much of the global south - India very much included - is served by sparser stations and older or interpolated data, a gap the next lesson takes up directly. The competent designer treats a weather file not as a fact handed down from on high but as a dated, sourced, constructed data product - to be identified, questioned and, where the stakes are high, checked against local knowledge and specialists rather than accepted on faith.

One weather file = 8,760 hourly rows (one per hour of a year) Each row is a snapshot of the weather for that hour at that location MONTH DAY HOUR | DRY-BULB C DEW-POINT C RH % | GLOBAL DIRECT DIFFUSE | WIND m/s DIR 6 21 14 | 34.2 21.6 48 | 780 610 170 | 3.4 220 6 21 15 | 35.1 21.9 45 | 690 520 170 | 3.9 235 6 21 16 | 35.4 22.1 45 | 540 360 180 | 4.1 240 TEMPERATURE & MOISTURE SOLAR RADIATION (W/m2) WIND how hot, how humid drives comfort & cooling how much sun drives heat gain & light how the air moves drives ventilation cooling
Zoom
One weather file is roughly 8,760 hourly rows. Each row records temperature and humidity (how hot and how muggy), solar radiation (how much sun) and wind (how the air moves) - the whole weather world the virtual building will experience.

The stationarity assumption baked into the file

Now to the assumption that makes this whole lesson matter, and that shadows the rest of the course. Every historical weather file - every TMY - rests on a quiet premise called stationarity: the idea that the statistics of the climate are stable over time, so that a synthesis of the recent past is a fair description of the present and near future. Build a typical year from 1991 to 2020 and use it to design a building opening in the late 2020s, and you are assuming, without usually saying so, that the climate of the 2020s and beyond is close enough to the climate of that thirty-year window. For most of the history of building science, that assumption was reasonable - the climate wandered within a fairly stable range, so yesterday's typical weather was a fair guide to tomorrow's.

That assumption has now broken, and this is the hinge of climate analytics. The climate is warming rapidly and unevenly: average temperatures are rising, heatwaves are growing more frequent, more intense and longer, humidity and rainfall patterns are shifting, and once-rare extremes are becoming ordinary. A weather file assembled from the last few decades therefore describes a climate that is already receding into the past - it systematically understates the heat, and especially the extremes, that even today's buildings face, and it drifts further from reality every year. Because a TMY is built to be *typical*, it doubly understates the danger: it smooths away extremes and anchors to a cooler past at the same time. A cooling system sized to a TMY may be too small for the heatwaves that now actually arrive; a naturally ventilated home judged comfortable by the old file may already spend dangerous hours overheating.

So the first real skill of climate analytics is not running a tool but reading a weather file with clear eyes: knowing it is a constructed, backward-looking composite that assumes a stability the world no longer has. This does not make weather files useless - they remain the essential foundation of building analysis, and every future method builds on them. It means using them honestly: knowing their provenance and their age, treating the typical year as a smoothed and dated picture rather than the truth of the climate the building will face, and understanding that any binding energy, comfort or sizing result must rest on verified data, validated tools and qualified engineers working to the governing codes - not on a file whose central assumption has quietly failed. The rest of the course is, in a sense, the disciplined response to this single realisation.

Building a TMY: pick the most "typical" real month from ~20-30 years HISTORICAL RECORD (each cell = one real month at this station) Year Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 1998 [ ] [ ] [ ] [x] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] 2001 [ ] [x] [ ] [ ] [ ] [ ] [ ] [ ] [x] [ ] [ ] [ ] 2005 [x] [ ] [ ] [ ] [x] [ ] [ ] [ ] [ ] [ ] [ ] [x] 2010 [ ] [ ] [x] [ ] [ ] [x] [ ] [x] [ ] [ ] [x] [ ] 2016 [ ] [ ] [ ] [ ] [ ] [ ] [x] [ ] [ ] [x] [ ] [ ] [x] = the month chosen as most representative for that slot TMY = Jan05 + Feb01 + Mar10 + Apr98 + May05 + Jun10 + ... stitched into ONE synthetic year It is a composite of real months - typical, not any single year that ever happened.
Zoom
A typical meteorological year is stitched together by choosing the single most representative real month for each calendar slot from twenty to thirty years of records - a synthetic 'typical' year that never actually happened, and one built entirely from the past.

Stationarity = the assumption that climate statistics are stable, so a synthesis of the recent past describes the near future. This assumption has BROKEN in a warming world - so the TMY describes a climate that is already receding.

Verify-this: read the weather file critically before you trust a single result

Read the header first

Provenance of any weather file

The header names the station, coordinates, source and the years the file was built from. A file assembled from 1991-2010 already describes a decades-old climate. Never trust the rows without reading the provenance. Modules 2.2, 2.4.

TMY is typical by design

What a typical meteorological year is

A TMY is a synthetic composite of the most representative real months across ~20-30 years - it deliberately smooths away extremes, so it understates the heatwaves buildings must survive. Use extreme-year or future files to stress-test. Modules 2.1, 3.3.

Stationarity has broken

The assumption inside every historical file

Historical files assume a stable climate; warming has broken that assumption, so a TMY describes a climate already receding and understates today's heat. Design forward, not backward. Modules 2.1, 3.1.

Binding results defer to specialists

Energy, comfort and equipment sizing

Any binding energy, comfort or sizing determination belongs to qualified building-physics and energy engineers with verified, current data, validated tools and the codes (NBC India, ECBC, IS) - not to a dated typical year taken on faith. Modules 2.4, 8.4.

Hands-on workshop

Workshop — open a weather file and interrogate it

The fastest way to demystify a weather file is to open a real one and read it as the constructed, dated data product it is. In this workshop you download a public EPW for a city you know and interrogate its header and its numbers - no simulation yet, just critical reading.

A free public EPW file and a text editor or spreadsheet. No simulation software - this workshop is about reading the file critically. The binding energy, comfort and sizing results always stay with qualified engineers, validated tools, verified current data and the codes.

Given & goal
Goal: read a real weather file with clear, critical eyes
Inputs: a public EPW file for a familiar city + a text editor or spreadsheet + this lesson
Time: ~45 minutes
  1. 1Get the file: download a free EPW for a city you know from a public library, and open it in a text editor or spreadsheet so you can see the header lines and the rows beneath them.
  2. 2Read the provenance: from the header, note the station name and location, and - crucially - the source and the range of YEARS the file was built from. Write down how old the underlying climate is.
  3. 3Find the fields: in the hourly rows, locate the dry-bulb temperature, a humidity field, the solar columns and the wind columns. Scroll to a summer afternoon and a winter dawn and read those values - feel the year swing.
  4. 4Test the 'typical': skim the hottest hours in the file and ask whether they match the worst heat you know the city has actually suffered recently. Note where the typical year looks milder than the real extremes.
  5. 5Write a one-paragraph verdict: what this file is (a typical composite from which years), what it captures well, where it likely understates the heat the building will face, and what you would need verified, current data and a qualified engineer to check before trusting any binding result.

You’ll walk away with
A one-page annotated read of a real weather file: its station and vintage, the fields it carries, where its typical year understates real extremes, and a note on what must be verified by specialists - framed as critical reading, not a result.

The worked example

Three altitudes on the same idea

Read the band that fits you — or all three.

For the architectDesigning buildings that stay comfortable, safe and efficient in the climate they will actually face

The weather file is the single most consequential input in the analysis of your building - so treat it as a design decision, not a default you never look at. Know what is inside it: hourly dry-bulb temperature, humidity, split solar radiation and wind, roughly 8,760 rows describing the whole weather world your virtual building will live in. Know that the usual TMY is a synthetic, typical composite stitched from decades of past records - which means it both smooths away the extremes your building must survive and anchors to a cooler past under a stationarity assumption that no longer holds. Always read the file header: which station, which years, how old. A neighbouring airport file from 1991-2010 is not your site in the late 2020s. Use weather files as the essential foundation they are, but treat any binding energy, comfort or equipment-sizing result as belonging to qualified building-physics and energy engineers working with verified, current data and the governing codes (NBC India, ECBC, IS) - never to a dated typical year taken on faith.

For the interior designerKeeping people comfortable and safe indoors as the climate warms - overheating, cooling, materials

You may never open a weather file yourself, but the comfort of every interior you design is judged against one - so it pays to know what it does and does not capture. The file records hourly temperature, humidity, sun and wind for a location; humidity in particular, so easy to overlook, decides whether a room feels fresh or oppressive and how much a space can be cooled by air movement rather than machinery. Understand that the standard typical year is a smoothed, backward-looking average that plays down heatwaves - so a room that reads as comfortable against the file may still overheat in the real, hotter extremes people increasingly live through. When overheating, glare or muggy discomfort is the concern, ask which weather file the assessment used and how current it is, and coordinate any binding comfort or cooling determination with the building-physics and services specialists and verified data - your craft is the resilient, comfortable interior for the warmer conditions people will actually feel.

For the studentHow climate data, future-weather projections and simulation guide design - and the honest uncertainty

Learn to open a weather file and read it, because it is the raw material of the whole field. Inside are roughly 8,760 hourly rows, each with dry-bulb temperature, a humidity measure, solar radiation (global, direct, diffuse) and wind - the EPW format you will meet again and again. Learn how a typical meteorological year is built: take twenty to thirty years of records, pick the most representative real month for each slot, and stitch twelve of them into one synthetic 'typical' year that never actually happened. Then grasp the two catches that make this course necessary - a TMY is deliberately typical, so it smooths away the very extremes that endanger buildings, and it can only be built from the past, resting on a stationarity assumption that a warming climate has broken. You are not expected to build weather files; you are expected to read one critically - to know its provenance, its age and its hidden assumption - and to understand that the binding results belong to qualified engineers, verified data and the codes.

Misconception check

A weather file is just the real, measured weather for a place - solid, factual data - so if my simulation uses the proper weather file for the city, the weather side of the analysis is basically accurate and I do not need to worry about it.

Two things are quietly wrong here. First, the standard design weather file is usually NOT a real recorded year at all - it is a typical meteorological year, a synthetic composite stitched together from the most 'typical' individual months drawn across twenty or thirty years of records, chosen to represent ordinary, average conditions. That construction is useful, because it strips out the flukes of any single odd year, but it has a deliberate side effect: it smooths away extremes, so the very heatwaves that increasingly threaten buildings are averaged out of the file. A design that looks comfortable against a typical year can still overheat badly in the real extremes. Second, and more fundamental, a weather file can only ever be built from data that already exists - it is entirely backward-looking - and it carries a hidden assumption called stationarity: that the climate is stable enough for a synthesis of the recent past to describe the present and near future. In a warming climate that assumption has broken. A file assembled from, say, 1991-2010 describes a climate that has already receded; it systematically understates the heat and the extremes that even today's buildings face, and drifts further from reality every year the building stands. So a weather file is not simply 'accurate measured weather' - it is a dated, constructed, typical-by-design, backward-looking data product resting on an assumption the world no longer honours. Read its header for the station and the years, treat the typical year as a smoothed and ageing picture rather than the truth of the climate your building will face, and keep every binding energy, comfort and sizing result with qualified engineers, validated tools, verified current data and the governing codes.
Try it

Do it yourself

No tools needed — reason it through.

  1. 1What are the main fields in a weather file, and what does each one drive in a building (temperature, humidity, solar, wind)?
  2. 2How is a typical meteorological year built from historical records, and why is it a synthetic year rather than a real one?
  3. 3Why does a TMY, being 'typical' by design, understate the extremes that increasingly threaten buildings?
  4. 4What is the stationarity assumption, and why has a warming climate broken it?
  5. 5Why should you always read a weather file's header before trusting its numbers?
Take this with you

The one line to carry out

A weather file is the whole weather world a simulation gives a building - roughly 8,760 hourly rows of temperature, humidity, solar and wind - and the standard one, the typical meteorological year, is a synthetic composite stitched from the most representative real months across decades of the past, so it is both deliberately smoothed of extremes and entirely backward-looking, resting on a stationarity assumption that a warming climate has broken; read its header for the station and years, treat the typical year as a dated, constructed picture rather than the truth of the climate the building will face, and keep every binding energy, comfort and sizing result with qualified engineers, verified current data, validated tools and the governing codes.
Take it further
References & further reading

Peer-reviewed journals & authoritative standards

  1. 01Typical meteorological yearWikipedia — Typical meteorological year, 2026.
  2. 02Building performance simulationWikipedia — Building performance simulation, 2026.
  3. 03Solar irradianceWikipedia — Solar irradiance, 2026.
  4. 04Relative humidityWikipedia — Relative humidity, 2026.
Related lessons
Recap
A weather file is the essential input to building energy and comfort analysis: roughly 8,760 hourly rows, one per hour of a year, each carrying the dry-bulb temperature, a humidity measure, solar radiation split into global, direct and diffuse, and wind speed and direction - a rich, hour-by-hour story of a year that a simulation can replay. The most common kind is a typical meteorological year (TMY): not a real recorded year but a synthetic composite, built by taking twenty to thirty years of station records, choosing the single most representative real month for each calendar slot, and stitching twelve such months into one 'typical' year. These usually arrive as EPW files - an open, documented, text-based format - with a header giving the station, coordinates and, crucially, the years the file was built from. The TMY is genuinely useful because it strips out the flukes of any single odd year and gives a stable, comparable baseline, which is why codes and tools rely on it. But two things matter. First, a TMY is typical by design, so it smooths away the extremes - the heatwaves - that most threaten buildings. Second, and more fundamental, it can only be built from data that already exists, so it looks entirely backward and rests on a stationarity assumption: that the climate is stable enough for a synthesis of the recent past to describe the near future. A warming climate has broken that assumption, so a historical file describes a climate already receding and systematically understates the heat buildings face, drifting further from reality every year. The first real skill of climate analytics is therefore reading a weather file critically - knowing its provenance, its vintage and its hidden assumption - and keeping every binding energy, comfort and sizing result with qualified engineers, verified current data, validated tools and the governing codes.
Carry forward →

A weather file is only as good as the measurements behind it - so the next question is where those numbers actually come from. Next we open up the sources of climate data: weather stations, reanalysis, satellite, and the gaps between them.

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 →