larvaworld.lib.plot.freq
========================

.. py:module:: larvaworld.lib.plot.freq

.. autoapi-nested-parse::

   Frequency-related plotting



Functions
---------

.. autoapisummary::

   larvaworld.lib.plot.freq.plot_fft_multi


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

.. py:function:: plot_fft_multi(ks: Sequence[str] = ('v', 'fov'), name: str = 'frequency_powerspectrum', axx: Optional[Any] = None, **kwargs: Any) -> Any

   Plot FFT power spectra for multiple parameters.

   Creates Fourier analysis plots showing frequency power spectra and
   dominant frequency distributions for velocity and angular velocity,
   with inset probability histogram.

   Args:
       ks: Parameter keys to analyze. Defaults to ('v', 'fov') for forward
           and angular velocity
       name: Plot name for saving. Defaults to 'frequency_powerspectrum'
       axx: Inset axes for probability histogram. Auto-created if None
       **kwargs: Additional arguments passed to AutoPlot

   Returns:
       Plot output (figure object or None based on return_fig setting)

   Example:
       >>> fig = plot_fft_multi(ks=['v', 'fov'], datasets=[d1, d2])