Skip to content

Learning from Black-Box Models by Maximum Interpretation Decomposition

1packages depend
6.7Kdownloads / year
23.4%test coverage
13/13flavors OK

Overview

About

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.

Changes in 0.6.1
  • Fixed methods of ggmid() for better compatibility with **ggplot2** ecosystem.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 3.8 min · r-devel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK14 OK2026-04-22
  • ERROR13 OK, 1 ERROR2026-04-18
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 0.6.1
READMEYes · 344 wordsVignettesNoNEWSYes · 100% structured · mentions 0.6.1Citation fileYes · software entry onlyWebsiteYes · pkgdown

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

6.7K
CRAN downloads in the past year
Rank #4,765 · ~18/day · ~559/mo
Daily download trend is not available in this view yet.
40630 days
1.7K90 days
6.7K1 year
Compare downloads with other packages →
Also on868 r2u2 autocran

Repository

7Stars
0Forks
3Open issues
0Open PRs
3Releases
266Commits
1Commit identities
imlinterpretable-machine-learningrr-packagexaiactuarial
266 commits · Last activity 2026-10-05 · 0% stars, 30d · Default branch at 0.6.2.900, ahead of CRAN 0.6.1 (checked 2026-10-18)
Responsiveness
How these are sampled
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

2025-08-02 · 52026-09-19 · 7
PracticesBeta

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.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-05 · The repository has a site deploy workflow

pkgdown site last built 2026-10-05

CRAN release process (2)
cran-comments.mdCRAN-SUBMISSION
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies
12 external dependencies (excludes base and recommended)

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.

Depends (0)
none
Imports (7)
graphicsgrDevicesRcppRcppEigenrlangstatsutils
LinkingTo (1)
Enhances (0)
none
Reverse dependencies
1direct
0indirect
Imports 1
Depends, Imports or LinkingTo, most downloaded first

People & History

People (3)
Author, Maintainer · added in 0.5.2
Contributor

Maintainer since 0.5.0 (2025)

Listed in earlier versions (1)
Ryoichi Asasihba
no longer listed · 0.5.0 to 0.5.1
Releases (6)

Pick two releases to compare their code metrics.

  • 0.6.1Latest
    record
    2026-05-01 · current release · diff ↗
  • R
    R 4.6.0 released · 2026-04-24
  • 0.6.0
    record
    2026-03-08 · diff ↗ ·
    added 4 exports
    labels<-, as.midlist, get.link, midlist
  • 0.5.3
    record
    2026-01-16 · diff ↗
  • 0.5.2
    record
    2025-09-08 · diff ↗
  • 0.5.1
    record
    2025-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.tabulate
    added 5 exports
    color.theme.env, color.theme.info, mid.effect, set.color.theme, weighted.loss
  • 0.5.0
    record
    2025-06-23
  • R
    R 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.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for midr version 0.6.1 [Data set]. HJJB, LLC. Data release v2026-10-22. https://doi.org/10.5281/zenodo.21843040

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.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy