.. _sphx_glr_examples_spectrogram:

.. currentmodule:: gwpy.spectrogram

######################
`Spectrogram` examples
######################



.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The standard coherence calculation outputs a frequency series (`~gwpy.frequencyseries.FrequencySeries`) giving a time-averaged measure of coherence. See sphx_glr_examples_frequencyseries_coherence.py for an example.">

.. only:: html

  .. image:: /examples/spectrogram/images/thumb/sphx_glr_coherencegram_thumb.png
    :alt:

  :ref:`sphx_glr_examples_spectrogram_coherencegram.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Calculating the time-dependent coherence between two channels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="One of the most useful methods of visualising gravitational-wave data is to use a spectrogram, highlighting the frequency-domain content of some data over a number of time steps.">

.. only:: html

  .. image:: /examples/spectrogram/images/thumb/sphx_glr_plot_thumb.png
    :alt:

  :ref:`sphx_glr_examples_spectrogram_plot.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting a Spectrogram</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="As described in sphx_glr_examples_frequencyseries_rayleigh.py, the Rayleigh statistic can be used to study non-Gaussianity in a timeseries. We can study the time variance of these features by plotting a time-frequency spectrogram where we calculate the Rayleigh statistic for each time bin.">

.. only:: html

  .. image:: /examples/spectrogram/images/thumb/sphx_glr_rayleighgram_thumb.png
    :alt:

  :ref:`sphx_glr_examples_spectrogram_rayleighgram.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting a Spectrogram of the Rayleigh statistic</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The sphx_glr_examples_spectrogram_plot.py example showed how to generate and display a Spectrogram of the LIGO-Hanford strain data around the |GW150914|_ event.">

.. only:: html

  .. image:: /examples/spectrogram/images/thumb/sphx_glr_ratio_thumb.png
    :alt:

  :ref:`sphx_glr_examples_spectrogram_ratio.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting a normalised Spectrogram</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The normal spectrogram method uses non-overlapping intervals to calculate discrete PSDs for each stride. This is fine for long-duration data, but give poor resolution when studying short-duration phenomena.">

.. only:: html

  .. image:: /examples/spectrogram/images/thumb/sphx_glr_spectrogram2_thumb.png
    :alt:

  :ref:`sphx_glr_examples_spectrogram_spectrogram2.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting an over-dense, short-duration Spectrogram</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/spectrogram/coherencegram
   /examples/spectrogram/plot
   /examples/spectrogram/rayleighgram
   /examples/spectrogram/ratio
   /examples/spectrogram/spectrogram2