Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thomasp85/lime
Local Interpretable Model-Agnostic Explanations (R port of original Python package)
https://github.com/thomasp85/lime
caret model-checking model-evaluation modeling r
Last synced: about 13 hours ago
JSON representation
Local Interpretable Model-Agnostic Explanations (R port of original Python package)
- Host: GitHub
- URL: https://github.com/thomasp85/lime
- Owner: thomasp85
- License: other
- Created: 2017-03-17T10:40:29.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2022-08-19T09:01:37.000Z (over 2 years ago)
- Last Synced: 2023-11-20T14:42:25.855Z (about 1 year ago)
- Topics: caret, model-checking, model-evaluation, modeling, r
- Language: R
- Homepage: https://lime.data-imaginist.com/
- Size: 10.6 MB
- Stars: 480
- Watchers: 32
- Forks: 110
- Open Issues: 51
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
---
output: github_document
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
```
# lime 
[](https://github.com/thomasp85/lime/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/thomasp85/lime?branch=main)
[](https://CRAN.R-project.org/package=lime)
[](https://CRAN.R-project.org/package=lime)
> There once was a package called lime,
>
> Whose models were simply sublime,
>
> It gave explanations for their variations,
>
> one observation at a time.
*lime-rick by Mara Averick*
* * *
*This is an R port of the Python lime package (https://github.com/marcotcr/lime)
developed by the authors of the lime (Local Interpretable Model-agnostic
Explanations) approach for black-box model explanations. All credits for the
invention of the approach goes to the original developers.*
The purpose of `lime` is to explain the predictions of black box classifiers.
What this means is that for any given prediction and any given classifier it is
able to determine a small set of features in the original data that has driven
the outcome of the prediction. To learn more about the methodology of `lime`
read the [paper](https://arxiv.org/abs/1602.04938) and visit the repository of
the [original implementation](https://github.com/marcotcr/lime).
The `lime` package for R does not aim to be a line-by-line port of its Python
counterpart. Instead it takes the ideas laid out in the original code and
implements them in an API that is idiomatic to R.
## An example
Out of the box `lime` supports a long range of models, e.g. those created with
caret, parsnip, and mlr. Support for unsupported models are easy to achieve by
adding a `predict_model` and `model_type` method for the given model.
The following shows how a random forest model is trained on the iris data set
and how `lime` is then used to explain a set of new observations:
```{r, message=FALSE, fig.asp=1}
library(caret)
library(lime)
# Split up the data set
iris_test <- iris[1:5, 1:4]
iris_train <- iris[-(1:5), 1:4]
iris_lab <- iris[[5]][-(1:5)]
# Create Random Forest model on iris data
model <- train(iris_train, iris_lab, method = 'rf')
# Create an explainer object
explainer <- lime(iris_train, model)
# Explain new observation
explanation <- explain(iris_test, explainer, n_labels = 1, n_features = 2)
# The output is provided in a consistent tabular format and includes the
# output from the model.
explanation
# And can be visualised directly
plot_features(explanation)
```
`lime` also supports explaining image and text models. For image explanations
the relevant areas in an image can be highlighted:
```{r, fig.asp=0.5}
explanation <- .load_image_example()
plot_image_explanation(explanation)
```
Here we see that the second most probably class is hardly true, but is due to
the model picking up waxy areas of the produce and interpreting them as
wax-light surface.
For text the explanation can be shown by highlighting the important words. It
even includes a `shiny` application for interactively exploring text models:
## Installation
`lime` is available on CRAN and can be installed using the standard approach:
```{r, eval=FALSE}
install.packages('lime')
```
To get the development version, install from GitHub instead:
```{r, eval=FALSE}
# install.packages('devtools')
devtools::install_github('thomasp85/lime')
```
## Code of Conduct
Please note that the 'lime' project is released with a
[Contributor Code of Conduct](https://lime.data-imaginist.com/CODE_OF_CONDUCT.html).
By contributing to this project, you agree to abide by its terms.