Home

Awesome

scikit-playtime

Rethinking machine learning pipelines a bit.

What does scikit-playtime do?

I was wondering if there might be an easier way to construct scikit-learn pipelines. Don't get me wrong, scikit-learn is amazing when you want elaborate pipelines (exhibit A, exhibit B) but maybe there is also a place for something more lightweight and playful. This library is all about exploring that.

Imagine that you are dealing with the titanic dataset.

import pandas as pd

df = pd.read_csv("https://calmcode.io/static/data/titanic.csv")
df.head()

Here's what the dataset looks like.

survivedpclassnamesexagefaresibspparch
03Braund, Mr. Owen Harrismale227.2510
11Cumings, Mrs. John Bradley (Florence Briggs Thayer)female3871.283310
13Heikkinen, Miss. Lainafemale267.92500
11Futrelle, Mrs. Jacques Heath (Lily May Peel)female3553.110
03Allen, Mr. William Henrymale358.0500

The goal of this dataset is to predict who survived, so survived is the target column for a classification task. But in order to make the right predictions you would need to encode the features in the right way. So to do that, you might construct a preprocessing pipeline like this:

from sklearn.pipeline import make_union, make_pipeline
from sklearn.preprocessing import OneHotEncoder
from skrub import SelectCols

pipe = make_union(
    SelectCols(["age", "fare", "sibsp", "parch"]),
    make_pipeline(
        SelectCols(["sex", "pclass"]),
        OneHotEncoder()
    )
)

This pipeline takes the age, fare, sibsp and parch features as-is. These features are already numeric so these do not need to be changed. But the sex and pclass features are candidates to one-hot encode first. These are categorical features, so it helps to encode them as such.

The pipeline works, and it's fine, but you could wonder if this is easy. After all, you do need to know scikit-learn fairly well in order to build a pipeline this way and you may also need to appreciate Python. There's some nesting happening in here as well, so for a novice or somebody who just immediately wants to make a quick model ... there's some stuff that gets in the way. All of this is fine when you consider that scikit-learn needs to allow for elaborate pipelines ... but if you just want something dead simple ... then you may appreciate another syntax instead.

Enter playtime.

Playtime offers an API that allows you to declare the aforementioned pipeline by doing this instead:

from playtime import feats, onehot

formula = feats("age", "fare", "sibsp", "parch") + onehot("sex", "pclass")

This formula object is just an object that can accumulate components.

# This object is a scikit-learn pipeline but with operator support!
formula

playtime

It's pretty much the same pipeline as before, but it's a lot easier to go ahead and declare. You're mostly dealing with column names and how to encode them, instead of thinking about how scikit-learn constructs a pipeline.

This is what scikit-playtime is all about, but this is just the start of what it can do. If that sounds interest you can read more on the documentation page.

Alternative you may also explore this tool by installing it via:

python -m pip install scikit-playtime

Thanks

This project was originally part of my work over at calmcode labs but my employer probabl has been very supportive and has allowed me to work on this project during my working hours. This was super cool and I wanted to make sure I recognise them for it.

<p align="center" width="100%" dir="auto"> <a href="https://calmcode.io"> <img src="docs/imgs/calmcode-logo.webp" width="45%" align="left"> </a> <a href="https://probabl.ai"> <img src="docs/imgs/probabl.png" width="45%" align="right"> </a> <br><br><br> </p> <br>