Learning from Black-Box Models by Maximum Interpretation Decomposition
Overview
The goal of 'midr' is to provide a model-agnostic method for interpreting and explaining black-box predictive models by creating a globally interpretable surrogate model. The package implements 'Maximum Interpretation Decomposition' (MID), a functional decomposition technique that finds an optimal additive approximation of the original model. This approximation is achieved by minimizing the squared error between the predictions of the black-box model and the surrogate model. The theoretical foundations of MID are described in Iwasawa & Matsumori (2025) [Forthcoming], and the package itself is detailed in Asashiba et al. (2025) doi:10.48550/arXiv.2506.08338.
- Fixed methods of
ggmid()for better compatibility with **ggplot2** ecosystem.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK14 OK2026-04-22
- ERROR13 OK, 1 ERROR2026-04-18
- OK14 OK2026-03-10
Documentation
The repository also keeps web-only articles.
- Help pages
- 43 (3 internal)includes a package overview page
- Examples that run
- 100%38 run in a plain check
- Exported functions with examples
- 95%
- Documented parameters
- 94%
- Return-value docs
- 100%
- Help pages citing references
- 2%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 19
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Releases over time
Issues over time
PRs over time
Commits over time
9 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/ryo-asashi/midr 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-05 · The repository has a site deploy workflow
pkgdown site last built 2026-10-05
Dependencies
Installing midr adds 3 packages (3 with compiled code, 4.2 MB of source tarballs). Heaviest: Rcpp 1.8 MB, RcppEigen 1.7 MB, rlang 766 KB.
Code & Tests
People & History
Maintainer since 0.5.0 (2025)
Pick two releases to compare their code metrics.
- 0.6.1Latest
- RR 4.6.0 released · 2026-04-24
- 0.6.0
- 0.5.32026-01-16 · diff ↗
- 0.5.22025-09-08 · diff ↗
- 0.5.12025-08-27 · diff ↗ ·
removed 13 exports
augmented, latticized, mid.encoding.scheme, mid.extract, mid.frames, shuffled, weighted, weighted.mae, weighted.medae, weighted.mse, weighted.quantile, weighted.rmse, weighted.tabulateadded 5 exports
color.theme.env, color.theme.info, mid.effect, set.color.theme, weighted.loss - 0.5.02025-06-23
- RR 4.5.0 released · 2025-04-11
Package metadata
- First published
- 2025-06-23
- Total releases
- 6 / 1 yrs
- License
- MIT + file LICENSE OSI
- Download size
- 320 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("midr")The package provides a citation file, so citation() returns the authors' own entry.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-22, which the citation names so these numbers can be found later. More on citing and the projects behind them.