matchednull: Matched-Null Tests for Cluster-Count Claims

Builds matched nulls for cluster-count claims: synthetic twins of a dataset that preserve every marginal distribution and the full correlation matrix while containing no cluster structure by construction. A reported number of clusters or "types" can then be tested against what the data's own margins and covariance already produce, using any clustering pipeline. A t-copula option adds tail dependence to the null, so that an apparent excess of clusters can be checked against a heavier-tailed alternative before it is read as evidence of types. Implements the matched-null procedure of Meng (2026) "Types Without Taxa" <doi:10.17605/OSF.IO/2EKCG>.

Version: 0.2.1
Imports: stats
Suggests: mclust, testthat (≥ 3.0.0), knitr, rmarkdown, future.apply, future
Published: 2026-08-21
DOI: 10.32614/CRAN.package.matchednull
Author: Miura Meng ORCID iD [aut, cre]
Maintainer: Miura Meng <haomeng797 at gmail.com>
BugReports: https://github.com/haomeng797-ship-it/matchednull/issues
License: MIT + file LICENSE
URL: https://haomeng797-ship-it.github.io/matchednull/, https://github.com/haomeng797-ship-it/matchednull
NeedsCompilation: no
Citation: matchednull citation info
Materials: README, NEWS
In views: Cluster
CRAN checks: matchednull results

Documentation:

Reference manual: matchednull.html , matchednull.pdf
Vignettes: Testing a cluster count with matched nulls (source, R code)

Downloads:

Package source: matchednull_0.2.1.tar.gz
Windows binaries: r-devel: matchednull_0.1.0.zip, r-release: matchednull_0.1.0.zip, r-oldrel: matchednull_0.1.0.zip
macOS binaries: r-release (arm64): matchednull_0.2.1.tgz, r-oldrel (arm64): matchednull_0.2.1.tgz, r-release (x86_64): matchednull_0.1.0.tgz, r-oldrel (x86_64): matchednull_0.1.0.tgz
Old sources: matchednull archive

Linking:

Please use the canonical form https://CRAN.R-project.org/package=matchednull to link to this page.