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 [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.2.1.zip, r-release: matchednull_0.2.1.zip, r-oldrel: matchednull_0.2.1.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.2.1.tgz, r-oldrel (x86_64): matchednull_0.2.1.tgz
Old sources:	matchednull archive

Linking:

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