pydaltoolbox
Python port of the R DAL Toolbox — leveraging Experiment Lines for Data Analytics.
pydaltoolbox organizes data analytics workflows (preprocessing, modeling,
evaluation, tuning, extensibility) around a consistent Experiment Line style
API. Its value is not reimplementing classic algorithms — it reuses
scikit-learn, numpy and pandas — but a rigid, extensible interface that wraps
them with a uniform fit / action / evaluate contract. Building a new method
means subclassing a base and implementing two or three methods; sampling,
evaluation and tuning come for free.
It is the foundation of the DAL Python family that also includes
pytspredit (time series prediction) and
pyharbinger (time series event detection).
Installation
Install the latest release from PyPI:
pip install pydaltoolbox
Beta: the v1 foundation is released and new features are landing incrementally (one release at a time) on the way to the
1.0.0launch. The badge above always shows the latest version. Feedback and issues are very welcome.
The development version is available on GitHub:
pip install git+https://github.com/cefet-rj-dal/pydaltoolbox.git
For a local, editable clone (for contributing or running the examples):
git clone https://github.com/cefet-rj-dal/pydaltoolbox.git
cd pydaltoolbox
pip install -e ".[dev]"
pytest
First experiment
import pydaltoolbox as dal
iris = dal.datasets.iris()
slevels = list(iris["Species"].cat.categories)
split = dal.SampleRandom(seed=42).train_test(iris)
train, test = split["train"], split["test"]
model = dal.ClaDtree("Species", slevels, random_state=42).fit(train)
pred = model.predict(test.drop(columns="Species")) # pass only the features
ev = model.evaluate(test["Species"], pred)
print(ev["metrics"])
Documentation
- Processed examples — notebooks executed end to end, with real output
embedded (the "processed documentation", analogous to the R package's
examples/). - develop/planejamento.md — the migration roadmap (phases, scope, status).
- develop/deploy.md — step-by-step guide to publish the package to PyPI.
The example sources live under notebooks/ (jupytext Markdown) and are rendered into examples/ by:
pip install -e ".[docs]"
python tools/build_examples.py
Status
Beta — the v1 foundation is complete and Cycle 1 is extending coverage toward 1.0.0
(see the roadmap for the live plan and version map). Implemented:
- Core Experiment Line:
DalBase,DalTransform,DalLearner,Predictor,set_params, and theadjust_*helpers. - Sampling:
SampleRandom,SampleStratified(train_test,k_fold),train_test_from_folds. - Classification:
Classificationbase +ClaDtree,ClaRpart,ClaKnn,ClaNb,ClaRf,ClaBagging,ClaBoosting,ClaSvm,ClaMlp,ClaGlm,ClaMultinom,ClaGlmnet,ClaMajority. - Regression:
Regressionbase +RegLm,RegDtree,RegKnn,RegRf,RegSvm,RegMlp. - Clustering:
Clustererbase + metrics +ClusterKmeans,ClusterDbscan,ClusterGmm,ClusterHclust,ClusterPam,ClusterCmeans(0.6.0). - Transformations:
- normalization:
MinMax,ZScore - cleaning:
NaRemoval,ImputationSimple,OutliersBoxplot,OutliersGaussian - predictive imputation:
ImputationPredictive,ImputationTree(0.3.0) - encoding / projection:
CategMapping,DtPca - feature selection:
FeatureSelectionCorr,Lasso,InfoGain,Stepwise - feature engineering:
FeatureGeneration,Aggregation,HierarchyCut(0.4.0) - smoothing:
SmoothingInter,SmoothingFreq,SmoothingQuantization,SmoothingCluster(0.2.0) - balancing:
SampleBalance,BalSubsampling,BalOversampling - sampling:
SampleSimple,SampleGroups(0.5.0) - curvature helpers:
FitCurvatureMin,FitCurvatureMax
- normalization:
- Tuning:
DalTunebase +ClaTune,RegTune,CluTune. - Autoencoder bases:
AutoencBaseE,AutoencBaseEd(identity, for extension). - Reference datasets:
datasets.iris(),datasets.diabetes(),datasets.boston().
Wrappers are thin adapters over scikit-learn / numpy / pandas, each reproducing the R
backend's default behavior (e.g. SVM standardizes inputs like e1071, trees pre-prune
like tree/rpart). See the roadmap for what is still coming —
ReliefF feature selection, pattern mining, and the dependency-gated extras (XGBoost,
graph clustering, graphics).
Related DAL projects
License
MIT
Metadata
Release files for pydaltoolbox 0.6.0
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 | Actions |
|---|---|---|---|---|
| pydaltoolbox-0.6.0.tar.gz | 50.9 kB | Without provenance | Details for pydaltoolbox-0.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pydaltoolbox-0.6.0-py3-none-any.whl | Python 3 | none | any | Details for pydaltoolbox-0.6.0-py3-none-any.whl |
Total release size: 126.3 kB
Release files / pydaltoolbox-0.6.0.tar.gz
| Download URL | pydaltoolbox-0.6.0.tar.gz |
|---|---|
| Size | 50.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
10ac6d13f1b03cef344c1104ee0bad7be2671cf991650730eef58b57b7db09ff
|
|
BLAKE2b-256 checksum How to use checksums |
9583cdd3f901193531a656851e1f1896160dd390986701909cb022d5560199df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.0
|
Release files / pydaltoolbox-0.6.0-py3-none-any.whl
| Download URL | pydaltoolbox-0.6.0-py3-none-any.whl |
|---|---|
| Size | 75.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7888bb67db9c508cb2ef157c2fd7088fdf16e33ad4ba22b5ea19341314f6b8c7
|
|
BLAKE2b-256 checksum How to use checksums |
78ec55d9cd57e822cd295b743f58bba059bd4972bfa01d0bff02849d7aaafd46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.0
|
Security for pydaltoolbox 0.6.0
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.
To learn more about protecting yourself from malicious actors, visit our package security documentation.