Variable Importance Plots
Overview
A general framework for constructing variable importance plots from various types of machine learning models in R. Aside from some standard model- specific variable importance measures, this package also provides model- agnostic approaches that can be applied to any supervised learning algorithm. These include 1) an efficient permutation-based variable importance measure, 2) variable importance based on Shapley values (Strumbelj and Kononenko, 2014) doi:10.1007/s10115-013-0679-x, and 3) the variance-based approach described in Greenwell et al. (2018) doi:10.48550/arXiv.1805.04755. A variance-based method for quantifying the relative strength of interaction effects is also included (see the previous reference for details).
Fixed
- Fixed CRAN check failures on r-devel (Linux/Fedora and macOS ARM64) in
test_vi_firm.R. The test calledranger()without theranger::namespace prefix —requireNamespace()loads a namespace but does not attach it, so unqualified function calls fail. Changed toranger::ranger(). - Fixed
test_vi_firm.Rto passtrain = titanicexplicitly to allvi_firm()/vi()calls. The auto-extraction fallback inget_training_data.defaultis not implemented for ranger models. - Narrowed two
expect_equal()assertions intest_vi_firm.Rto compare only$Importancevalues. Theprob = TRUEshortcut and a custompfunwrapper produce the same importance scores but different raw effect representations, so comparing full objects (including theeffectsattribute) was overly strict.
From NEWS.md in the release
Install
Health
CRAN check results are not tracked yet.
- ERROR13 OK, 1 ERROR2026-03-27
- OK14 OK2026-03-10
Documentation
- Help pages
- 12 (2 internal)
- Examples that run
- 50%4 run in a plain check · 4 never run
- Exported functions with examples
- 100%
- Documented parameters
- 90%
- Return-value docs
- 75%
- Help pages citing references
- 25%
Downloads
Dependencies
Code & Tests
Datasets
People & History
Maintainer since 0.1.0 (2018)
Pick two releases to compare their code metrics.
- archivedRemoved from CRAN2026-07-08issues were not corrected despite reminder
- RR 4.6.0 released · 2026-04-24
- 0.4.62026-04-23 · diff ↗
- unarchivedReturned to CRAN2025-12-12
- 0.4.52025-12-12 · diff ↗
- archivedRemoved from CRAN2025-12-11issues were not corrected in multiple re-submissions
- 0.4.32025-12-10 · diff ↗
- 0.4.22025-12-02 · diff ↗
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- unarchivedReturned to CRAN2023-08-21
- 0.4.12023-08-21 · diff ↗
- archivedRemoved from CRAN2023-08-14issues were not corrected despite repeated reminders
- 0.4.02023-07-19 · diff ↗ ·
removed 17 exports
%>%, %T>%, add_sparklines, grid.arrange, metric_accuracy, metric_auc, metric_error, metric_logLoss, metric_mae, metric_mauc, metric_mse, metric_rmse, metric_rsquared, metric_sse, vi_ice, vi_pdp, vint - RR 4.3.0 released · 2023-04-21
- RR 4.2.0 released · 2022-04-22
Show 12 earlier eventsHide 12 earlier events
- RR 4.1.0 released · 2021-05-18
- 0.3.22020-12-17 · diff ↗
- RR 4.0.0 released · 2020-04-24
- 0.2.22020-04-06 · diff ↗
- 0.2.12020-01-20 · diff ↗
- 0.2.02020-01-19 · diff ↗ ·
added 13 exports
gen_friedman, metric_accuracy, metric_auc, metric_error, metric_logLoss, metric_mae, metric_mauc, metric_mse, metric_rmse, metric_rsquared, metric_sse, vi_firm, vi_shap - 0.1.3
- RR 3.6.0 released · 2019-04-26
- 0.1.2
- 0.1.1
- 0.1.02018-06-15
- RR 3.5.0 released · 2018-04-23
Package metadata
- First published
- 2018-06-15
- Total releases
- 14 / 8 yrs
- License
- GPL (>= 2) OSI
- Minimum R
- ≥ 4.1.0
- Bundled data
- 16 KB / 2 files
- Download size
- 2.3 MB for 0.4.5
Cite
Cite this package
Run in R for the authors' entry:
citation("vip")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.32614/rj-2020-013.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.