Release notes for dissmapr v0.2.1
🌍 A maturity & standards release for dissmapr
This release brings dissmapr in line with the B-Cubed software development guide, hardens the codebase, and overhauls the documentation — making the full occurrence → dissimilarity → bioregions workflow easier to install, run, and cite. R CMD check now passes cleanly with 0 errors, 0 warnings, 0 notes.
✨ Highlights
- Runnable quick-start — the README now ships a self-contained, copy-paste example that goes from GBIF occurrence records to a gridded species-richness map.
- Standards-aligned — restructured to follow the B-Cubed guide, with a new Get started vignette and clean
b3docdocumentation builds. - Easier to cite — archived on Zenodo with a citable DOI and machine-readable
CITATION.cffandcodemeta.jsonmetadata.
📚 Documentation
- Rewrote the README around a minimal, reproducible workflow.
- Moved the nine step-by-step tutorials into pkgdown Articles and added a Get started vignette.
- Documented every exported function's arguments, and fixed the example data so all examples run.
🧹 Code quality
- Replaced whole-namespace
@importdeclarations with explicit@importFromimports. - Removed all
library()/require()calls from package code. - Dropped the unused
optimized_compute_orderwise()duplicate and the leftoverhello()template. - Added a real
testthattest forget_occurrence_data(). - Trimmed ~11 MB of unused bundled data (development caches and workspace files).
⚙️ Compatibility
- Now requires R (≥ 4.1.0) — the package uses the native pipe
|>.
🧰 The workflow at a glance
Ten core functions span the pipeline — get_occurrence_data(), generate_grid(), assign_mapsheet(), get_enviro_data(), format_df(), compute_orderwise(), rm_correlated(), predict_dissim(), map_bioreg() and map_bioregDiff() — plus the ζ-MSGDM helpers run_ispline_models(), plot_ispline_lines() and plot_ispline_boxplots().
🔜 Roadmap
- Additional ecological distance metrics.
- Further visualization improvements.
- Expanded vignettes and tutorials.
💬 Questions or bugs? Please use the GitHub issue tracker.
dissmapr is developed within the B-Cubed project (Biodiversity Building Blocks for policy), funded by the European Union's Horizon Europe programme (grant 101059592).