Reimplemented the one-way random-effects, single-measure ICC(1,1) with the ANOVA method-of-moments formula for unequal cluster sizes. Negative sample ICCs are retained, and non-estimable cases now return explicit diagnostics.
Corrected Pearson analytic degrees of freedom and Fisher-z confidence intervals. Intervals are bounded by -1 and 1, and inference that is not supported by the available analysis units is reported as unavailable.
Clarified that the Spearman option is a descriptive correlation of mean-centered scores within clusters and of cluster means between clusters. Unsupported analytic, row-jackknife, and cluster-size-weighted Spearman inference has been removed; whole-cluster bootstrap intervals remain available.
Inputs, diagnostics, and output
Strengthened validation for data, cluster identifiers, method, confidence levels, bootstrap settings, weighting, and centering choices.
Logical variables and declared two-level factors are supported with explicit 0/1 orientation. Other categorical inputs are rejected with guidance, and non-finite numeric values are treated as missing.
Detailed tables now retain every requested variable pair, including pairs whose coefficient or inference cannot be estimated. Pair-specific observation counts, cluster counts, coefficient status, inference status, reasons, and bootstrap yield diagnostics are reported.
Correlation-matrix diagonals are 1 only for variables with positive variance at the relevant level; otherwise they are NA.
Added positive-semidefinite diagnostics for the unrounded within- and between-cluster matrices. Pairwise matrices that are not positive semidefinite now trigger a targeted warning, and missing_data = "listwise" provides an optional common-row analysis.
get_matrix(..., numeric = TRUE) now returns unrounded numeric within, between, and merged matrices, including unrounded ICC diagonals.
print() now provides concise, executable guidance for inspecting summaries and extracting full tables, numeric matrices, and ICCs.
Plot panels now use the exact pair-specific rows, centering rule, method, and between-cluster weights used by the fitted object. Annotations come from the stored coefficient and p-value, and significance legends are omitted when p-values were not requested or are unavailable.
to_excel() now accepts a data frame or matrix directly, supports mixed lists of tabular objects, errors clearly when there is nothing to write, and invisibly returns the supplied output path.
Development and release preparation
Added reference tests against psych::statsBy() for within- and between-cluster correlations and ICC(1,1), and expanded automated regression-test coverage.
Added a pkgdown website workflow and a vignette introducing the distinction between within- and between-cluster correlations.
Removed obsolete self-generated test fixtures, a generated plot file, and tracked R session history. Added safeguards against including regenerated session or graphics artifacts in the repository and source package.
Corrected the bundled-data documentation to report 5,000 observations from 100 participants measured over 50 days.
Added repository citation metadata and a DOI badge that use the permanent Zenodo concept DOI, 10.5281/zenodo.20357592, rather than a release-specific DOI.