read_epw() parses an EPW file and returns an Epw object. The parsing process is extremely inspired by [EnergyPlus/WeatherManager.cc] with some simplifications. For more details on Epw, please see Epw class.

read_epw(path, warning = FALSE)

Arguments

path

A path of an EnergyPlus EPW file.

warning

If TRUE, warnings are given if any missing data, out of range data and redundant data is found. Default: FALSE. All these data can be also retrieved using methods in Epw class.

Value

An Epw object.

See also

Epw class

Examples

# \dontrun{ # read an EPW file from EnergyPlus v8.8 installation folder if (is_avail_eplus(8.8)) { path_epw <- file.path( eplus_config(8.8)$dir, "WeatherData", "USA_CA_San.Francisco.Intl.AP.724940_TMY3.epw" ) read_epw(path_epw) }
#> ══ EnergyPlus Weather File ═════════════════════════════════════════════════════ #> [Location ]: San Francisco Intl Ap, CA, USA #> {N 37°37'}, {W 122°24'}, {UTC-08:00} #> [Elevation]: 2m above see level #> [Data Src ]: TMY3 #> [WMO Stat ]: 724940 #> [Leap Year]: FALSE #> [Interval ]: 60 mins #> #> ── Data Periods ──────────────────────────────────────────────────────────────── #> Name StartDayOfWeek StartDay EndDay #> 1: Data Sunday 1/ 1 12/31 #> #> ────────────────────────────────────────────────────────────────────────────────
# read an EPW file from EnergyPlus website path_base <- "https://energyplus.net/weather-download" path_region <- "north_and_central_america_wmo_region_4/USA/CA" path_file <- "USA_CA_San.Francisco.Intl.AP.724940_TMY3/USA_CA_San.Francisco.Intl.AP.724940_TMY3.epw" path_epw <- file.path(path_base, path_region, path_file) read_epw(path_epw)
#> ══ EnergyPlus Weather File ═════════════════════════════════════════════════════ #> [Location ]: San Francisco Intl Ap, CA, USA #> {N 37°37'}, {W 122°24'}, {UTC-08:00} #> [Elevation]: 2m above see level #> [Data Src ]: TMY3 #> [WMO Stat ]: 724940 #> [Leap Year]: FALSE #> [Interval ]: 60 mins #> #> ── Data Periods ──────────────────────────────────────────────────────────────── #> Name StartDayOfWeek StartDay EndDay #> 1: Data Sunday 1/ 1 12/31 #> #> ────────────────────────────────────────────────────────────────────────────────
# }