Metadata-Version: 2.1
Name: gasearch
Version: 0.0.7
Summary: Genetic algorithm based hyperparameter optimalization.
Home-page: https://github.com/jpodivin/geneticsearchcv
Download-URL: https://github.com/jpodivin/geneticsearchcv
Maintainer: Jiri Podivin
Maintainer-email: jpodivin@logosgen.net
License: new BSD
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: scikit-learn
Provides-Extra: tests
Requires-Dist: pytest; extra == "tests"
Requires-Dist: pytest-cov; extra == "tests"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-gallery; extra == "docs"
Requires-Dist: sphinx_rtd_theme; extra == "docs"
Requires-Dist: numpydoc; extra == "docs"
Requires-Dist: matplotlib; extra == "docs"

.. -*- mode: rst -*-

|ReadTheDocs|_

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

gasearch - Genetic algorithm based hyperparameter tuner
==============================================================

.. _scikit-learn: https://scikit-learn.org

**gasearch** - Finding hyperparameters the way nature intended

Hyperparameter search isn't an exact science. We've all heard that one.

gasearch searches the parameter space using genetic algorithm,
with multiple solutions in each generation competing for inclusion in the next.

Mutation of the existing solutions introduces new characteristics and crossover
helps the beneficial traits spread across the population.
At the same time, proportional selection prevents early convergence of algorithm on local
minimum, keeping the population diverse and dynamic.

However, since genetic algorithms are heuristic, there can not be any guarantee that
the solution delivered is the optimal one for a given problem.
Regardless of the number of iterations.

The package follows scikit-learn API conventions and can be readily integrated with
existing pipelines.

TODO:
    * Implement alternative selection algorithms
    * Publish more examples
    * Implement alternative crossover operations
    * Improve docs
    * Optimize, optimize, optimize ...
