This guide explains how to use tidydiversity and what its results mean. Each chapter follows the same plan:
- The concept: the question, the theory and its key formula, with the original references.
- Code to copy into RStudio, run on real, openly licensed field data shipped with the package.
- Figures and tables made by that code.
- How to interpret them, including what they do not show.
- How to report them: a model paragraph for a paper, with the numbers filled in from the analysis.
| Chapter | You will learn | Main functions |
|---|---|---|
| 1. Install, run and prepare your data | Set up R and RStudio; the tidy data format; abundance and incidence data; converting spreadsheets | div_hill() |
| 2. Hill numbers, completeness and coverage | What diversity is; orders q = 0, 1, 2; diversity profiles; sample coverage; completeness; Chao1 and asymptotic estimates |
div_hill(), div_coverage(),
div_completeness(), div_estimate()
|
| 3. Fair comparisons | Rarefaction and extrapolation; size- versus coverage-based standardisation; reading confidence intervals |
div_rarefy(), div_standardise()
|
| 4. Beta diversity | Gamma = alpha × beta; dissimilarities; turnover versus nestedness; distance decay |
beta_hill(), beta_pair(),
beta_multi(), beta_decay()
|
| 5. Community composition | Ordination and how to read biplots; PERMANOVA; dispersion; indicator species |
ord_fit(), beta_permanova(),
beta_dispersion(), beta_indicator()
|
| 6. Functional and phylogenetic diversity | TD, PD and FD on one Hill-number scale; functional redundancy; choosing tau |
div_estimate(), div_standardise() with
type
|
Where to start. New to R: Chapters 1 and 2. Comparing sites or treatments: Chapter 3 is essential. Comparing species lists: Chapters 4 and 5. Traits or phylogenies: Chapter 6.
Going further. The tutorials apply these methods to ants, frogs, butterflies, insects, mammals, birds and trees; the Reference lists every function. To put diversity on a map, use the companion package tidymapr, whose user guide covers mapping and spatial analysis.
How to cite. Run
citation("tidydiversity") in R.