summary.ppSpace: Model summary for object of class 'ppSpace'

Description Usage Arguments Details Value

View source: R/summary.ppSpace.R

Description

Extracts a summary of the model parameters estimated with the ppSpace function.

Usage

1
2
## S3 method for class 'ppSpace'
summary(object, ...)

Arguments

object

An object of class ppSpace

...

Additional arguments affecting the summary produced.

Details

This summary function extract a series of estimated model parameters and statistics (such as the DIC or the WAIC if they have been calculated) and organises them so that they can be readily interpreted. All the information is available in the ppSpace object but it is either difficult to find or badly formatted. This function simplifies the access to this information.

If some non-standard model parameters or statistics have been computed, e.g. through the control.compute argument, they have to be access directly from the ppSpace object.

Value

A list with the following structure

coefficients

All the estimated parameters associated to the explanatory variables. Associated to the estimated coefficients, the standard deviation, the 0.025, 0.5 and 0.975 quantile, the mode and the Kullback-Leibler divergence (kld). The kld describes the difference between the standard Gaussian approximation and the INLA approximation to the marginal posterior densities. Smaller kld are better.

spaceCoefficients

Range and standard deviation estimation, standard deviation as well as the 0.025, 0.5 and 0.975 quantile and the mode for the spatial component of the model. Note that prior.range and prior.sigma in ppSpace are the priors associated to these two estimated hyper parameters.

nEffectiveParam

Number of effective parameters in the model. Because this is a hierarchical model with a spatial component and that information is shared across parameters, the values given are the effective (or independent) number of parameters used in the model. The estimated value is an average and as such also includes a standard deviation.

nEquivalentRep

Number of equivalent replicates. This value is obtained from dividing the total number of samples by the number of effective parameters in the model.

runningTime

Time to perform each step of the INLA analysis. There are some additional preparation step in the ppSpace function, but these should not take more than a few seconds to run at most and should thus account only for a minimal fraction of the time related to computation.

marginalLike

Gaussian and INLA log marginal-likelihood. This argument may be NULL if it was defined as such by the user through the control.compute INLA argument.

WAIC

The full model Watanabe-Akaike Information Criterion. This argument may be NULL if it was defined as such by the user through the control.compute INLA argument. To access the more details WAIC information calculated through INLA, they are available in the ppSpace object.

DIC

The full model Deviance Information Criterion. This argument may be NULL if it was defined as such by the user through the control.compute INLA argument. To access the more details DIC information calculated through INLA, they are available in the ppSpace object.


ReseauBiodiversiteQuebec/mapSpecies documentation built on Dec. 18, 2021, 9:57 a.m.