Deconstruct EPW


This user object component takes an Energy Plus Weather (.epw) file path input and deconstructs the tabulated data into lists corresponding to the sample dates. These lists are grouped into branches according to their data types to reduce the complexity of the outputs. The breakdown and descriptions are taken from,, specifically pages (32 – 43). This component was originally developed to find the average turbidity values for a specific region for use in Maxwell Renderings.


Deconstruct EPW

epwInFile PathItemFilepath to an .epw format file
IInIntegersListAn optional integer input which specifies the line where tabulated data begins

A list containing the

  • City
  • State or Province
  • Country Code
  • Source
  • WMO
  • Latitude
  • Longitude
  • Time Zone
  • Elevation

A datatree where each branch contains the parameters for a sample point, list items contain

  • Year
  • Month
  • Day
  • Hour
  • Minute
UncertaintyOutStringTreeA datatree where each branch corresponds to the date based sample point and contains the Uncertainty Flags

The remaining outputs all contain datatree’s where each branch corresponds to the date based sample point, list items contain data about

  • Dry Bulb Temperature
  • Dew Point Temperature
  • Relative Humidity
  • Atmospheric Station Pressure
  • Extraterrestrial Horizontal Radiation
  • Extraterrestrial Direct Normal Radiation
  • Horizontal Infrared Radiation Intensity
  • Global Horizontal Radiation
  • Direct Normal Radiation
  • Diffuse Horizontal Radiation
  • Horizontal Illuminance
  • Direct Normal Illuminance
  • Diffuse Horizontal Illuminance
  • Zenith Luminance
  • Wind Direction
  • Wind Speed
  • Total Sky Cover
  • Opaque Sky Cover
  • Visibility
  • Ceiling Height
  • Present Weather Observation
  • Present Weather Codes
PrecipitationOutDouble Tree
  • Precipitable Water
  • Aerosol Optical Depth
  • Snow Depth
  • Days Since Last Snowfall


Minimum Requirements

PlatformRhino 5, Grasshopper
VersionGrasshopper 0.9.0075
TypeC# Component