Reproducible Occurrence-to-Biome Classification Using 31 Global Biome Schemes
Overview
Reproducibly classifies occurrence records into biomes using 31 published global biome schemes compiled by Fischer and colleagues (2022) doi:10.1111/geb.13574, provided as harmonised raster layers at 10x10 km resolution globally. Includes functions to choose the most suitable biome scheme for a dataset by a data-driven ranking, to classify occurrence records, and to tabulate and visualise the result. Works with user-provided occurrences or a taxon name, in which case occurrences are downloaded from GBIF (https://www.gbif.org) and cleaned automatically.
- The example dataset is now
bombacoideae_occurrences: 17,030 occurrence records of 185 Bombacoideae species (Zizka et al. 2020), the worked example of the companion paper. It is used in the README, the vignettes and all function examples; the previous datasetbiomes_examplehas been removed. biomes_informationgains the columnbiome_definition(climate, vegetation, land_cover, ecoregion, integrative, anthropogenic); thedefinitionargument ofbiomes_rank(),biomes_visualise()andbiomes_full(scheme = )ranks within one biome definition. Scheme 6 (Zhang et al. 2017, climate and NDVI clustering) isintegrative.biomes_rank(): the criterion is calledeffective_biomes(columnseffective_biomes_raw/_scaled);tiebreaker = "biomes". The ranking uses exactly the three criteria of the companion paper (coverage,effective_biomes,granularity), min-max rescaled and averaged with equal weights; the experimental criteriaevenness,informativenessandagreementand thescalingargument have been removed. A criterion without variation among the compared schemes is left out of the composite (attributecriteria_used), and a single compared scheme gets no composite score (NA) but is still returned asbest_scheme.
Show all changes in 0.9.5Hide the rest of the changes in 0.9.5
biomes_visualise(): therankpanel labels schemes as25 (Ramankutty & Foley, 1999), shows all compared schemes (or thetop_nbest) on one 0 to 1 axis (the rescaled criterion values that enter the composite score; axis titles carry the symbols of the paper,Coverage (C),Effective biomes (E),Granularity (G)) and outlines the best composite score and the best value of each criterion in red; panels carry left-aligned titles with the panel letter and the reference of the chosen scheme (titles); the map legend lists biome names only (legend_counts = FALSE); the barplot uses the map colours per biome, grey for off-map records, and thousands separators.- Maintainer e-mail updated.
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-08
- ERROR12 OK, 1 ERROR2026-09-07
- OK7 OK2026-09-01
Documentation
- Help pages
- 13 (1 internal)includes a package overview page
- Examples that run
- 50%5 run in a plain check · 4 only when donttest examples are enabled (R CMD check --as-cran) · 1 never run
- Exported functions with examples
- 100%
- Documented parameters
- 95%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- not measured
- Median days to close, 50 most recently updated closed issues
- 18
- Median days to close, 50 most recently updated closed PRs
- not measured
Stars over time
Forks over time
Commits over time
Commit identities over time
8 development-tooling and community-health practices detected across 5 families in the upstream repository
Checks run against github.com/azizka/biomes on 2026-10-22.
The R CMD check workflow runs on Linux, macOS and Windows
GitHub Pages site last deployed 2026-10-05 · The repository has a site deploy workflow
pkgdown site last built 2026-10-05
Show all practicesHide 1 practice
Dependencies
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 0.9.5Latest
- 0.9.42026-08-31
- RR 4.6.0 released · 2026-04-24
Package metadata
- First published
- 2026-08-31
- Total releases
- 2 / 1 yrs
- License
- CC BY 4.0
- Minimum R
- ≥ 4.1.0
- Bundled data
- 152 KB / 3 files
- Download size
- 229 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("biomes")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.64898/2026.09.25.754345, 10.1111/geb.13574.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.