.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/Plots/plot_circular.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_auto_examples_Plots_plot_circular.py>`
        to download the full example code

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_examples_Plots_plot_circular.py:


Plot circular
=============
The density function can be represented using the area of the bars, the height or
the transparency (alpha). The default behaviour will use the area. Using the heigth
can visually biase the importance of the largest values. Adapted from [#]_.

The circular mean was adapted from Pingouin's implementation [#]_.

.. [#] https://jwalton.info/Matplotlib-rose-plots/

.. [#] https://pingouin-stats.org/_modules/pingouin/circular.html#circ_mean

.. GENERATED FROM PYTHON SOURCE LINES 16-20

.. code-block:: default


    # Author: Nicolas Legrand <nicolas.legrand@cfin.au.dk>
    # Licence: GPL v3








.. GENERATED FROM PYTHON SOURCE LINES 21-23

Using a numpy array of angular values as input
----------------------------------------------

.. GENERATED FROM PYTHON SOURCE LINES 23-27

.. code-block:: default

    import numpy as np
    from systole.plots import plot_circular
    x = np.random.normal(np.pi, 0.5, 100)
    plot_circular(data=x)



.. image-sg:: /auto_examples/Plots/images/sphx_glr_plot_circular_001.png
   :alt: plot circular
   :srcset: /auto_examples/Plots/images/sphx_glr_plot_circular_001.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    /opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/systole/plots/backends/matplotlib/plot_circular.py:133: UserWarning: set_ticklabels() should only be used with a fixed number of ticks, i.e. after set_ticks() or using a FixedLocator.
      ax.set_xticklabels(circle_label)

    <PolarAxes: >



.. GENERATED FROM PYTHON SOURCE LINES 28-30

Using a data frame as input
---------------------------

.. GENERATED FROM PYTHON SOURCE LINES 30-39

.. code-block:: default

    import numpy as np
    import pandas as pd
    from systole.plots import plot_circular

    # Create angular values (two conditions)
    x = np.random.normal(np.pi, 0.5, 100)
    y = np.random.uniform(0, np.pi*2, 100)
    data = pd.DataFrame(data={'x': x, 'y': y}).melt()

    plot_circular(data=data, y='value', hue='variable')


.. image-sg:: /auto_examples/Plots/images/sphx_glr_plot_circular_002.png
   :alt: plot circular
   :srcset: /auto_examples/Plots/images/sphx_glr_plot_circular_002.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    /opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/systole/plots/backends/matplotlib/plot_circular.py:133: UserWarning: set_ticklabels() should only be used with a fixed number of ticks, i.e. after set_ticks() or using a FixedLocator.
      ax.set_xticklabels(circle_label)
    /opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/systole/plots/backends/matplotlib/plot_circular.py:133: UserWarning: set_ticklabels() should only be used with a fixed number of ticks, i.e. after set_ticks() or using a FixedLocator.
      ax.set_xticklabels(circle_label)

    <PolarAxes: >




.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 0.813 seconds)


.. _sphx_glr_download_auto_examples_Plots_plot_circular.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example




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

      :download:`Download Python source code: plot_circular.py <plot_circular.py>`

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

      :download:`Download Jupyter notebook: plot_circular.ipynb <plot_circular.ipynb>`


.. only:: html

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

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