Skip to main content

explainerdashboard allows you quickly build an interactive dashboard to explain the inner workings of your machine learning model.

Project description

This package makes it convenient to quickly explain the workings of a (scikit-learn compatible) fitted machine learning model using either interactive plots in e.g. Jupyter Notebook or deploying an interactive dashboard (based on Flask/Dash) that allows you to quickly explore the impact of different features on model predictions. Example deployed at: titanicexplainer.herokuapp.com

In a lot of organizations, especially governmental, but with the GDPR also increasingly in private sector, it becomes more and more important to be able to explain the inner workings of your machine learning algorithms. Customers have to some extent a right to an explanation why they were selected, and more and more internal and external regulators require it. With recent innovations in explainable AI (e.g. SHAP values) the old black box trope is nog longer valid, but it can still take quite a bit of data wrangling and plot manipulation to get the explanations out of a model. This library aims to make this easy.

The goal is manyfold:

  • Make it easy for data scientists to quickly inspect the workings and performance of their model in a few lines of code

  • Make it possible for non data scientist stakeholders such as managers, directors, internal and external watchdogs to interactively inspect the inner workings of the model without having to depend on a data scientist to generate every plot and table

  • Make it easy to build an application that explains individual predictions of your model for customers that ask for an explanation

  • Explain the inner workings of the model to the people working with so that they gain understanding what the model does and doesn’t do. This is important so that they can gain an intuition for when the model is likely missing information and may have to be overruled.

The library includes:

  • Shap values (i.e. what is the contributions of each feature to each individual prediction?)

  • Permutation importances (how much does the model metric deteriorate when you shuffle a feature?)

  • Partial dependence plots (how does the model prediction change when you vary a single feature?

  • Shap interaction values (decompose the shap value into a direct effect an interaction effects)

  • For Random Forests: what is the prediction of each individual decision tree, and what is the path through each tree? (using dtreeviz)

  • Plus for classifiers: precision plots, confusion matrix, ROC AUC plot, PR AUC plot, etc

  • For regression models: goodness-of-fit plots, residual plots, etc.

The library is designed to be modular so that it should be easy to design your own interactive dashboards with plotly dash, with most of the work of calculating and formatting data, and rendering plots and tables handled by explainerdashboard, so that you can focus on the layout, logic of the interactions, and project specific textual explanations of the dashboard. (i.e. design it so that it will be interpretable for business users in your organization, not just data scientists)

Alternatively, there is a built-in standard dashboard with pre-built tabs that you can select individually.

A deployed example can be found at http://titanicexplainer.herokuapp.com

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

explainerdashboard-0.1.8.5.tar.gz (285.8 kB view details)

Uploaded Source

Built Distribution

explainerdashboard-0.1.8.5-py3-none-any.whl (298.0 kB view details)

Uploaded Python 3

File details

Details for the file explainerdashboard-0.1.8.5.tar.gz.

File metadata

  • Download URL: explainerdashboard-0.1.8.5.tar.gz
  • Upload date:
  • Size: 285.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.0.0.post20200113 requests-toolbelt/0.9.1 tqdm/4.40.0 CPython/3.7.5

File hashes

Hashes for explainerdashboard-0.1.8.5.tar.gz
Algorithm Hash digest
SHA256 97aa36eb45b12900514e83ddd00d175f33d65e81eeb12bb7be5d651714516cd1
MD5 bbd953849e087eef49d32ba95b206656
BLAKE2b-256 b2a7d3cdffce9917c1b70ea0d0226d3d00c882d05083b4be2137a00a28a79589

See more details on using hashes here.

File details

Details for the file explainerdashboard-0.1.8.5-py3-none-any.whl.

File metadata

  • Download URL: explainerdashboard-0.1.8.5-py3-none-any.whl
  • Upload date:
  • Size: 298.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.3

File hashes

Hashes for explainerdashboard-0.1.8.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c98fdf64ec83c1e14654088374e5b2fabbdfd9bc271bd596c06f4fe8f9b18d83
MD5 c6dd8b23c6594ac82a6ed63cc9004b85
BLAKE2b-256 7b06ac4c2eebedcde7ea537dfab773d5af5040363f267dfa0c908ea11065ca54

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page