Interpretable Machine Learning and Statistical Inference with Accumulated Local Effects (ALE)
Overview
Accumulated Local Effects (ALE) were initially developed as a model-agnostic approach for global explanations of the results of black-box machine learning algorithms. ALE has a key advantage over other approaches like partial dependency plots (PDP) and SHapley Additive exPlanations (SHAP): its values represent a clean functional decomposition of the model. As such, ALE values are not affected by the presence or absence of interactions among variables in a mode. Moreover, its computation is relatively rapid. This package reimplements the algorithms for calculating ALE data and develops highly interpretable visualizations for plotting these ALE values. It also extends the original ALE concept to add bootstrap-based confidence intervals and ALE-based statistics that can be used for statistical inference. For more details, see Okoli, Chitu. 2023. “Statistical Inference Using Machine Learning and Classical Techniques Based on Accumulated Local Effects (ALE).” arXiv. doi:10.48550/arXiv.2310.09877.
New features
retrieve_rds()is a documentation utility function to either retrieve a serialized RDS file from a URL or else run a code block if the URL retrieval fails. It is used in vignettes and other documentation to create or retrieve large objects that are too slow to create on the spot.
From NEWS.md in the release
Install
Health
NOTERd contentsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc
Rd files without \usage: ‘get.ALE.Rd’ ‘get.ALEPlots.Rd’ ‘get.ModelBoot.Rd’ ‘plot.ALE.Rd’ ‘plot.ALEPlots.Rd’ ‘plot.ModelBoot.Rd’ ‘print.ALE.Rd’ ‘print.ALEPlots.Rd’ ‘print.ModelBoot.Rd’ ‘subset.ALEPlots.Rd’ ‘summary.ALEPlots.Rd’ \arguments should not be documented without \usage.
- NOTE11 OK, 2 NOTE2026-09-08
- ERROR10 OK, 2 NOTE, 1 ERROR2026-09-07
- NOTE12 OK, 1 NOTE2026-07-11
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
Show 3 earlier changesHide 3 earlier changes
- OK14 OK2026-03-28
- ERROR13 OK, 1 ERROR2026-03-21
- OK14 OK2026-03-10
Documentation
The repository also keeps web-only articles.
- Help pages
- 23 (1 internal)includes a package overview page
- Examples that run
- 40%4 run in a plain check · 4 only when donttest examples are enabled (R CMD check --as-cran) · 2 hold no code
- Exported functions with examples
- 75%
- Documented parameters
- 80%
- Return-value docs
- 88%
- Help pages citing references
- 22%
Downloads
Repository
- PRs merged (all time)
- 93%
- Median days to close, 50 most recently updated closed issues
- 15
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Issues over time
PRs over time
Commits over time
14 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/tripartio/ale on 2026-10-18.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-10-08 · The repository has a site deploy workflow
pkgdown site last built 2026-10-08
Show all practicesHide 2 practices
Dependencies
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 0.5.3Latest
- unarchivedReturned to CRAN2025-08-29
- 0.5.2
- archivedRemoved from CRAN2025-07-01issues were not corrected in time
- RR 4.5.0 released · 2025-04-11
- 0.5.02025-04-09 · diff ↗ ·
removed 4 exports
ale, ale_ixn, create_p_funs, model_bootstrapadded 5 exports
ALE, ALEpDist, ModelBoot, get, resolve_x_cols - 0.3.12025-03-10 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 0.3.0
- 0.2.02023-10-19 · diff ↗
- 0.1.02023-08-29
- RR 4.3.0 released · 2023-04-21
Package metadata
- First published
- 2023-08-29
- Total releases
- 7 / 3 yrs
- License
- MIT + file LICENSE OSI · relicensed from GPL-2 in 0.5.0
- Minimum R
- ≥ 4.2.0
- Bundled data
- 235 KB / 2 files
- Download size
- 1.6 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ale")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-20, which the citation names so these numbers can be found later. More on citing and the projects behind them.