medkit.audio.preprocessing.power_normalizer
===========================================

.. py:module:: medkit.audio.preprocessing.power_normalizer


Classes
-------

.. autoapisummary::

   medkit.audio.preprocessing.power_normalizer.PowerNormalizer


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

.. py:class:: PowerNormalizer(output_label: str, target_value: float = 1.0, channel_wise: bool = False, uid: str | None = None)

   Bases: :py:obj:`medkit.core.audio.PreprocessingOperation`


   
   Normalization operation setting the RMS power of each audio signal to a target value.


   :Parameters:

       **output_label** : str
           Label of output normalized segments.

       **target_value** : float, default=1.0
           Value to set the RMS power of each segment to.

       **channel_wise** : bool, default=False
           If `True`, the normalization is performed per-channel, thus modifying
           the balance of multichannel signals.

       **uid** : str, optional
           Identifier of the normalizer.














   ..
       !! processed by numpydoc !!

   .. py:method:: run(segments: list[medkit.core.audio.Segment]) -> list[medkit.core.audio.Segment]

      
      Return a normalized segment for each segment in `segments`.


      :Parameters:

          **segments** : list of Segment
              Audio segments to normalize.

      :Returns:

          list of Segment
              Power-normalized segments, one per segment in `segments`.













      ..
          !! processed by numpydoc !!


   .. py:method:: _normalize_segment(segment: medkit.core.audio.Segment) -> medkit.core.audio.Segment