An open API service indexing awesome lists of open source software.

https://github.com/hongyuanjia/eplusrintro

Interfacing EnergyPlus Using R -- Intro to 'eplusr' Package
https://github.com/hongyuanjia/eplusrintro

energyplus eplusr r

Last synced: 3 months ago
JSON representation

Interfacing EnergyPlus Using R -- Intro to 'eplusr' Package

Awesome Lists containing this project

README

        

This is the repo of materials for *"Interfacing EnergyPlus using R"* workshop. Slides are available online via: https://hongyuanjia.github.io/eplusrIntro.

## Description

This is a half-day hands on workshop on
[eplusr](https://hongyuanjia.github.io/eplusr). You will learn how to read,
parse, modify EnergyPlus IDF and EPW files, conduct parametric simulations and
collect results directly in R.

This workshop assumes that you already have basic knowledge of R
and [EnergyPlus](https://www.energyplus.net).

## Software Requirements

1. A recent version of R (>=v3.2) is required, which is available for free at
[cran.r-project.org](http://www.cran.r-project.org)
2. A recent version of RStudio IDE is recommended, available for free at
[www.rstudio.com/download](http://www.rstudio.com/download), or use your own
flavored R IDE.
3. The current latest stable version of eplusr, which can be install via:
```r
install.packages("eplusr")
```
4. In the workshop, EnergyPlus v8.8 is used. It is suggested to install
EnergyPlus before the workshop since downloading it during the workshop may
take time. You can do this using eplusr:
```r
# On Windows, this requires R running with administrative privileges on Windows.
# On OSX and Linux, admin authorization is automatically prompted
eplusr::install_eplus(8.8)

# OR download the installer and then follow instructions on https://energyplus.net/downloads
eplusr::download_eplus(8.8, dir = "directory_to_save")
```
5. In the workshop, `tidyverse` package is also needed for data analysis. You can install it via:
```r
install.packages("tidyverse")
```
6. Clone this repo to your computer. You can do this by clicking the `Clone or download` button above.

## License

Creative Commons License

*Interfacing EnergyPlus using R* by Hongyuan Jia is licensed under a Creative Commons Attribution 4.0 International License.