larvaworld.lib.model.modules.feeder
===================================

.. py:module:: larvaworld.lib.model.modules.feeder


Classes
-------

.. autoapisummary::

   larvaworld.lib.model.modules.feeder.Feeder


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

.. py:class:: Feeder(**kwargs: Any)

   Bases: :py:obj:`larvaworld.lib.model.modules.oscillator.Oscillator`


   Feeder module for feeding behavior and head-sweeping motions.

   Implements oscillatory feeding behavior with configurable frequency,
   feeding radius, and bite volume. Controls mouth-hook movements
   during food consumption periods.

   Attributes:
       freq: Feeding oscillation frequency in Hz (1.0-3.0)
       feed_radius: Accessible feeding radius (fraction of body length)
       V_bite: Volume consumed per feeding motion (fraction of body volume)

   Example:
       >>> feeder = Feeder(freq=2.0, feed_radius=0.05, V_bite=0.001)
       >>> feeder.start_effector()
       >>> feeder.step()


   .. py:attribute:: freq


   .. py:attribute:: feed_radius


   .. py:attribute:: V_bite


   .. py:method:: step() -> None


   .. py:method:: suppresion_relief(phi_range: tuple[float, float]) -> bool