Welcome to Scikit-plots 101

🐋 Scikit-plots Runtime Docker Images:

🐳 Explore on Docker Hub Pre-built Docker images for running scikit-plots on demand — with Python 3.11.

🔎 Run the latest scikit-plots container — with full or partial preinstallation — interactively:

```bash

docker run -it --rm scikitplot/scikit-plots:latest

docker run -it --rm scikitplot/scikit-plots:latest -i -c "scikitplot -V" bash

docker run -it scikitplot/scikit-plots:latest

docker run -it -v "$(pwd):/work/notebooks:delegated" -p 8891:8891 scikitplot/scikit-plots:latest ```

📥 User Installation:

🧠 Gotchas:

• ⚠️ (Recommended): Use a Virtual Environmentt (like venv pipenv ) to Avoid Conflicts.
• 🚫 Don't use conda base — it's prone to conflicts.
• ✅ This avoids dependency issues and keeps your system stable.

Conda:

See Also: conda-environment-guidelines

```sh

(conda, mamba or micromamba) Create New Env and install scikit-plots

Create a new environment and install Python 3.11 with IPython kernel support

conda create -n py311 python=3.11 ipykernel -y

micromamba create -n py311 python=3.11 ipykernel -y ```

```sh

(conda, mamba or micromamba) Activate the environment

conda activate py311

micromamba activate py311 ```

```sh

(conda, mamba or micromamba) Install scikit-plots (Upcoming)

conda install --yes -c conda-forge scikit-plots

micromamba install --yes -c conda-forge scikit-plots ```

(Optionally) Pipenv install all dependencies:

See Also: pipenv-environment-guidelines

```sh

(Optionally) Pipenv dep

wget https://raw.githubusercontent.com/scikit-plots/scikit-plots/main/docker/env_pipenv/Pipfile

curl -O https://raw.githubusercontent.com/scikit-plots/scikit-plots/main/docker/envpipenv/Pipfile curl -O https://raw.githubusercontent.com/scikit-plots/scikit-plots/main/docker/envpipenv/Pipfile.lock pip install pipenv && pipenv install ```

```sh

(Optionally) Pipenv Activate the environment

pipenv shell ```

📦 From PIP Installation by pypi , pypi.anaconda.org or GITHUB

The easiest way to set up scikit-plots is to install it using pip with the following command:

- By pypi:

```sh

Now Install scikit-plots (via pip, conda, or local source)

pip install scikit-plots ```

- By pypi.anaconda.org (with required runtime dependencies ):

```sh

(Optionally) Install the lost packages "Runtime dependencies" or use pipenv

https://github.com/celik-muhammed/scikit-plots/tree/main/requirements

wget https://raw.githubusercontent.com/scikit-plots/scikit-plots/main/requirements/default.txt

curl -O https://raw.githubusercontent.com/scikit-plots/scikit-plots/main/requirements/default.txt pip install -r default.txt ```

```sh

Try After Ensure all "Runtime dependencies" installed

pip install -U -i https://pypi.anaconda.org/scikit-plots-wheels-staging-nightly/simple scikit-plots ```

- By GITHUB: @<branch> , @<tag> or Source Code Archive URLs to specify a version

- by GITHUB Branches: @<branch>

```bash

pip install git+https://github.com/scikit-plots/scikit-plots.git@

Latest in Development

pip install git+https://github.com/scikit-plots/scikit-plots.git@main

(Added C, Cpp, Fortran Support) Works with standard Python (CPython)

pip install git+https://github.com/scikit-plots/scikit-plots.git@maintenance/0.4.x

(Works with PyPy interpreter) Works with standard Python (CPython)

pip install git+https://github.com/scikit-plots/scikit-plots.git@maintenance/0.3.x pip install git+https://github.com/scikit-plots/scikit-plots.git@maintenance/0.3.7 ```

- by GITHUB Tags: @<tag>

```bash

pip install git+https://github.com/scikit-plots/scikit-plots.git@

pip install git+https://github.com/scikit-plots/scikit-plots.git@v0.4.0rc5 pip install git+https://github.com/scikit-plots/scikit-plots.git@v0.3.9rc3 pip install git+https://github.com/scikit-plots/scikit-plots.git@v0.3.7 ```

📁 From Source Installation by Archive or GIT Clone

🐍 Pitfalls:

• 💡 You can download GitHub Source Code Archives (.zip or .tar.gz) by specifying a branch, tag, or a specific commit ID.
• 🛠️ After unzipping the GitHub Source Code Archive (similar to cloning), remember require to run git submodule update to initialize submodules.
• 🔄 Alternatively, you can install scikit-plots directly from the GitHub Source Code Repository to access the latest updates.
• ↔️ Alternatively, Source Distribution (.tar.gz) are also available for direct installation via PyPI (sdist), if applicable.

- By Source Distribution (.tar.gz) (with/without required build dependencies )

```sh

pip install package Installs wheel (.whl) if available, else source

pip install --no-binary=package package # Forces source installation only the specified package

pip install --no-binary=scikit-plots scikit-plots ```

```sh

pip install --no-binary=:all: package # Forces source installation for Package + all dependencies

This forces scikit-plots and all its dependencies to be installed from source (from .tar.gz).

pip install --no-binary=:all: scikit-plots ```

- By GITHUB Source Code: (with required build dependencies )

- by GITHUB Source Code Archive URLs: ( .zip or .tar.gz ) (with required build dependencies )

Source code archives are available at specific URLs for each repository. For example, consider the repository scikit-plots/scikit-plots .

- by GitHub Source Code Repository Cloned: (with required build dependencies )

```sh

Forked repo: https://github.com/scikit-plots/scikit-plots.git

git clone https://github.com/YOUR-USER-NAME/scikit-plots.git cd scikit-plots ```

```sh

(if Necessary) Add safe directories for git

bash docker/script/safe_dirs.sh

git config --global --add safe.directory '*' ```

```sh

(Optionally) download submodules, Not Needed Every Time.

git submodule update --init --recursive ```

```sh

Ensure venv (e.g. conda, venv, pipenv)

pip install -r ./requirements/all.txt

pip install -r ./requirements/build.txt ```

```sh

Install scikit-plots

pip install --no-cache-dir . -v ```

🧊🔧 It is also possible to include optional dependencies:

```sh

(Optionally) Install development version

python -m pip install --no-cache-dir -e .[build,dev,test,doc] -v sh

https://github.com/celik-muhammed/scikit-plots/tree/main/requirements

(Optionally) Try Development [build,dev,test,doc]

For More in Doc: https://scikit-plots.github.io/

python -m pip install --no-cache-dir --no-build-isolation -e .[build,dev,test,doc] -v ```

```sh

https://github.com/celik-muhammed/scikit-plots/tree/main/requirements

[cpu] refer tensorflow-cpu, transformers, tf-keras

[gpu] refer Cupy tensorflow lib require NVIDIA CUDA support

pip install "scikit-plots[cpu]" ```

Sample Plots

Scikit-plots is the result of an unartistic data scientist's dreadful realization that visualization is one of the most crucial components in the data science process, not just a mere afterthought.

Gaining insights is simply a lot easier when you're looking at a colored heatmap of a confusion matrix complete with class labels rather than a single-line dump of numbers enclosed in brackets. Besides, if you ever need to present your results to someone (virtually any time anybody hires you to do data science), you show them visualizations, not a bunch of numbers in Excel.

That said, there are a number of visualizations that frequently pop up in machine learning. Scikit-plots is a humble attempt to provide aesthetically-challenged programmers (such as myself) the opportunity to generate quick and beautiful graphs and plots with as little boilerplate as possible.

Okay then, prove it. Show us an example.

Say we use Keras Classifier in multi-class classification and decide we want to visualize the results of a common classification metric, such as sklearn's classification report with a confusion matrix.

Let’s start with a basic example where we use a Keras classifier to evaluate the digits dataset provided by Scikit-learn.

```python

Before tf {'0':'All', '1':'Warnings+', '2':'Errors+', '3':'Fatal Only'} if any

import os; os.environ['TFCPPMINLOGLEVEL'] = '3'

Disable GPU and force TensorFlow to use CPU

import os; os.environ['CUDAVISIBLEDEVICES'] = '' import tensorflow as tf

Set TensorFlow's logging level to Fatal

import logging; tf.getlogger().setLevel(logging.CRITICAL) import numpy as np from sklearn.datasets import loaddigits from sklearn.modelselection import traintest_split

Loading the dataset

X, y = loaddigits( returnX_y=True, )

Split the dataset into training and validation sets

Xtrain, Xval, ytrain, yval = traintestsplit( X, y, testsize=0.33, randomstate=0 )

Convert labels to one-hot encoding

Ytrain = tf.keras.utils.tocategorical(ytrain) Yval = tf.keras.utils.tocategorical(yval)

Define a simple TensorFlow model

tf.keras.backend.clearsession() model = tf.keras.Sequential([ # tf.keras.layers.Input(shape=(Xtrain.shape[1],)), # Input (Functional API) tf.keras.layers.InputLayer(shape=(X_train.shape[1],)), tf.keras.layers.Dense(64, activation='relu'), tf.keras.layers.Dense(64, activation='relu'), tf.keras.layers.Dense(10, activation='softmax') ])

Compile the model

model.compile( optimizer='adam', loss='categorical_crossentropy', metrics=['accuracy'], )

Train the model

model.fit( Xtrain, Ytrain, batchsize=32, epochs=2, validationdata=(Xval, Yval), verbose=0 )

Predict probabilities on the validation set

yprobas = model.predict(Xval)

Plot the data

import matplotlib.pyplot as plt import scikitplot as sp

sp.getlogger().setLevel(sp.splogging.WARNING)

sp.logger.setLevel(sp.logger.INFO) # default WARNING

Plot precision-recall curves

sp.metrics.plotprecisionrecall( yval, yprobas, ) ```

Pretty.

Maximum flexibility. Compatibility with non-scikit-learn objects.

Although Scikit-plot is loosely based around the scikit-learn interface, you don't actually need scikit-learn objects to use the available functions. As long as you provide the functions what they're asking for, they'll happily draw the plots for you.

The possibilities are endless.

Release Notes

See the changelog for a history of notable changes to scikit-plots.

Contributing to Scikit-plots

Reporting a bug? Suggesting a feature? Want to add your own plot to the library? Visit our.

The Scikit-plots Project is made both by and for its users, so we welcome and encourage contributions of many kinds. Our goal is to keep this a positive, inclusive, successful, and growing community that abides by the Scikit-plots Community Code of Conduct.

For guidance on contributing to or submitting feedback for the Scikit-plots Project, see the contributions page. For contributing code specifically, the developer docs have a guide with a quickstart. There's also a summary of contribution guidelines.

Developing with Codespaces

GitHub Codespaces is a cloud development environment using Visual Studio Code in your browser. This is a convenient way to start developing Scikit-plots, using our dev container configured with the required packages. For help, see the GitHub Codespaces docs.

Acknowledging (Governance) and Citing Scikit-plots

See the Acknowledgement, Citation Guide and the CITATION.bib, CITATION.cff file.

1. scikit-plots, “scikit-plots: vlatest”. Zenodo, Aug. 23, 2024. DOI: 10.5281/zenodo.13367000.

2. scikit-plots, “scikit-plots: v0.3.8dev0”. Zenodo, Aug. 23, 2024. DOI: 10.5281/zenodo.13367001.

Supporting the Project (Upcoming)

NumFOCUS, a 501(c)(3) nonprofit in the United States.

License

Scikit-plots is licensed under a 3-clause BSD style license - see the LICENSE file, and LICENSES files.