trainMOA.MOA_classifier: Train a MOA classifier (e.g. a HoeffdingTree) on a datastream

View source: R/train.R

trainMOA.MOA_classifierR Documentation

Train a MOA classifier (e.g. a HoeffdingTree) on a datastream

Description

Train a MOA classifier (e.g. a HoeffdingTree) on a datastream

Usage

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

Arguments

model

an object of class MOA_model, as returned by MOA_classifier, e.g. a HoeffdingTree

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_classifier 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

Value

An object of class MOA_trainedmodel which is a list with elements

  • model: the updated supplied model object of class MOA_classifier

  • call: the matched call

  • na.action: the value of na.action

  • terms: the terms in the model

  • transFUN: the transFUN argument

See Also

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

Examples

hdt <- HoeffdingTree(numericEstimator = "GaussianNumericAttributeClassObserver")
hdt
data(iris)
iris <- factorise(iris)
irisdatastream <- datastream_dataframe(data=iris)
irisdatastream$get_points(3)

mymodel <- trainMOA(model = hdt, Species ~ Sepal.Length + Sepal.Width + Petal.Length, 
 data = irisdatastream, chunksize = 10)
mymodel$model
irisdatastream$reset()
mymodel <- trainMOA(model = hdt, 
 Species ~ Sepal.Length + Sepal.Width + Petal.Length + Petal.Length^2, 
 data = irisdatastream, chunksize = 10, reset=TRUE, trace=TRUE)
mymodel$model

RMOA documentation built on July 18, 2022, 1:05 a.m.