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

.. only:: html

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

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

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

.. _sphx_glr_examples_cascade_plot_simple_cascade.py:


Simple Cascade
==============

A simple cascade plot.

This example uses the synthetic performance efficiency data introduced
in the paper "`Interpreting and Visualizing Performance Portability Metrics`_"
to demonstrate the structure and interpretation of a cascade plot.

The dataset contains application efficiency for six hypothetical applications:

1. **Unportable**: Runs on only one platform.
2. **Single Target**: Runs everywhere, but with high efficiency on one platform.
3. **Multi-Target**: Runs everywhere, with high efficiency on half of the platforms.
4. **Consistent (30%)**: Runs everywhere, with 30% efficiency.
5. **Consistent (70%)**: Runs everywhere, with 70% efficiency.
6. **Inconsistent**: Runs everywhere, with inconsistent efficiency.

The line chart shows the efficiency of each application for every platform it
supports. Platforms are sorted individually for each application, in decreasing
order of application efficiency.

The boxes underneath the line chart show which platform is associated with each
point in the line chart, for each application.

The bar chart shows the performance portability of each application.

.. _Interpreting and Visualizing Performance Portability Metrics: https://doi.org/10.1109/P3HPC51967.2020.00007

.. GENERATED FROM PYTHON SOURCE LINES 34-44



.. image-sg:: /examples/cascade/images/sphx_glr_plot_simple_cascade_001.png
   :alt: plot simple cascade
   :srcset: /examples/cascade/images/sphx_glr_plot_simple_cascade_001.png
   :class: sphx-glr-single-img





.. code-block:: Python


    # Initialize synthetic performance efficiency data
    # (not shown, but available in script download)

    # Read performance efficiency data into pandas DataFrame
    df = pd.DataFrame(data)

    # Generate a cascade plot
    cascade = p3analysis.plot.cascade(df, size=(6, 5))
    cascade.save("cascade.png")


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

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


.. _sphx_glr_download_examples_cascade_plot_simple_cascade.py:

.. only:: html

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

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

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

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

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

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: plot_simple_cascade.zip <plot_simple_cascade.zip>`


.. only:: html

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

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