flashlight

1.0.0

Shed Light on Black Box Machine Learning Models

2packages depend

7.6Kdownloads / year

83.9%test coverage

13/13checks pass

Overview

About

Maintained by Michael MayerFirst published 2019-08-2515 releasesCRAN page ↗GitHub ↗

Shed light on black box machine learning models by the help of model performance, variable importance, global surrogate models, ICE profiles, partial dependence (Friedman J. H. (2001) doi:10.1214/aos/1013203451), accumulated local effects (Apley D. W. (2016) doi:10.48550/arXiv.1612.08468), further effects plots, interaction strength, and variable contribution breakdown (Gosiewska and Biecek (2019) doi:10.48550/arXiv.1903.11420). All tools are implemented to work with case weights and allow for stratified analysis. Furthermore, multiple flashlights can be combined and analyzed together.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("flashlight", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("mayer79/flashlight")

Development version from mayer79/flashlight. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-flashlight

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-flashlight

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-flashlight

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 3.0 min · r-release-macos-x86_64

Code health

Yes

Tests · ratio 0.27

83.9%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 215 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 67% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 96%
Return-value docs: 100%
References docs: 19%

Downloads

7.6K

CRAN downloads in the past year

Rank #6,295 · ~21/day · ~637/mo

Releases R versions

Daily download trend is not available in this view yet.

43230 days

1.5K90 days

7.6K1 year

Compare downloads with other packages →

Also on126 r2u36 autocran

Repository

GitHub ↗ mayer79/flashlight

25Stars

4Forks

3Open issues

0Open PRs

5Releases

290Commits

2Contributors

interpretabilityinterpretable-machine-learningmachine-learningrr-packagexai

License GPL-2.0 · 290 commits · Last activity 2025-10-13 · 0% stars, 30d

Stars over time

2025-05-16 · 232026-07-07 · 25

Repository practices

Upstream repositoryBeta

5 development-tooling and community-health practices detected across 3 families in the upstream repository

Checks run against github.com/mayer79/flashlight on 2026-07-26.

Continuous integration (1)

GitHub Actions

CRAN release process (3)

cran-comments.mdrevdep/CRAN-SUBMISSION

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

11 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.2.0

Imports (11)

dplyr ggplot2 MetricsWeighted rlangrpartrpart.plotstatstibble tidyr tidyselectutils

LinkingTo (0)

none

Suggests (3)

knitr rmarkdown testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

2direct

0indirect

mrIML vivid

Code & Tests

People & History

People (1)

Maintainer (1)

Michael Mayer

Author, Maintainer, Copyright holder

Authors (1)

Michael Mayer

Author, Maintainer, Copyright holder

Michael Mayer

Author, Maintainer, Copyright holder

Package Timeline

15 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.0.0Latest
2025-10-13 · current release · diff ↗
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
0.9.0
2023-05-10 · diff ↗
R
R 4.3.0 released · 2023-04-21
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
0.8.0
2021-04-21 · diff ↗
0.7.5
2021-02-13 · diff ↗
0.7.4
2021-01-10 · diff ↗
0.7.3
2020-06-20 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.7.2
2020-04-14 · diff ↗
0.7.1
2020-03-20 · diff ↗
0.7.0
2020-03-12 · diff ↗

Show 7 earlier events

0.6.0
2020-01-19 · diff ↗
0.5.0
2019-12-05 · diff ↗
0.4.0
2019-11-10 · diff ↗
0.3.0
2019-10-13 · diff ↗
0.2.0
2019-09-18 · diff ↗
0.1.0
2019-08-25
R
R 3.6.0 released · 2019-04-26

Package metadata

First published: 2019-08-25
Total releases: 15 / 7 yrs
License: GPL (>= 2) OSI
Minimum R: ≥ 3.2.0
Download size: 436 KB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →