FAMoS (version 0.1.0)

get.most.distant: Get Most Distant Model

Description

This function can be used to find a model that is most distinct from all previously tested models.

Usage

get.most.distant(input = getwd(), mrun = NULL, max.number = 100)

Arguments

input

Either a string containing the directory which holds the "FAMoS-Results" folder or a matrix containing the tested models along with the respective information criteria. Default to getwd().

mrun

A string giving the number of the corresponding FAMoS run, e.g "004". If NULL (default), all FAMoS runs in the "FAMoS-Results/TestedModels/" folder will be used for evaluation.

max.number

The maximum number of times that the get.most.distant function tries to find the most distant model (see details). Default to 100.

Value

A list containing in its first entry the maximal distance found, the second entry the parameter names and in its third entry the corresponding binary vector. Note that the model may not fulfill previously specified critical conditions.

Details

Taking the order from the 'TestedModels' files found in 'FAMoS-Results/TestedModels/', this function successively tries to obtain a previously untested model that is most distant from all previously tested ones (here, distance means the number of difference in fitted parameters). To this end, a model is taken from 'TestedModels' and its corresponding complement model is calculated (i.e. the model containing all parameters that the original didn't fit). From thereon, the distance of neighbouring models is calculated and the path of increasing distances is followed. This process is repeated until all models in 'TestedModels' have been assessed or the max.number is reached.

Examples

Run this code
# NOT RUN {
get.most.distant(input = famos.run)
# }

Run the code above in your browser using DataCamp Workspace