X-Git-Url: https://git.auder.net/?a=blobdiff_plain;f=pkg%2FR%2FForecast.R;h=a0ddcda8070e647047802985bd5b2792a3b6814f;hb=72b9c50162bcdcf6c99fbb8b2ec6ea9ba98379cb;hp=274f50eb7896511eca82cbbed8f7fdbae5c10575;hpb=1e20780ee1505fac6c7ed68d340892c497524561;p=talweg.git diff --git a/pkg/R/Forecast.R b/pkg/R/Forecast.R index 274f50e..a0ddcda 100644 --- a/pkg/R/Forecast.R +++ b/pkg/R/Forecast.R @@ -1,59 +1,74 @@ -#' @title Forecast +#' Forecast #' -#' @description Forecast encapsulation +#' Forecast encapsulation #' -#' @field pred List with -#' \itemize{ +#' @docType class +#' @importFrom R6 R6Class +#' +#' @field .pred List with \itemize{ #' \item serie: forecasted serie #' \item params: corresponding list of parameters (weights, neighbors...) -#' \item index: corresponding index in data object +#' \item index_in_data: corresponding index in data object} +#' @field .dates vector of day indices where forcast occurs +#' +#' @section Methods: +#' \describe{ +#' \item{\code{initialize(dates)}}{ +#' Initialize a Forecast object with a series of date indices.} +#' \item{\code{getSize()}}{ +#' Return number of individual forecasts.} +#' \item{\code{append(forecast, params, index_in_data)}}{ +#' Acquire an individual forecast, with its (optimized) parameters and the +#' corresponding index in the dataset.} +#' \item{\code{getDates()}}{ +#' Get dates where forecast occurs.} +#' \item{\code{getForecast(index)}}{ +#' Get forecasted serie at specified index.} +#' \item{\code{getParams(index)}}{ +#' Get parameters at specified index (for 'Neighbors' method).} +#' \item{\code{getIndexInData(index)}}{ +#' Get index in data which corresponds to current forecast.} #' } #' -#' @exportClass Forecast -#' @export Forecast -Forecast = setRefClass( - Class = "Forecast", - - fields = list( - pred = "list" +Forecast = R6::R6Class("Forecast", + private = list( + .pred = list(), + .dates = integer(0) #store dates as integers (from 1970-01-01) ), - - methods = list( - initialize = function(...) + public = list( + initialize = function(dates) { - "Initialize empty Forecast object" - - callSuper(...) + private$.dates <- dates + invisible(self) }, getSize = function() + length(private$.pred) + , + append = function(forecast, params, index_in_data) { - "Number of individual forecasts" - - length(pred) - }, - append = function(new_serie, new_params, new_index) - { - "Obtain a new pair (serie, params)" - - pred[[length(pred)+1]] <<- list("serie"=new_serie, "params"=new_params, "index"=new_index) + private$.pred[[length(private$.pred)+1]] <- + list("forecast"=forecast, "params"=params, "index_in_data"=index_in_data) }, - getSerie = function(index) + getDates = function() + as.Date( private$.dates, origin="1970-01-01" ) + , + getForecast = function(index) { - "Serie values at specified index" - - pred[[index]]$serie + if (is(index,"Date")) + index = match(index, private$.dates) + private$.pred[[index]]$forecast }, getParams = function(index) { - "Params at specified index" - - pred[[index]]$params + if (is(index,"Date")) + index = match(index, private$.dates) + private$.pred[[index]]$params }, getIndexInData = function(index) { - "(day) Index in data where prediction took place" - - pred[[index]]$index + if (is(index,"Date")) + index = match(index, private$.dates) + private$.pred[[index]]$index_in_data } ) )