Building energy simulation (BES) has become increasingly applied to assess building performance under climate changes and yield a more sustainable and resilient design (Yassaghi and Hoque 2019). Multiple morphing-based weather-file modification tools have been developed to integrate climate change predictions (Troup 2016). Most of the widely adopted weather generators, including CCWorldWeatherGen (Jentsch, Bahaj, and James 2008), Meteonorm (Remund et al. 2020), and WeatherShift (Dickinson and Brannon 2016), use GCM (Global Climate Models) data from the CMIP (Coupled Model Intercomparison Project) that covers worldwide locations.
Currently, the CMIP project is in its sixth phase (CMIP6) (Eyring et al. 2016), which has developed new emission scenarios that have a similar range as its fifth phase (CMIP5) but fill critical gaps for intermediate forcing levels (O’Neill et al. 2016). It will be used in the Sixth IPCC (Intergovernmental Panel on Climate Change) Climate Assessments Reports (IPCC 2021). However, existing tools based on the previous CMIP were unable to utilize the data from the latest climate change research. Currently, there are no tools available that could process user-defined climate simulations in an automated way and allow further statistical analysis.
The epwshiftr package bridges these gaps. It is a free, open-source R package for adapting a whole-building energy simulation EnergyPlus (Crawley et al. 2001) Weather (EPW) files to incorporate climate change predictions using the morphing statistical downscaling method (Belcher, Hacker, and Powell 2005). The primary goal is to automatically process large amounts of climate change prediction outputs from the CMIP6 (CMIP Phase 6) GCMs and create future climate data for BES across worldwide locations in a user-friendly and flexible way.
Epwshiftr is capable of processing multiple GCM outputs at various spatial and temporal resolutions. Additionally, the package is designed in a modular manner for flexibility and extensibility. There are five modules in total, and the table below lists their corresponding names and functionalities.
Module name | Description |
---|---|
Query module | Query and store metadata of online CMIP6 GCM outputs via the ESGF (Earth System Grid Federation) Search RESTful API. Meta includes the name of GCM, the institution that developed the GCM, emission scenarios, output interval, nominal resolution, output variable, output unit, etc. |
Database module | Create and manage a local database of GCM outputs using NetCDF files downloaded in the ESGF portal. |
Data Extraction Module | Extract climate variable data of desired temporal domain and specified grid distances to the input baseline EPW file |
Morphing Module | Calculate future weather data under the latest CMIP6 emission scenarios using the morphing method |
EPW Generation Module | Create future EPW files using various data aggregation strategies using the eplusr package (Jia and Chong 2021) |
Each module stores climate data in a consistent Tidy (Wickham 2014) data format, allowing exploring a considerably broad pool of ready-to-use methods available in R for customized statistical analysis. Computational-intensive processes have been designed to run in parallel for speed-up.
The epwshiftr is distributed via CRAN (The Comprehensive R Archive Network). The source code is available on GitHub at https://github.com/ideas-lab-nus/epwshiftr and released under the MIT license.
This research was funded by the Republic of Singapore’s National Research Foundation through a grant to the Berkeley Education Alliance for Research in Singapore (BEARS) for the Singapore-Berkeley Building Efficiency and Sustainability in the Tropics (SinBerBEST) Program. BEARS has been established by the University of California, Berkeley as a center for intellectual excellence in research and education in Singapore.