:orphan:

Example gallery
===============

This gallery is intended to present examples on how to use scikit-maad to analyse audio recordings.


.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    </div>

Basic examples
--------------


.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In audio signals, regions of interest are usually regions with high density of energy. The func...">

.. only:: html

  .. image:: /_auto_examples/1_basic/images/thumb/sphx_glr_plot_find_rois_simple_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_1_basic_plot_find_rois_simple.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Simple audio segmentation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="An audio signal can be represented in both, temporal and spectral domains.  These representatio...">

.. only:: html

  .. image:: /_auto_examples/1_basic/images/thumb/sphx_glr_plot_audio_representation_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_1_basic_plot_audio_representation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Audio representation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="When dealing with large amounts of audio recordings, visualization plays a key role to evidence...">

.. only:: html

  .. image:: /_auto_examples/1_basic/images/thumb/sphx_glr_plot_circadian_spectrogram_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_1_basic_plot_circadian_spectrogram.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Circadian soundscape</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Template matching is a simple but powerfull method to detect a stereotyped sound of interest us...">

.. only:: html

  .. image:: /_auto_examples/1_basic/images/thumb/sphx_glr_plot_template_matching_example_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_1_basic_plot_template_matching_example.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Template matching</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="When sound travels in air (or in water), initial acoustic signature may change  regarding dista...">

.. only:: html

  .. image:: /_auto_examples/1_basic/images/thumb/sphx_glr_plot_detection_distance_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_1_basic_plot_detection_distance.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Detection distance estimation</div>
    </div>


.. raw:: html

    </div>

Advanced examples
-----------------


.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Acoustic fingerprinting is a technique that captures unique features of audio signals. For exam...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_graphical_soundscape_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_graphical_soundscape.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Acoustic fingerprinting and graphical soundscapes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Soundscapes result from a combination of multiple signals that are mixed-down into a single tim...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_nmf_and_false_color_spectrogram_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_nmf_and_false_color_spectrogram.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Signal decomposition and false-color spectrograms</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Unsupervised learning algorithms search for structures or patterns in a dataset without requiri...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_unsupervised_sound_classification_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_unsupervised_sound_classification.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Classify soundtypes with unsupervised learning</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Environmental audio recordings usually have stationary noise that needs to be removed to enhanc...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_remove_background_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_remove_background.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Remove background noise with signal processing tools</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="When sound travels in air (or in water), initial acoustic signature may change  regarding dista...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_sound_degradation_due_to_attenuation_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_sound_degradation_due_to_attenuation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Simulation of sound degradation due to geometric, atmospheric and habitat attenuation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The goal of this example is to show how to download metadata from Xeno-Canto to infer species a...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_xenocanto_woodpecker_activities_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_xenocanto_woodpecker_activities.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Download metadata from Xeno-Canto to infer species activities</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Sound pressure level (dB SPL) is a quantitative value that allows comparison of audio  recordin...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_sound_pressure_level_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_sound_pressure_level.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Estimate sound pressure level from audio recordings</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Acoustic indices can summarize aspects of the acoustic energy distribution in audio recordings ...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_extract_alpha_indices_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_extract_alpha_indices.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Extract acoustic indices from audio recordings</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A spectrogram is a time-frequency (2d) representation of a audio recording.  Each acoustic even...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_compare_auto_and_manual_rois_selection_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_compare_auto_and_manual_rois_selection.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Find Regions of interest (ROIs) in a spectrogram</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Acoustic indices can summarize aspects of the acoustic energy distribution in audio recordings ...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_extract_alpha_indices_multicpu_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_extract_alpha_indices_multicpu.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Use multicpu functionality to compute indices</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Dependencies: To execute this example you need to have installed the  librosa, sklearn and pand...">

.. only:: html

  .. image:: /_auto_examples/2_advanced/images/thumb/sphx_glr_plot_woodpecker_drumming_characteristics_thumb.png
    :alt:

  :ref:`sphx_glr__auto_examples_2_advanced_plot_woodpecker_drumming_characteristics.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Download audio files from Xeno-Canto and automatically extract characteristics</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:
   :includehidden:


   /_auto_examples/1_basic/index.rst
   /_auto_examples/2_advanced/index.rst


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: _auto_examples_python.zip </_auto_examples/_auto_examples_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: _auto_examples_jupyter.zip </_auto_examples/_auto_examples_jupyter.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_