by SauceCat

SauceCat / PDPbox

python partial dependence plot toolbox

492 Stars 76 Forks Last release: Not found MIT License 223 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


PyPI version Build Status

python partial dependence plot toolbox


This repository is inspired by ICEbox. The goal is to visualize the impact of certain features towards model prediction for any supervised learning algorithm. (now support all scikit-learn algorithms)

The common headache

When using black box machine learning algorithms like random forest and boosting, it is hard to understand the relations between predictors and model outcome.

For example, in terms of random forest, all we get is the feature importance. Although we can know which feature is significantly influencing the outcome based on the importance calculation, it really sucks that we don’t know in which direction it is influencing. And in most of the real cases, the effect is non-monotonic.

We need some powerful tools to help understanding the complex relations between predictors and model prediction.


  1. Helper functions for visualizing target distribution as well as prediction distribution.
  2. Proper way to handle one-hot encoding features.
  3. Solution for handling complex mutual dependency among features.
  4. Support multi-class classifier.
  5. Support two variable interaction partial dependence plot.


  • Latest version: http://pdpbox.readthedocs.io/en/latest/
  • Historical versions:



Change Logs



  • through pip (latest stable version: 0.2.0)

    $ pip install pdpbox
  • through git (latest develop version)

    $ git clone https://github.com/SauceCat/PDPbox.git
    $ cd PDPbox
    $ python setup.py install


PDPbox can be tested using

  • First install
  $ pip install tox tox-venv
  • Call

    inside the pdpbox clone directory. This will run tests with python 2.7 and 3.6 (if available).
  • To test the documentation, call

    tox -e docs
    . The documentation should open up in your browser if it is successfully build. Otherwise, the problem with the documentation will be reported in the output of the command.


  • PDP: PDP for a single feature

  • PDP: PDP for a multi-class

  • PDP Interact: PDP Interact for two features with contour plot

  • PDP Interact: PDP Interact for two features with grid plot

  • PDP Interact: PDP Interact for multi-class

  • Information plot: target plot for a single feature

  • Information plot: target interact plot for two features

  • Information plot: actual prediction plot for a single feature

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.