Wat is het EPW-bestandsformaat?
Een .epw-bestand is een tekstgebaseerde uurlijkse weerset die wordt gebruikt door software voor gebouwenergie- en daglichtsimulatie. Het formaat werd rond 2001 geïntroduceerd samen met de eerste EnergyPlus-release - de belangrijkste simulatie-engine voor gebouwen van het Amerikaanse Ministerie van Energie, ontwikkeld en onderhouden door het National Renewable Energy Laboratory (NREL).
Elk bestand beslaat één volledig jaar aan uurlijkse weerobservaties of gemodelleerde klimaatgegevens, gestructureerd als acht benoemde header-records gevolgd door 8.760 door komma's gescheiden gegevensrijen. De header-records zijn:
LOCATION- sitenaam, coördinaten, hoogte, tijdzoneDESIGN CONDITIONS- ontwerpwaarden voor piekverwarming en -koelingTYPICAL/EXTREME PERIODS- statistisch representatieve wekenGROUND TEMPERATURES- maandelijkse bodemtemperaturen op verschillende dieptesHOLIDAYS/DAYLIGHT SAVINGS- kalenderuitzonderingenCOMMENTS 1/COMMENTS 2- bron- en herkomstnotitiesDATA PERIODS- datumbereik en intervalverklaring
Elke uurlijkse rij bevat de drogeboltemperatuur, het dauwpunt, de relatieve vochtigheid, de atmosferische druk, globale/directe/diffuse zonnestraling, windrichting, windsnelheid, bewolkingsgraad en diverse aanvullende parameters. Ontbrekende of onzekere waarden worden gemarkeerd met sentinel-codes (99.9, 999 of 9999 afhankelijk van de eenheden) in plaats van lege cellen. Het bestand heeft geen binaire magic bytes - identificatie is gebaseerd op de eerste regel die begint met LOCATION,.
Naast EnergyPlus zelf worden .epw-bestanden gebruikt door OpenStudio, DesignBuilder, IES VE, op Radiance gebaseerde workflows en de Ladybug/Honeybee Grasshopper-plug-ins. Gratis datasets voor duizenden wereldwijde locaties worden gepubliceerd op energyplus.net/weather en climate.onebuilding.org. Het bijbehorende .stat-bestand biedt afgeleide maandelijkse en jaarlijkse statistieken voor dezelfde locatie, terwijl .ddy-bestanden de bijbehorende ontwerpdaggegevens bevatten voor piekbelastingsberekeningen.
Beveiliging & veiligheid
RISICO: LOWEPW-bestanden zijn weergegevens in platte tekst zonder uitvoerbare inhoud, dus ze zijn veilig om te openen. De enige praktische waarschuwing is het gebruik van het juiste bestand voor de juiste locatie/scenario - een EPW voor de verkeerde locatie of een verouderde dataset geeft misleidende simulatieresultaten. Download bestanden van officiële bronnen (energyplus.net/weather, climate.onebuilding.org) om de gegevenskwaliteit te waarborgen.
Formaatdetails
in een notendopProgramma's die EPW-bestanden openen
Technische details
diepe specificaties| Bestandsstructuur | Acht benoemde header-records gevolgd door 8.760 door komma's gescheiden uurlijkse gegevensrijen (of 8.784 in een schrikkeljaar) |
| Codering | ASCII / UTF-8 platte tekst; geen binaire handtekening of byte-order mark vereist |
| Eerste-regel-identificatie | De eerste regel begint altijd met LOCATION, gevolgd door metadata van de site - gebruikt voor formaatdetectie in plaats van magic bytes |
| Gegevensinterval | Eén record per uur; een volledig niet-schrikkeljaar levert precies 8.760 rijen op |
| Typische bestandsgrootte | 1,5 MB - 2,5 MB voor een complete jaarlijkse dataset |
| Sentinel-waarden voor ontbrekende gegevens | Veldspecifieke tijdelijke codes vervangen ontbrekende metingen: 99.9 voor temperaturen, 999 voor windparameters, 9999 voor stralingswaarden |
| Zonnestralingsvelden | Globale horizontale instraling, directe normale instraling en diffuse horizontale instraling, elk in Wh/m² per uur |
| Meteorologische velden per rij | Inclusief drogeboltemperatuur, dauwpunt, relatieve vochtigheid, barometrische druk, windsnelheid, windrichting, totale bewolking, ondoorzichtige bewolking, wolkenbasis-hoogte en zichtbaarheid |
| Header-secties | LOCATION, DESIGN CONDITIONS, TYPICAL/EXTREME PERIODS, GROUND TEMPERATURES, HOLIDAYS/DAYLIGHT SAVINGS, COMMENTS 1, COMMENTS 2, DATA PERIODS |
| MIME-type | text/plain; sommige tools herkennen ook text/csv |
| Bijbehorende formaten | .stat (maandelijkse en jaarlijkse statistische samenvattingen voor dezelfde locatie) en .ddy (ontwerpdaggegevens voor dimensionering van piekbelasting) |
| Ontwikkelaar | U.S. Department of Energy, National Renewable Energy Laboratory (NREL) |
| Ecosysteem-ondersteuning | EnergyPlus, OpenStudio, DesignBuilder, IES VE, op Radiance gebaseerde workflows en Ladybug/Honeybee voor Grasshopper en Dynamo |
| Gegevensbronnen | Afgeleid van TMY (Typical Meteorological Year), IWEC (International Weather for Energy Calculations), CWEC (Canadian Weather for Energy Calculations) en gemeten stationsarchieven |
| Geografische metadata | De LOCATION-header slaat breedtegraad, lengtegraad, hoogte in meters, UTC-tijdzoneverschuiving en WMO/ASHRAE-stationidentificatie op |
| Bestandsdistributie | Het .epw-bestand zelf is ongecomprimeerd; bulkdownloads van energyplus.net zijn verpakt als ZIP-archieven |
| Uitgebracht | Around 2001 (with the first EnergyPlus releases) |
| Laatste versie | EPW format as documented in the EnergyPlus Auxiliary Programs guide (stable; tracks EnergyPlus, v25.x in 2025) |
| Open standaard | Ja · royaltyvrij |
| Specificatie | bigladdersoftware.com |
EPW conversies
Community V&A
gevraagd door gebruikersNog geen vragen - wees de eerste om iets te vragen over EPW-bestanden.