.. _sphx_glr_recipes_chart_context:

Chart Context Examples
===================================

See below for examples of modifying charts to convey context such as annotations or shaded regions.



.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="It can be useful to call out positive or negative areas within a chart, especially for growth rate visualizations. This is achieved using the shade_y instance and specifying the appropriate start, end, and color.">

.. only:: html

  .. image:: /recipes/chart_context/images/thumb/sphx_glr_plot_positive_negative_regions_thumb.png
    :alt:

  :ref:`sphx_glr_recipes_chart_context_plot_positive_negative_regions.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Shade Positive and Negative Regions</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Shaded regions can be used to call attention to general section of the chart. The shaded_regions argument is used to define these areas. Pass in a list of shade_x or shade_y instances. Similar to annotations they use an inverval of values to position the shaded area along its axis.">

.. only:: html

  .. image:: /recipes/chart_context/images/thumb/sphx_glr_plot_shaded_region_thumb.png
    :alt:

  :ref:`sphx_glr_recipes_chart_context_plot_shaded_region.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Shaded Regions</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Annotations be placed on a chart that is positioned on both axes. This can be useful to draw attentiong to specific point(s).">

.. only:: html

  .. image:: /recipes/chart_context/images/thumb/sphx_glr_plot_floating_annotations_thumb.png
    :alt:

  :ref:`sphx_glr_recipes_chart_context_plot_floating_annotations.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Chart Floating Annotations</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Annotations can be added to a chart using the annotations argument and passing a list of annotation instances. By default, annotations will include a veritical or horizontal line across the axis it lives on and a text box with a given text message.">

.. only:: html

  .. image:: /recipes/chart_context/images/thumb/sphx_glr_plot_annotation_thumb.png
    :alt:

  :ref:`sphx_glr_recipes_chart_context_plot_annotation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Chart Annotations</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /recipes/chart_context/plot_positive_negative_regions
   /recipes/chart_context/plot_shaded_region
   /recipes/chart_context/plot_floating_annotations
   /recipes/chart_context/plot_annotation