sequince.steps.mutation.adaptive.policies.acceptance
====================================================

.. py:module:: sequince.steps.mutation.adaptive.policies.acceptance

.. autoapi-nested-parse::

   Choose mutation budgets from observed acceptance probabilities.



Classes
-------

.. autoapisummary::

   sequince.steps.mutation.adaptive.policies.acceptance.AcceptanceRatePolicy


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

.. py:class:: AcceptanceRatePolicy(target_steps, *, min_steps, max_steps, min_acceptance = 1e-06)

   Target expected accepted moves per particle using completed counts.

   Choose ``ceil(target_steps / max(acceptance, min_acceptance))``, clipped
   to configured bounds. With zero attempts, retain the current budget or
   recover to one, subject to bounds. Fractional accepted counts are supported.
   Both APIs divide in floating point before the ceiling and require
   ``max_steps <= 2**24`` for safe integer conversion.


   .. py:attribute:: min_steps


   .. py:attribute:: max_steps


   .. py:attribute:: target_steps


   .. py:attribute:: min_acceptance


   .. py:method:: validate_functional_configuration()

      Require bounds exactly representable in float32 and int32.



   .. py:method:: initialise_functional(*, initial_steps, context)


   .. py:method:: update_functional(*, current_steps, metrics, context)

      Choose a bounded budget from scalar completed-block counts.

      Counts must be finite with ``0 <= accepted <= attempted``. Compiled code
      checks shapes only; callers must validate values. Eager calculations use
      host float64; other backend precisions may round differently.



   .. py:method:: initialise(*, initial_steps, context)


   .. py:method:: update(*, current_steps, metrics, context)


