bolster.stats.distributions
===========================

.. py:module:: bolster.stats.distributions

.. autoapi-nested-parse::

   Statistical distribution fitting utilities.

   Provides :func:`best_fit_distribution`, which tests a large set of
   ``scipy.stats`` continuous distributions against observed data and returns
   the one with the lowest sum-of-squared-errors against the empirical
   histogram.

   Intended for exploratory data analysis where you want a quick sanity-check
   on which parametric family best describes your data before committing to a
   more rigorous approach.

   .. note::

      This module depends on :mod:`scipy` and :mod:`numpy`.  The fitting loop
      is marked ``# pragma: no cover`` because it is compute-intensive and not
      suitable for CI; validate results manually or in a notebook.



Functions
---------

.. autoapisummary::

   bolster.stats.distributions.best_fit_distribution


Module Contents
---------------

.. py:function:: best_fit_distribution(data, bins=200, ax=None, include_slow=False, discriminator='sse')

   Model data by finding best fit distribution to data.