GlobalGrowthComparison: GlobalGrowthComparison class

In biogrowth: Modelling of Population Growth

GlobalGrowthComparison class

Description

The GlobalGrowthComparison class contains several functions for model comparison and model selection of growth models. It should not be instanced directly. Instead, it should be constructed using compare_growth_fits(). It is similar to GrowthComparison, although with specific tools to deal with several experiments.

It includes two type of tools for model selection and comparison: statistical indexes and visual analyses. Please check the sections below for details.

Note that all these tools use the names defined in compare_growth_fits(), so we recommend passing a named list to that function.

Usage

## S3 method for class 'GlobalGrowthComparison'
coef(object, ...)

## S3 method for class 'GlobalGrowthComparison'
summary(object, ...)

## S3 method for class 'GlobalGrowthComparison'
print(x, ...)

## S3 method for class 'GlobalGrowthComparison'
plot(x, y, ..., type = 1, add_trend = TRUE)

Arguments

object	an instance of GlobalGrowthComparison
...	ignored
x	an instance of GlobalGrowthComparison
y	ignored
type	if type==1, the plot compares the model predictions. If type ==2, the plot compares the parameter estimates. If type==3, the plot shows the residuals
add_trend	should a trend line of the residuals be added for type==3? TRUE by default

Methods (by generic)

• coef(GlobalGrowthComparison): table of parameter estimates

• summary(GlobalGrowthComparison): summary table for the comparison

• print(GlobalGrowthComparison): print of the model comparison

• plot(GlobalGrowthComparison): illustrations comparing the fitted models

Statistical indexes

GlobalGrowthComparison implements two S3 methods to obtain numerical values to facilitate model comparison and selection.

• the coef method returns a tibble with the values of the parameter estimates and their corresponding standard errors for each model.

• the summary returns a tibble with the AIC, number of degrees of freedom, mean error and root mean squared error for each model.

Visual analyses

The S3 plot method can generate three types of plots:

• when type = 1, the plot compares the fitted growth curves against the experimental data used to fit the model.

• when type = 2, the plot compares the parameter estimates using error bars, where the limits of the error bars are the expected value +/- one standard error. In case one model does not has some model parameter (i.e. either because it is not defined or because it was fixed), the parameter is not included in the plot.

• when type=3, the plot shows the tendency of the residuals for each model. This plot can be used to detect deviations from independence.

These plots are divided by facets for each experiment.

biogrowth documentation built on Aug. 19, 2023, 1:06 a.m.