Learn R Programming

codep (version 0.2-1)

codep-package: Functions and methods to perform Multiscale Codependence Analysis (MCA)

Description

Multiscale Codependence Analysis (MCA) consists in assessing the coherence of pairs of variables is space (or time) using the product of their correlation coefficients with series of spatial (or temporal) eigenfunctions. That product, which is positive or negative when variables show similar or opposing trends, respectively, are called codependence coefficients. These eigenfunctions are obtained in three steps: 1) a distance matrice calculated from the locations of samples in space (or the organisation of the sampling schedule). 2) from that distance matrix, a matrix of spatial weights is obtained; the same matrix as to calculate Moran's autocorrelation index, hence the name, and 3) the spatial weight matrix is eigenvalue-decomposed after centering each rows and columns of the spatial weight matrix.

The statistical significance of the codependence coefficients is tested using parametric or permutational testing of a $\tau$ statistic. The $\tau$ statistic is the product of the two Student's $t$ statistics obtained from each of the two variables with a given eigenfunction. The $\tau$ statistic can take both positive and negative values, thereby allowing one to perform one-directional or two-directional testing.

Arguments

encoding

utf8

Details

ll{ Package: codep Type: Package Version: 0.2-1 Date: 2013-08-06 License: Copyleft LazyLoad: yes } Function MCA performs Multiscale Codependence Analysis (MCA).

Functions test.mca and permute.mca handle parametric permutational testing of the codependence coefficients, respectively.

Methods are provided to print and plot mca-class objects (print.mca and plot.mca, respectively) as well as summary (summary.mca), fitted values (fitted.mca), residuals (residuals.mca), and to make predictions (predict.mca).

Function eigenmap calculates spatial eigenvector maps following the approach outlined in Dray et al. (2006), and which are necessary to calculate MCA. It returns a eigenmap-class object. The package also features methods to print (print.eigenmap) and plot (plot.eigenmap) these objects. The package also features an examplary dataset Salmon containing 76 sampling site positions along a 1520 m river segment as well as functions cthreshold and minpermute, which calculates the testwise type I error rate threshold corresponding to a give familywise threshold and the number of permutations suitable for testing Multiscale Codependence Analysis, respectively.

References

Dray, S.; Legendre, P. and Peres-Neto, P. 2006. Spatial modelling: a comprehensive framework for principal coordinate analysis of neighbor matrices (PCNM). Ecol. Modelling 196: 483-493 Guénard, G., Legendre, P., Boisclair, D., and Bilodeau, M. 2010. Multiscale codependence analysis: an integrated approach to analyse relationships across scales. Ecology 91: 2952-2964

See Also

Legendre, P. and Legendre, L. 2012. Numerical Ecology, 3rd English edition. Elsevier Science B.V., Amsterdam, The Neatherlands.