Package: Proximum 1.1.0

Proximum: Statistical Analysis of Ensemble Proximity Matrices

Treats the proximity matrices produced by tree ensembles as first-class statistical objects rather than as model by-products. Provides a unified extractor across ensemble engines, in-bag and out-of-bag definitions, transformations to dissimilarities with metric diagnostics, corrections that make an indefinite proximity usable as a kernel, and permutation inference for comparing two proximity matrices or partitioning one across the terms of a design. Also provides a Nystrom approximation, a thresholded sparse representation and a streaming form that never allocates the matrix at all, for samples too large to hold it, measures how far the proximity moves between replicates of the ensemble, and draws each object through 'ggplot2': the seriated matrix, the configuration it implies, and the thresholded graph with its communities.

Authors:Agostino Gnasso [aut, cre, cph]

Proximum_1.1.0.tar.gz
Proximum_1.1.0.zip(r-4.7-any)Proximum_1.1.0.zip(r-4.6-any)Proximum_1.1.0.zip(r-4.5-any)
Proximum_1.1.0.tgz(r-4.6-any)Proximum_1.1.0.tgz(r-4.5-any)
Proximum_1.1.0.tar.gz(r-4.7-any)Proximum_1.1.0.tar.gz(r-4.6-any)
Proximum_1.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
Proximum/json (API)

# Install 'Proximum' in R:
install.packages('Proximum', repos = c('https://agostinognasso.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/agostinognasso/proximum/issues

Datasets:
  • loans - A synthetic consumer loan portfolio

On CRAN:

Conda:

4.92 score 14 scripts 393 downloads 17 exports 19 dependencies

Last updated from:3fff465cb4. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK173
source / vignettesOK238
linux-releaseOK153
macos-releaseOK158
macos-oldrelOK185
windows-develOK120
windows-releaseOK125
windows-oldrelOK109
wasm-releaseOK108

Exports:as_dissimilarityas_proximityautoplotckadouble_centreembeddingis_euclideanmake_psdmantel_testn_trees_requirednystrompermanovaprotestproximity_streamrv_coefficientsparsifystability

Dependencies:clicpp11farverggplot2gluegtableisobandlabelinglatticelifecycleMatrixR6RColorBrewerrlangS7scalesvctrsviridisLitewithr

Proximity matrices when n is large
Sparsity: keep every value above a threshold | Landmarks: the Nystrom approximation | What the approximation is for | How many trees, and how much does the answer move? | Choosing between them | Streaming: never allocate it at all | The shape this feature was promised in was wrong | What it costs, which is not nothing | Two things it refuses

Last update: 2026-09-08
Started: 2026-07-09

A credit scoring case study
1. Are there segments, and are they risk segments? | 2. Does the structure survive a shift in the window? | 3. What is the protected attribute worth to the model that never saw it? | What this does not show

Last update: 2026-09-08
Started: 2026-07-09

Comparing forests through their proximities
Two forests to compare | Correlation between two proximity matrices | Alignment of representations | Out-of-bag matrices have to be repaired first | Superimposing the two configurations | Partitioning one matrix | The order of the terms is part of the question | Undefined pairs are refused rather than dropped | Still to come

Last update: 2026-09-08
Started: 2026-07-09

Proximity matrices as statistical objects
Extracting a proximity matrix | Diagnostics | In-bag against out-of-bag | The out-of-bag proximity is not a kernel | Other engines | The views | What comes next

Last update: 2026-09-08
Started: 2026-07-10

Readme and manuals

Help Manual

Help pageTopics
Transform a proximity into a dissimilarityas_dissimilarity
Proximity matrix of a tree ensembleas.matrix.proximity as_proximity as_proximity.e2tree as_proximity.randomForest as_proximity.ranger print.proximity
Dissimilarity induced by a proximity matrixas.dist.proximity
Reconstruct a Nystrom approximation as a dense matrixas.matrix.proximity_nystrom
Densify a sparse proximity matrixas.matrix.proximity_sparse
Visualise a proximity objectautoplot.proximity autoplot.proximity_nystrom autoplot.proximity_sparse autoplot.proximity_stability autoplot.proximity_trees
Centered kernel alignment between two proximity matricescka rv_coefficient
Double centring of a squared dissimilarity matrixdouble_centre
The configuration a proximity matrix impliesembedding embedding.default embedding.proximity_nystrom
Is a dissimilarity matrix Euclidean?is_euclidean
A synthetic consumer loan portfolioloans
Repair an indefinite proximity matrixmake_psd
Mantel test between two proximity matricesmantel_test
How many trees does a stable proximity matrix need?n_trees_required print.proximity_trees
Nystrom approximation of a proximity matrixnystrom print.proximity_nystrom
PERMANOVA on the dissimilarity induced by a proximity matrixpermanova
Procrustes comparison of two proximity matricesprotest
A proximity that is never allocatedas.matrix.proximity_stream print.proximity_stream proximity_stream
Sparse representation of a proximity matrixprint.proximity_sparse sparsify
Agreement between replicate proximity matricesprint.proximity_stability stability
Diagnostics for a proximity matrixprint.summary.proximity summary.proximity
Diagnostics for a Nystrom approximationprint.summary.proximity_nystrom summary.proximity_nystrom
Diagnostics for a sparse proximity matrixprint.summary.proximity_sparse summary.proximity_sparse