RMOA (version 1.1.0)

trainMOA.MOA_regressor: Train a MOA regressor (e.g. a FIMTDD) on a datastream

Description

Train a MOA regressor (e.g. a FIMTDD) on a datastream

Usage

# S3 method for MOA_regressor
trainMOA(model, formula, data, subset,
  na.action = na.exclude, transFUN = identity, chunksize = 1000,
  reset = TRUE, trace = FALSE, options = list(maxruntime = +Inf), ...)

Value

An object of class MOA_trainedmodel which is a list with elements

• model: the updated supplied model object of class MOA_regressor

• call: the matched call

• na.action: the value of na.action

• terms: the terms in the model

• transFUN: the transFUN argument

Arguments

model

an object of class MOA_model, as returned by MOA_regressor, e.g. a FIMTDD

formula

a symbolic description of the model to be fit.

data

an object of class datastream set up e.g. with datastream_file, datastream_dataframe, datastream_matrix, datastream_ffdf or your own datastream.

subset

an optional vector specifying a subset of observations to be used in the fitting process.

na.action

a function which indicates what should happen when the data contain NAs. See model.frame for details. Defaults to na.exclude.

transFUN

a function which is used after obtaining chunksize number of rows from the data datastream before applying model.frame. Useful if you want to change the results get_points on the datastream (e.g. for making sure the factor levels are the same in each chunk of processing, some data cleaning, ...). Defaults to identity.

chunksize

the number of rows to obtain from the data datastream in one chunk of model processing. Defaults to 1000. Can be used to speed up things according to the backbone architecture of the datastream.

reset

logical indicating to reset the MOA_regressor so that it forgets what it already has learned. Defaults to TRUE.

trace

logical, indicating to show information on how many datastream chunks are already processed as a message.

options

a names list of further options. Currently not used.

...

other arguments, currently not used yet

See Also

MOA_regressor, datastream_file, datastream_dataframe, datastream_matrix, datastream_ffdf, datastream, predict.MOA_trainedmodel

Examples

mymodel <- MOA_regressor(model = "FIMTDD")
mymodel
data(iris)
iris <- factorise(iris)
irisdatastream <- datastream_dataframe(data=iris)
irisdatastream$get_points(3)
## Train the model
mytrainedmodel <- trainMOA(model = mymodel, 
 Sepal.Length ~ Petal.Length + Species, data = irisdatastream)
mytrainedmodel$model
irisdatastream$reset()
mytrainedmodel <- trainMOA(model = mytrainedmodel$model, 
 Sepal.Length ~ Petal.Length + Species, data = irisdatastream, 
 chunksize = 10, reset=FALSE, trace=TRUE)
mytrainedmodel$model