O que é o formato de ficheiro EPW?
Um arquivo .epw é um conjunto de dados meteorológicos horários em texto simples usado por softwares de simulação de energia em edifícios e iluminação natural. O formato foi introduzido por volta de 2001 junto com o primeiro lançamento do EnergyPlus - o principal motor de simulação de edifícios do Departamento de Energia dos EUA, desenvolvido e mantido pelo National Renewable Energy Laboratory (NREL).
Cada arquivo cobre um ano inteiro de observações meteorológicas horárias ou dados climáticos modelados, estruturados como oito registros de cabeçalho nomeados seguidos por 8.760 linhas de dados separadas por vírgulas. Os registros de cabeçalho são:
LOCATION- nome do local, coordenadas, altitude, fuso horárioDESIGN CONDITIONS- valores de projeto para pico de aquecimento e resfriamentoTYPICAL/EXTREME PERIODS- semanas estatisticamente representativasGROUND TEMPERATURES- temperaturas mensais do solo em várias profundidadesHOLIDAYS/DAYLIGHT SAVINGS- exceções de calendário e horário de verãoCOMMENTS 1/COMMENTS 2- notas sobre a fonte e procedênciaDATA PERIODS- declaração do intervalo e período de datas
Cada linha horária contém temperatura de bulbo seco, ponto de orvalho, umidade relativa, pressão atmosférica, radiação solar global/direta/difusa, direção do vento, velocidade do vento, cobertura do céu e vários parâmetros adicionais. Valores ausentes ou incertos são sinalizados com códigos sentinela (99.9, 999 ou 9999, dependendo das unidades do campo) em vez de células vazias. O arquivo não possui magic bytes binários - a identificação depende da primeira linha começando com LOCATION,.
Além do próprio EnergyPlus, os arquivos .epw são consumidos pelo OpenStudio, DesignBuilder, IES VE, fluxos de trabalho baseados em Radiance e os plug-ins Ladybug/Honeybee para Grasshopper. Conjuntos de dados gratuitos para milhares de locais globais são publicados em energyplus.net/weather e climate.onebuilding.org. O arquivo complementar .stat fornece estatísticas mensais e anuais derivadas para o mesmo local, enquanto os arquivos .ddy contêm os dados de dia de projeto associados para cálculos de carga de pico.
Segurança e proteção
RISCO: LOWArquivos EPW são dados meteorológicos em texto simples sem conteúdo executável, portanto, são seguros para abrir. A única precaução prática é usar o arquivo correto para o local/cenário correto - um EPW para o local errado ou um conjunto de dados desatualizado fornece resultados de simulação enganosos. Baixe arquivos de fontes oficiais (energyplus.net/weather, climate.onebuilding.org) para garantir a qualidade dos dados.
Detalhes do formato
em resumoProgramas que abrem arquivos EPW
Detalhes técnicos
especificação profunda| Estrutura do arquivo | Oito registros de cabeçalho nomeados seguidos por 8.760 linhas de dados horários separadas por vírgulas (ou 8.784 em um ano bissexto) |
| Codificação | Texto simples ASCII / UTF-8; nenhuma assinatura binária ou marca de ordem de byte (BOM) necessária |
| Identificador de primeira linha | A primeira linha sempre começa com LOCATION, seguida pelos metadados do local - usado para detecção de formato em vez de magic bytes |
| Intervalo de dados | Um registro por hora; um ano completo não bissexto produz exatamente 8.760 linhas |
| Tamanho típico do arquivo | 1,5 MB - 2,5 MB para um conjunto de dados anual completo |
| Sentinelas de valores ausentes | Códigos de preenchimento específicos por campo substituem leituras ausentes: 99.9 para temperaturas, 999 para parâmetros de vento, 9999 para valores de radiação |
| Campos de radiação solar | Irradiância horizontal global, irradiância normal direta e irradiância horizontal difusa, cada uma em Wh/m² por hora |
| Campos meteorológicos por linha | Inclui temperatura de bulbo seco, ponto de orvalho, umidade relativa, pressão barométrica, velocidade do vento, direção do vento, cobertura total do céu, cobertura opaca do céu, altura do teto e visibilidade |
| Seções de cabeçalho | LOCATION, DESIGN CONDITIONS, TYPICAL/EXTREME PERIODS, GROUND TEMPERATURES, HOLIDAYS/DAYLIGHT SAVINGS, COMMENTS 1, COMMENTS 2, DATA PERIODS |
| Tipo MIME | text/plain; algumas ferramentas também reconhecem text/csv |
| Formatos complementares | .stat (resumos estatísticos mensais e anuais para o mesmo local) e .ddy (dados de dia de projeto para dimensionamento de carga de pico) |
| Desenvolvedor | U.S. Department of Energy, National Renewable Energy Laboratory (NREL) |
| Suporte ao ecossistema | EnergyPlus, OpenStudio, DesignBuilder, IES VE, fluxos de trabalho baseados em Radiance e Ladybug/Honeybee para Grasshopper e Dynamo |
| Fontes de dados | Derivado de TMY (Typical Meteorological Year), IWEC (International Weather for Energy Calculations), CWEC (Canadian Weather for Energy Calculations) e arquivos de estações medidas |
| Metadados geográficos | O cabeçalho LOCATION armazena latitude, longitude, altitude em metros, fuso horário UTC e identificador de estação WMO/ASHRAE |
| Distribuição de arquivos | O arquivo .epw em si não é compactado; downloads em massa de energyplus.net são empacotados como arquivos ZIP |
| Lançado | Around 2001 (with the first EnergyPlus releases) |
| Versão mais recente | EPW format as documented in the EnergyPlus Auxiliary Programs guide (stable; tracks EnergyPlus, v25.x in 2025) |
| Padrão aberto | Sim · livre de royalties |
| Especificação | bigladdersoftware.com |
Conversões de EPW
Perguntas e Respostas da Comunidade
perguntado por usuáriosAinda não há perguntas - seja o primeiro a perguntar sobre arquivos EPW.