.. _sphx_glr_examples_frequencyseries:

.. currentmodule:: gwpy.frequencyseries

##########################
`FrequencySeries` examples
##########################



.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="One of the principal means of estimating the sensitivity of a gravitational-wave detector is to esimate it&#x27;s amplitude spectral density (ASD). The ASD is a measurement of how a signal&#x27;s amplitude varies across different frequencies.">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_hoff_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_hoff.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Calculate and plot a FrequencySeries</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The coherence between two channels is a measure of the frequency-domain correlation between their time-series data.">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_coherence_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_coherence.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The most common visualisation of the spectral content of a data series is via the power or amplitude spectral density calculations (PSD or ASD). However, these typically involve averaging of the data over a period, which can wash out transient noise (as is often desired).">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_variance_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_variance.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Generating a SpectralVariance histogram</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="It can often be useful to add some known signal to inherently random or noisy data. For example, one might want to investigate what would happen if a binary black hole merger signal occured at or near the time of a glitch. In LIGO data analysis, this procedure is referred to as an injection.">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_inject-fs_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_inject-fs.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Inject a signal into a FrequencySeries</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In LIGO the &#x27;Rayleigh&#x27; statistic is a calculation of the coefficient of variation of the power spectral density (PSD) of a given set of data. It is used to measure the &#x27;Gaussianity&#x27; of those data, where a value of 1 indicates Gaussian behaviour, less than 1 indicates coherent variations, and greater than 1 indicates incoherent variation. It is a useful measure of the quality of the strain data being generated and recorded at a LIGO site.">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_rayleigh_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_rayleigh.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="As we have seen in sphinx_glr_examples_frequency_hoff, the Amplitude Spectral Density (ASD) is a key indicator of frequency-domain sensitivity for a gravitational-wave detector.">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_percentiles_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_percentiles.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting an averaged ASD with percentiles.</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example we demonstrate how to calculate the transfer function between two TimeSeries signals.">

.. only:: html

  .. image:: /examples/frequencyseries/images/thumb/sphx_glr_transfer_function_thumb.png
    :alt:

  :ref:`sphx_glr_examples_frequencyseries_transfer_function.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Transfer function</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/frequencyseries/hoff
   /examples/frequencyseries/coherence
   /examples/frequencyseries/variance
   /examples/frequencyseries/inject-fs
   /examples/frequencyseries/rayleigh
   /examples/frequencyseries/percentiles
   /examples/frequencyseries/transfer_function