get_change_point_temperature: Estimate the optimal change point temperature and weather...

View source: R/transformation.R

get_change_point_temperatureR Documentation

Estimate the optimal change point temperature and weather dependance

Description

Calculate change point temperature by modeling temperature vs consumption relationship using a multi-step weather dependency signature model. Multi-step weather dependency signature model is based in best fitting penalised regression model analysis. Regression quality analysis is used to identify wether proposed model properly describes the weather vs consumption relationship. Model coefficients analysis is used is used to identify type and amount of weather dependency.

Usage

get_change_point_temperature(
  consumptionData,
  weatherData,
  consumptionFeature,
  temperatureFeature,
  consumptionGroupFeature = NULL,
  localTimeZone,
  plot = F
)

Arguments

consumptionData

<data.frame> containing consumption time series. The time zone of the datetimes must be UTC.

weatherData

<data.frame> containing temperature time series. The time zone of the datetimes must be UTC.

consumptionFeature

<string> with the name of consumption column.

temperatureFeature

<string> with the name of temperature column.

consumptionGroupFeature

<string> with the name of column in consumptionData that describes the grouping feature used. By default, no group is

localTimeZone

<string> specifying the local time zone related to the building in analysis. The format of this time zones are defined by the IANA Time Zone Database (https://www.iana.org/time-zones). This argument is optional, by default no transformation to local time zone is done.

plot

<boolean> Plot change point model describing load vs temperature relationship in order to identify breakpoints

Value

Changepoint analysis results attributes <struct> - group. Group unique identifier - tbalh. Change point temperature in heating season - tbalh. Change point temperature in cooling season - heating. Heating dependency detected - cooling. Cooling dependency detected


biggproject/biggr documentation built on Oct. 2, 2024, 11:13 p.m.