https://github.com/biometris/douconca
Analysis of multi-trait multi-environment ecological data using double constrained correspondence analysis
https://github.com/biometris/douconca
correspondence-analysis ecology ecology-modeling multi-environment multi-trait r-package
Last synced: 4 months ago
JSON representation
Analysis of multi-trait multi-environment ecological data using double constrained correspondence analysis
- Host: GitHub
- URL: https://github.com/biometris/douconca
- Owner: Biometris
- Created: 2024-09-16T09:55:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-14T07:05:02.000Z (9 months ago)
- Last Synced: 2025-12-08T20:52:17.317Z (7 months ago)
- Topics: correspondence-analysis, ecology, ecology-modeling, multi-environment, multi-trait, r-package
- Language: R
- Homepage: https://biometris.github.io/douconca/
- Size: 15.5 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- Zenodo: .zenodo.json
Awesome Lists containing this project
README
---
output: github_document
editor_options:
markdown:
wrap: 72
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# douconca
[](https://www.r-pkg.org/pkg/douconca)
[](https://www.r-pkg.org/pkg/douconca)
[](https://github.com/Biometris/douconca/actions?workflow=R-CMD-check)
[](https://app.codecov.io/gh/Biometris/douconca)
[](https://doi.org/10.5281/zenodo.13970152)
R library `douconca` analyzes multi-trait multi-environment ecological
data by double constrained correspondence analysis (ter Braak & van Rossum,
2025) using `vegan` and native R code. It has a `formula` interface for
the trait- (column-) and environment- (row-) models, which allows to
assess, for example, the importance of trait interactions in shaping
ecological communities. Throughout the two step algorithm of ter Braak
et al. (2018) is used. This algorithm combines and extends community-
(sample-) and species-level analyses, i.e. the usual community weighted
means (CWM)-based regression analysis and the species-level analysis of
species-niche centroids (SNC)-based regression analysis. The CWM
regressions are specified with an environmental formula and the SNC
regressions are specified with a trait formula. dcCA finds the
environmental and trait gradients that optimize these regressions. The
first step uses
[cca](https://vegandevs.github.io/vegan/reference/cca.html){.uri}
(Oksanen et al. 2022) to regress the transposed abundance data on to the
traits and (weighted) redundancy analysis to regress the
community-weighted means (CWMs) of the orthonormalized traits, obtained
from the first step, on to the environmental predictors. The sample
total of the abundance data are used as weights. The redundancy analysis
is carried out using
[rda](https://vegandevs.github.io/vegan/reference/rda.html){.uri} if
sites have equal weights (after division of the rows by their total) or,
in the general weighted case, using `wrda`. Division by the sample total
has the advantage that the multivariate analysis corresponds with an
unweighted (multi-trait) community-level analysis, instead of being
weighted, which may give a puzzling difference between common univariate
and this multivariate analysis.
References:
ter Braak, CJF, Šmilauer P, and Dray S. 2018. Algorithms and
biplots for double constrained correspondence analysis. Environmental
and Ecological Statistics, 25(2), 171-197.
ter Braak, C.J.F. and van Rossum, B. (2025).
Linking Multivariate Trait Variation to the Environment:
Advantages of Double Constrained Correspondence Analysis
with the R Package Douconca. Ecological Informatics, 88.
## Installation
You can install the CRAN version of `douconca` by:
``` r
install.packages("douconca")
```
You can install the development version of `douconca` by:
``` r
install.packages("remotes")
remotes::install_github("Biometris/douconca", ref = "develop", dependencies = TRUE)
```