RuleTree
RuleTree builds interpretable decision trees one node at a time. Each node is split by a stump: a threshold on a feature or on a combination of a few features (oblique split), the distance from an instance of the training set (a pivot), the distance of a time series from a shapelet, which of two pivots or shapelets is closer, a fair split, ... The same tree can mix different kinds of stumps and different types of data (tabular data, time series, images), and its rules can be read, drawn and saved.
- Classification, regression (also with several targets) and clustering trees with the scikit-learn API.
- Stumps for tabular data, time series and images, usable together in the same tree.
- Rules as text or Graphviz drawings, feature contributions of each prediction.
- Trees saved to and loaded from JSON, grown further with
partial_fit. - Gradient boosting, XGBoost and explainable boosting machines of RuleTrees.
- Metrics to evaluate the models: predictions, clusters, size of the trees and fairness.
- New stumps written by combining a transformer (the features) and a splitter (the split).
Installation
RuleTree requires Python 3.10 or later:
pip install RuleTree # or, from the root of the repository: pip install .
pip install "RuleTree[shapelets]" # optional: shapelet, proximity and partial pivot stumps (numba)
pip install "RuleTree[graphviz]" # optional: drawing the trees (also requires the Graphviz binaries)
pip install "RuleTree[all]" # all the optional features
Example
from sklearn.datasets import load_iris
from RuleTree import RuleTreeClassifier
X, y = load_iris(return_X_y=True)
model = RuleTreeClassifier(max_depth=2, random_state=0).fit(X, y)
model.print_rules(model.get_rules(columns_names=["sepal length", "sepal width",
"petal length", "petal width"]))
|--- petal width <= 0.8
| output: 0
|--- petal width > 0.8
| |--- petal width <= 1.75
| | output: 1
| |--- petal width > 1.75
| | output: 2
Trees with other stumps and other types of data:
from RuleTree.stumps.classification import DecisionTreeStumpClassifier, ShapeletTreeStumpClassifier
# X: tabular data, X_ts: time series of shape (n_samples, n_signals, length)
model = RuleTreeClassifier(max_depth=3, stump_selection="best",
base_stumps=[DecisionTreeStumpClassifier(), ShapeletTreeStumpClassifier()])
model.fit(X=X, X_ts=X_ts, y=y)
Documentation
The user guide is in docs/guides:
- Getting started: classification, regression, clustering.
- Stumps: the available stumps and how to combine them.
- Tabular data, time series and images.
- Reading the tree: rules, drawings, nodes, feature contributions.
- Saving, growing and updating trees.
- Saving and loading trees: what
to_dictsaves and howfrom_dictrebuilds a tree. - Ensembles: boosting of RuleTrees.
- Evaluating the models: metrics of predictions, clusters, tree size and fairness; all but the tree size need only the output of a model, so they evaluate any model.
- Extending the library: writing new stumps, transformers and splitters.
The HTML documentation, with the API reference, is built with Sphinx:
pip install -r requirements.txt -r requirements.docs.txt
make -C docs html # docs/_build/html/index.html
The figures of the guides (docs/_static/figures) are drawn from fitted models by
python docs/make_figures.py (it needs matplotlib): run it again when a change affects them.
More examples are in the notebooks of Examples.
Tests
pip install ".[test]"
pytest
The tests include the docstring examples and the code of the guides, whose printed output is compared with the one in the guides.
1 maintainer
Metadata
1 maintainer
Release files for RuleTree 2026.10.20.45
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ruletree-2026.10.20.45.tar.gz | 154.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ruletree-2026.10.20.45-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 350.2 kB
Release files / ruletree-2026.10.20.45.tar.gz
| Download URL | ruletree-2026.10.20.45.tar.gz |
|---|---|
| Size | 154.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
55d443d2ccab35edef48fc9d88adb469ac9f606304503b873f40b2448fe835cd
|
|
BLAKE2b-256 checksum How to use checksums |
52e628401e35ef981830986abb1cf8359f9681c5debb45577fc84671adfba2f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / ruletree-2026.10.20.45-py3-none-any.whl
| Download URL | ruletree-2026.10.20.45-py3-none-any.whl |
|---|---|
| Size | 195.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d0a82dfd95404720c0cf1dfc127ff84f58e4a851531e046709274ce157cc05df
|
|
BLAKE2b-256 checksum How to use checksums |
f779e6ed9e069e52b566469c1cb2ef1a07a5bdb41aea9b6a78b8d732628a20e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for RuleTree 2026.10.20.45
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
