Metadata-Version: 2.1
Name: pydl8.5
Version: 0.1.2
Summary: A package to build an optimal binary decision tree classifier.
Home-page: https://github.com/aia-uclouvain/pydl8.5
Author: Gael Aglin, Siegfried Nijssen, Pierre Schaus
Author-email: aglingael@gmail.com, siegfried.nijssen@gmail.com, pschaus@gmail.com
Maintainer: Gael Aglin, Siegfried Nijssen, Pierre Schaus
Maintainer-email: aglingael@gmail.com, siegfried.nijssen@gmail.com, pschaus@gmail.com
License: LICENSE.txt
Download-URL: https://github.com/aia-uclouvain/pydl8.5
Project-URL: Source on github, https://github.com/aia-uclouvain/pydl8.5
Project-URL: Documentation, https://pydl85.readthedocs.io/en/latest/?badge=latest
Keywords: decision trees,discrete optimization,classification
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
License-File: LICENSE.txt

|Travis|_ |CircleCI|_ |ReadTheDocs|_ |Codecov|_

.. |Travis| image:: https://app.travis-ci.com/aglingael/PyDL8.5.svg?branch=master
.. _Travis: https://app.travis-ci.com/github/aglingael/PyDL8.5

.. |CircleCI| image:: https://circleci.com/gh/aglingael/PyDL8.5/tree/master.svg?style=shield
.. _CircleCI: https://app.circleci.com/pipelines/github/aglingael/PyDL8.5

.. |ReadTheDocs| image:: https://readthedocs.org/projects/dl85/badge/?version=latest
.. _ReadTheDocs: https://dl85.readthedocs.io/en/latest/

.. |Codecov| image:: https://codecov.io/gh/aglingael/PyDL8.5/branch/master/graph/badge.svg?token=UAP32DK54M
.. _Codecov: https://codecov.io/gh/aglingael/PyDL8.5

:Authors:
    Gaël Aglin, Siegfried Nijssen, Pierre Schaus

Relevant paper : `[DL852020] <https://dial.uclouvain.be/pr/boreal/fr/object/boreal%3A223390/datastream/PDF_01/view>`_ `[PYDL852020] <https://www.ijcai.org/Proceedings/2020/0750.pdf>`_

**The PyDL8.5 library providing an implementation of DL8.5 algorithm. Please read the relevant articles referenced below to learn about the additional features.
Please cite these papers if you used the current library. The documentation will help you get started with PyDL8.5.**


This project implements an algorithm for inferring optimal binary decision trees.
It is scikit-learn compatible and can be used in combination with scikit-learn.
As a scikit-learn classifier, it implements the methods "fit" and "predict".



The current version of PyDL8.5 is an optimized one using some ideas from  `MurTree <https://www.jmlr.org/papers/volume23/20-520/20-520.pdf>`_ paper listed in CHANGES.txt. The version of the code used in the AAAI paper [DL852020] is v0.0.15.

This tool can be installed in two ways:

* download the source from github and install using the command ``python3 setup.py install`` in the root folder
* install from pip by using the command ``pip install pydl8.5`` in the console

**Disclaimer: The compilation of the project has been tested with C++ compilers on the Linux and MacOS operating systems; Windows is not yet supported.**

.. [DL852020] Aglin, G., Nijssen, S., Schaus, P. Learning optimal decision trees using caching branch-and-bound search. In AAAI. 2020.
.. [PYDL852020] Aglin, G., Nijssen, S., Schaus, P. PyDL8.5: a Library for Learning Optimal Decision Trees., In IJCAI. 2020.


