Fit Neutral Community Model to Microbiome or Ecological Data
Overview
Provides tools for fitting the neutral community model (NCM) to assess the role of stochastic processes in community assembly. The package implements the framework of Sloan et al. (2006) doi:10.1111/j.1462-2920.2005.00956.x, enabling users to evaluate neutral dynamics in ecological and microbial communities.
NEW FEATURES
- Added
pie_plot()to show Above, Below and Neutral taxon proportions, with external labels and native ggplot2 theme support. - Added
run_app(ncm = ...)to open existingNCMorNCM_groupresults directly in Figure studio. - Redesigned the Shiny app with a model workspace, live figure preview, chart-specific theme editing, and font and color controls.
- Added figure exports in PDF, SVG, PNG, TIFF and JPEG formats, plus reproducible R recipe downloads.
CHANGES
scatter_plot()now usesbase_themeand native ggplot2themeobjects for styling. Standalone font, axis-size and legend-placement arguments have been removed; use theme settings instead.- The combined model in grouped results is now stored under
.ncm_totalinstead ofall. This name is reserved and appears as "Total model" in Shiny.
BUG FIXES
- Fixed custom
start,lowerandupperargument forwarding, and improved retries and diagnostics for non-converged fits. - Corrected frequency-interval boundary handling and tolerance for numerical roundoff in pie plots.
- Preserved numeric and character group labels without overwriting the combined model.
Show all changes in 0.4.0Hide the rest of the changes in 0.4.0
- Fixed missing group labels causing unrelated, explicitly selected groups to fail. Samples with missing labels are excluded from individual group fits and retained in the combined fit.
- Improved automatic figure initialization and consistency between manual previews, exported figures and R recipes.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK4 OK2026-04-11
Documentation
- Help pages
- 9
- Examples that run
- 75%3 run in a plain check · 1 never run
- Exported functions with examples
- 100%
- Documented parameters
- 61%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
Forks over time
1 development-tooling and community-health practice detected across 1 family in the upstream repository
Checks run against github.com/h-xuanjiu/ncmr on 2026-10-18.
Dependencies
Installing ncmR adds 84 packages (44 with compiled code, 72 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 0.4.0Latest
- 0.3.1
- RR 4.6.0 released · 2026-04-24
- 0.2.0
- 0.1.02026-04-10
- RR 4.5.0 released · 2025-04-11
Package metadata
- First published
- 2026-04-10
- Total releases
- 4 / 1 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 3.5
- Bundled data
- 11 KB / 1 file
- Download size
- 70 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ncmR")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.