.. project-template documentation master file, created by
   sphinx-quickstart on Mon Jan 18 14:44:12 2016.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

:notoc:

##############################
imbalanced-learn documentation
##############################

**Date**: |today| **Version**: |version|

**Useful links**:
`Binary Installers <https://pypi.org/project/imbalanced-learn>`__ |
`Source Repository <https://github.com/scikit-learn-contrib/imbalanced-learn>`__ |
`Issues & Ideas <https://github.com/scikit-learn-contrib/imbalanced-learn/issues>`__ |
`Q&A Support <https://gitter.im/scikit-learn-contrib/imbalanced-learn>`__

Imbalanced-learn (imported as :mod:`imblearn`) is an open source, MIT-licensed
library relying on scikit-learn (imported as :mod:`sklearn`) and provides tools
when dealing with classification with imbalanced classes.

.. raw:: html

    <div class="container">
        <div class="row">
            <div class="col-lg-6 col-md-6 col-sm-6 col-xs-12 d-flex">
                <div class="card text-center intro-card shadow">
                <div class="card-body flex-fill">
                    <i class="fas fa-download fa-7x"></i>
                    <h5 class="card-title">Getting started</h5>
                    <p class="card-text">Check out the getting started guides to install <em>imbalanced-learn</em>.
                    Some extra information to get started with a new contribution is also provided.</p>

.. container:: custom-button

    :ref:`To the installation guideline<getting_started>`

.. raw:: html

                </div>
                </div>
            </div>
            <div class="col-lg-6 col-md-6 col-sm-6 col-xs-12 d-flex">
                <div class="card text-center intro-card shadow">
                <div class="card-body flex-fill">
                    <i class="fas fa-book fa-7x"></i>
                    <h5 class="card-title">User guide</h5>
                    <p class="card-text">The user guide provides in-depth information on the
                    key concepts of imbalanced-learn with useful background information and explanation.</p>

.. container:: custom-button

    :ref:`To the user guide<user_guide>`

.. raw:: html

                </div>
                </div>
            </div>
            <div class="col-lg-6 col-md-6 col-sm-6 col-xs-12 d-flex">
                <div class="card text-center intro-card shadow">
                <div class="card-body flex-fill">
                    <i class="fas fa-code fa-7x"></i>
                    <h5 class="card-title">API reference</h5>
                    <p class="card-text">The reference guide contains a detailed description of
                    the imbalanced-learn API. To known more about methods parameters.</p>

.. container:: custom-button

    :ref:`To the reference guide<api>`

.. raw:: html

                </div>
                </div>
            </div>
            <div class="col-lg-6 col-md-6 col-sm-6 col-xs-12 d-flex">
                <div class="card text-center intro-card shadow">
                <div class="card-body flex-fill">
                    <i class="fas fa-chart-bar fa-7x"></i>
                    <h5 class="card-title">Examples</h5>
                    <p class="card-text">The gallery of examples is a good place to see imbalanced-learn in action.
                    Select an example and dive in.</p>

.. container:: custom-button

    :ref:`To the gallery of examples<general_examples>`

.. raw:: html

                </div>
                </div>
            </div>
        </div>
    </div>


.. toctree::
    :maxdepth: 3
    :hidden:
    :titlesonly:

    install
    user_guide
    references/index
    auto_examples/index
    whats_new
    about
