Note: this function should not be called directly, as it is part of the lcMethod fitting process. For fitting an lcMethod object to a dataset, see latrend().
The prepareData() function of the lcMethod object processes the training data prior to fitting the method.
Example uses:
Transforming the data to another format, e.g., a matrix.
Truncating the response variable.
Computing derived covariates.
Creating additional data objects.
The computed variables are stored in an environment which is passed to the preFit() function for further processing.
By default, this method does not do anything.
# S4 method for lcMethod
prepareData(method, data, verbose)An object inheriting from lcMethod with all its arguments having been evaluated and finalized.
A data.frame representing the transformed training data.
A R.utils::Verbose object indicating the level of verbosity.
An environment with the prepared data variable(s) that will be passed to preFit().
A common use case for this method is when the internal method fitting procedure expects the data in a different format.
In this example, the method converts the training data data.frame to a matrix of repeated and aligned trajectory measurements.
setMethod("prepareData", "lcMethodExample", function(method, data, verbose) {
envir = new.env()
# transform the data to matrix
envir$dataMat = tsmatrix(data,
id = idColumn, time = timeColumn, response = valueColumn)
return(envir)
})
Each lcMethod subclass defines a type of methods in terms of a series of steps for estimating the method.
These steps, as part of the fitting procedure, are executed by latrend() in the following order:
compose(): Evaluate and finalize the method argument values.
validate(): Check the validity of the method argument values in relation to the dataset.
prepareData(): Process the training data for fitting.
preFit(): Prepare environment for estimation, independent of training data.
fit(): Estimate the specified method on the training data, outputting an object inheriting from lcModel.
postFit(): Post-process the outputted lcModel object.
The result of the fitting procedure is an '>lcModel object that inherits from the lcModel class.