r4bes.md

title	author	date	site	output	documentclass	bibliography	csl	link-citations	always_allow_html	description
R for Building Energy Simulation	Adrian Chong Hongyuan Jia	2022-12-20	bookdown::bookdown_site	bookdown::bs4_book	book	book.bib packages.bib	elsevier-with-titles.csl	true	true	A guide to the building energy simulation with R.

Preface {.unnumbered}

Placeholder

Introduction {.unnumbered}

Structure of this book {.unnumbered}

Prerequisites {.unnumbered}

R and RStudio {.unnumbered}

R Packages {.unnumbered}

EnergyPlus {.unnumbered}

Conventions {.unnumbered}

Before you begin {.unnumbered}

R Project {.unnumbered}

Scripting {.unnumbered}

Example files {.unnumbered}

Project structure {.unnumbered}

Style guide {.unnumbered}

(PART) R Basics {.unnumbered}

Introduction {#r-basics}

This part of the book is intended to provide a sufficient introduction to R to get you started on the subsequent parts of this book. For a more comprehensive treatment on the subject, I would recommend R for Data Science by Hadley Wickham & Garrett Grolemund [@wickham_r_2016]. The R Graphics Cookbook by Winston Chang [@chang_r_2018] is also a useful reference that provides recipes that allows you to quickly generate plots in R using the {ggplot2} package.

Basics

Placeholder

Prerequisites

Basic operators

Basic data types

Basic data structures

Tibbles {#tibbles}

data.table {#data-table}

Dates and Times {#datetime}

Placeholder

Prerequisites

Parsing dates and times

Extracting components

Importing Data

Placeholder

Prerequisites

Finding your file

Parsing a csv file

Building data

Regular expressions {#regex}

Placeholder

Prerequisites

Basic matches

Character classes {#regex-classes}

Escaping {#regex-escape}

Anchors

Quantifies

Functions

Placeholder

Prerequisites

User-defined function

Examples

Manipulating Data {#manipulate}

Placeholder

Prerequisites

Data transformation

select() {#select}

filter()

arrange()

mutate()

summarise() and group_by()

across()

Pipes

(PART) Get Started {.unnumbered}

Introduction {#get-started}

The goal of this part of the book is to get you started working with EnergyPlus in R as quickly as possible. In this part of the book, you will learn how to get your model into R and run the simulation (Chapter @ref(parse)). You will then learn how to extract predifined annual summary reports and manipulate them so that the focus is placed on the important variables and observations (Chapter @ref(summary)). Finally, we provide a gentle introduction to visualizing the data from the summary reports in R (Chapter @ref(visualize)).

Understanding the details of EnergyPlus inputs and outputs and how they are structured are an important part of building energy simulation. We will come back to that in the next part of the book once we have gotten you started up with the basics.

Parse then simulate {#parse}

Placeholder

Prerequisites

Key EnergyPlus files

Parsing the model

Simulating the model

Summary reports {#summary}

Placeholder

Prerequisites

Output summary reports

Visualize {#visualize}

Placeholder

Prerequisites

Colors

ggplot()

Functions and Components

Visualize end use

Visualize weather data

Saving Plots

(PART) Inputs and Outputs {.unnumbered}

Introduction {#input-output}

In this part of the book, you will learn EnergyPlus's input data structure (Chapter @ref(input)), and how to programmatically query and modify them in R (Chapter @ref(modify)). We will also point you to the corresponding EnergyPlus reference documentation that will help you gain a better understanding of the inner workings of EnergyPlus. Understanding the inputs to a model is important as the proverb "garbage in, garbage out" clearly spells out. You can have the best data science workflows but your simulation results would only be as good the quality of your model and it's inputs.

Subsequently, you will learn how to extract the more detailed output files (Chapter @ref(output). You will work with time-series simulation results and explore them using R's data transformation and data visualization capabilities (Chapter @ref(explore)).

Model Input Structure {#input}

Placeholder

Prerequisites

EnergyPlus Documentation

EnergyPlus input structure

Class vs Object

Model Query

Idf class methods

$ operator

Object interdependencies

Modify model inputs {#modify}

Placeholder

Prerequisites

Extract and Modify

Single object

Multiple objects

Create new objects

add

duplicate

Detailed output {#output}

Placeholder

Prerequisites

Variable dictionary reports

mtd file

Model Exploration {#explore}

Placeholder

Prerequisites

Extracting

Energy signature

(PART) Program {.unnumbered}

Introduction {#program}

Energy Efficient Measures

Parametric simulations

(PART) Advanced {.unnumbered}

Introduction {#advanced}

Design optimization

Sensitivity analysis

Placeholder

Prerequisites

Model calibration

(PART) Reproduce {.unnumbered}

Introduction {#reproduce}

Prerequisites

In this chapter we will introduce concepts of reproducibility.

R Markdown

Containers