R/walls.R

In paulnorthrop/walls: Statistical Inference for the Thermophysical Properties of Walls from In-Situ Surveys

#' walls: Statistical Inference for the Thermophysical Properties of Walls from
#'        In-Situ Surveys
#'
#' Performs frequentist and Bayesian inferences for the parameters of
#' the lumped-thermal-mass models described in Gori (2017).
#'
#' @details Add details.
#' @references Gori, V. (2017) A novel method for the estimation of
#'   thermophysical properties of walls from short and seasonally
#'   independent in-situ surveys. Doctoral thesis. UCL (University
#'   College London).
#' @docType package
#' @name walls
#' @import methods
#' @import nlme
#' @import stats
NULL

#' Cwall east-facing
#'
#' Cwall east-facing
#'
#' @format A dataframe with 39168 rows and 8 columns.
#'   \itemize{
#'     \item{Column 1, \code{Time}: }{in format DD/MM/YYY HH:MM.}
#'     \item{Column 2, \code{Q_out}: }{heat flux density into the
#'       external surface, in watts per metre squared.}
#'     \item{Column 3, \code{TS_ext}: }{temperature of the external surface
#'       of the wall, in degrees C.}
#'     \item{Column 4, \code{TA_ext}: }{temperature of the air close to the
#'       external surface of the wall, in degrees C.}
#'     \item{Column 5, \code{Q_in}: }{heat flux density entering the
#'       internal surface, in watts per metre squared.}
#'     \item{Column 6, \code{TS_int}: }{temperature of the internal surface
#'       of the wall, in degrees C.}
#'     \item{Column 7, \code{TA_int}: }{temperature of the air close to the
#'       internal surface of the wall, in degrees C.}
#'     \item{Column 8, \code{Q_sun}: }{Incoming solar radiation, in watts
#'       per metre squared. .}
#'  }
#'  \strong{Note: In the modelling equations in Gori (2017) the variable Qout
#'    is the heat flux \emph{out of} the external surface of the wall.
#'    Therefore the \code{Q_out} values in column 2 need to be negated before
#'    using these equations.}
#' @source Gori, V., Biddulph, P., Elwell, C. A. (2018) Long-term in-situ
#'   measurement on an east-facing filled cavity wall in a residential
#'   building in the UK. [Dataset]. UCL Energy Institute: London, UK.
#'   \url{http://discovery.ucl.ac.uk/10045865/}
#' @references Gori, V., Biddulph, P. and Elwell, C. A. 2018. A Bayesian Dynamic
#'  Method to Estimate the Thermophysical Properties of Building Elements in
#'  All Seasons, Orientations and with Reduced Error. \emph{Energies},
#'  \strong{11(4)}, 802.
#'  \url{https://doi.org/10.3390/en11040802}
#' @references Gori, V. (2017) A novel method for the estimation of
#'   thermophysical properties of walls from short and seasonally
#'   independent in-situ surveys. Doctoral thesis. UCL (University
#'   College London).
#'   \url{http://discovery.ucl.ac.uk/1568418/}
"cwall_east"

#' Cwall north-facing
#'
#' Long-term in-situ measurements of heat flux and temperature on a filled
#' cavity wall in a residential building in the UK, between 14:00 on
#' 12/03/2015 and 13:55 on 30/08/2015 inclusive.
#'
#' @format A dataframe with 49248 rows and 5 columns.
#'   \itemize{
#'     \item{Column 1, \code{Time}: }{in format DD/MM/YYY HH:MM.
#'       The time step is 5 minutes.}
#'     \item{Column 2, \code{Q_out}: }{heat flux density into the
#'       external surface, in watts per metre squared.}
#'     \item{Column 3, \code{T_out}: }{temperature of the external surface
#'       of the wall, in degrees C.}
#'     \item{Column 4, \code{Q_in}: }{heat flux density entering the
#'       internal surface, in watts per metre squared.}
#'     \item{Column 5, \code{T_in}: }{temperature of the internal surface
#'       of the wall, in degrees C.}
#'  }
#'  \strong{Note: In the modelling equations in Gori (2017) the variable Qout
#'    is the heat flux \emph{out of} the external surface of the wall.
#'    Therefore the \code{Q_out} values in column 2 need to be negated before
#'    using these equations.}
#'
#'  There are three pairs of times for which the data are missing:
#'   \itemize{
#'     \item{Rows 1487 and 1488: }{17/03/2015, 17:50 and 17:55}
#'     \item{Rows 14369 and 14370: }{01/05/2015, 11:20 and 11:25}
#'     \item{Rows 41798 and 41799: }{04/08/2015, 17:05 and 17:10}
#'   }
#' @source Gori, V, Elwell, C. A. (2018) Long-term in-situ measurement of
#'   heat flux and temperature on a filled cavity wall in a residential
#'   building in the UK. [Dataset]. UCL Energy Institute: London, UK.
#'   \url{http://discovery.ucl.ac.uk/10041900/}
#' @references Gori, V., Biddulph, P. and Elwell, C. A. 2018. A Bayesian Dynamic
#'  Method to Estimate the Thermophysical Properties of Building Elements in
#'  All Seasons, Orientations and with Reduced Error. \emph{Energies},
#'  \strong{11(4)}, 802.
#'  \url{https://doi.org/10.3390/en11040802}
#' @references Gori, V., Biddulph, P. and Elwell, C. A. 2018.
#' Estimation of thermophysical properties from in-situ measurements in
#' all seasons: Quantifying and reducing errors using dynamic grey-box
#' methods, \emph{Energy and Buildings}, \strong{167}, 290-300.
#' \url{https://doi.org/10.1016/j.enbuild.2018.02.048}.
#' @references Gori, V. (2017) A novel method for the estimation of
#'   thermophysical properties of walls from short and seasonally
#'   independent in-situ surveys. Doctoral thesis. UCL (University
#'   College London).
#'   \url{http://discovery.ucl.ac.uk/1568418/}
"cwall_north"