.. DO NOT EDIT. .. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY. .. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE: .. "auto_examples/dumbell.py" .. LINE NUMBERS ARE GIVEN BELOW. .. only:: html .. note:: :class: sphx-glr-download-link-note :ref:`Go to the end ` to download the full example code. or to run this example in your browser via Binder .. rst-class:: sphx-glr-example-title .. _sphx_glr_auto_examples_dumbell.py: ================ g. dumbbell_plot ================ .. currentmodule:: easy_mpl This file shows the usage of :func:`dumbell` function. .. GENERATED FROM PYTHON SOURCE LINES 9-21 .. code-block:: Python # sphinx_gallery_thumbnail_number = -2 import matplotlib.pyplot as plt import numpy as np from easy_mpl import dumbbell_plot from easy_mpl.utils import version_info from easy_mpl.utils import despine_axes version_info() .. rst-class:: sphx-glr-script-out .. code-block:: none {'easy_mpl': '0.21.5', 'matplotlib': '3.9.4', 'numpy': '2.0.2', 'pandas': '2.2.3', 'scipy': '1.13.1'} .. GENERATED FROM PYTHON SOURCE LINES 22-23 To plot a dumbbell, we require two arrays of equal length. .. GENERATED FROM PYTHON SOURCE LINES 23-28 .. code-block:: Python st = np.random.randint(1, 5, 10) en = np.random.randint(11, 20, 10) _ = dumbbell_plot(st, en) .. image-sg:: /auto_examples/images/sphx_glr_dumbell_001.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_001.png, /auto_examples/images/sphx_glr_dumbell_001_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 29-30 We can sort the dumbbells according the starting value .. GENERATED FROM PYTHON SOURCE LINES 30-32 .. code-block:: Python _ = dumbbell_plot(st, en, sort_start="ascend") .. image-sg:: /auto_examples/images/sphx_glr_dumbell_002.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_002.png, /auto_examples/images/sphx_glr_dumbell_002_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 33-34 The sorting can also be in descending order .. GENERATED FROM PYTHON SOURCE LINES 34-36 .. code-block:: Python _ = dumbbell_plot(st, en, sort_start="descend") .. image-sg:: /auto_examples/images/sphx_glr_dumbell_003.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_003.png, /auto_examples/images/sphx_glr_dumbell_003_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 37-38 We can also sort dumbbells according to end value .. GENERATED FROM PYTHON SOURCE LINES 38-40 .. code-block:: Python _ = dumbbell_plot(st, en, sort_end="ascend") .. image-sg:: /auto_examples/images/sphx_glr_dumbell_004.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_004.png, /auto_examples/images/sphx_glr_dumbell_004_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 41-42 And this can also be in descending order .. GENERATED FROM PYTHON SOURCE LINES 42-44 .. code-block:: Python _ = dumbbell_plot(st, en, sort_end="descend") .. image-sg:: /auto_examples/images/sphx_glr_dumbell_005.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_005.png, /auto_examples/images/sphx_glr_dumbell_005_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 45-49 .. code-block:: Python # The properties of line can be modified by providing ``line_kws`` dictionary. _ = dumbbell_plot(st, en, line_kws={'lw':"2"}) .. image-sg:: /auto_examples/images/sphx_glr_dumbell_006.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_006.png, /auto_examples/images/sphx_glr_dumbell_006_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 50-51 We can also specify the line color using a color palette (color map). .. GENERATED FROM PYTHON SOURCE LINES 51-53 .. code-block:: Python _ = dumbbell_plot(st, en, line_color='tab10') .. image-sg:: /auto_examples/images/sphx_glr_dumbell_007.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_007.png, /auto_examples/images/sphx_glr_dumbell_007_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 54-56 The properties of starting and end markers can be modified by making use of ``start_kws`` and ``end_kws`` keyword. .. GENERATED FROM PYTHON SOURCE LINES 56-66 .. code-block:: Python _ = dumbbell_plot( st, en, line_color="Oranges", line_kws=dict(lw=5), start_kws=dict(s=160, lw=2, zorder=2, color="#242c3c", edgecolors="#242c3c"), end_kws=dict(s=200, color="#a6a6a6", edgecolors="#a6a6a6", lw=2.5, zorder=2), ) .. image-sg:: /auto_examples/images/sphx_glr_dumbell_008.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_008.png, /auto_examples/images/sphx_glr_dumbell_008_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 67-69 We can also specifiy a separate color for starting markers. One way of doing this is by specifying a palette (colormap) name. .. GENERATED FROM PYTHON SOURCE LINES 69-78 .. code-block:: Python _ = dumbbell_plot( st, en, line_color="Oranges", start_marker_color="Blues", line_kws=dict(lw=5), start_kws=dict(s=160, lw=2, zorder=2), end_kws=dict(s=200, color="#a6a6a6", edgecolors="#a6a6a6", lw=2.5, zorder=2) ) .. image-sg:: /auto_examples/images/sphx_glr_dumbell_009.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_009.png, /auto_examples/images/sphx_glr_dumbell_009_2_00x.png 2.00x :class: sphx-glr-single-img .. GENERATED FROM PYTHON SOURCE LINES 79-80 We can also provide colormap for end markers. .. GENERATED FROM PYTHON SOURCE LINES 80-117 .. code-block:: Python _ = dumbbell_plot( st, en, line_color="Oranges", start_marker_color="Blues", end_marker_color="Greys", line_kws=dict(lw=5), start_kws=dict(s=160, lw=2, zorder=2), end_kws=dict(s=200, lw=2.5, zorder=2) ) f, ax = plt.subplots(facecolor = "#EFE9E6") start = np.linspace(35, 60, 20) end = np.linspace(40, 55, 20) line_colors = [] for st, en in zip(start, end): if st>en: line_colors.append("#74959A") else: line_colors.append("#495371") dumbbell_plot(start, end, start_kws=dict(color = "#74959A", s = 150, alpha = 0.35, zorder = 3), end_kws=dict(color = "#495371", s = 150, alpha = 0.35, zorder = 3), line_kws=dict(zorder = 2, lw = 2.5), line_color=line_colors, ax=ax, show=False, ) dumbbell_plot(start, end, start_kws=dict(color = "none", ec = "#74959A", s = 180, lw = 2.5, zorder = 3), end_kws=dict(color = "none", ec = "#495371", s = 180, lw = 2.5, zorder = 3), line_kws=dict(zorder = 2, lw = 2.5), line_color=line_colors, ax=ax, show=False ) despine_axes(ax, keep=['left', 'bottom']) lines, labels = ax.get_legend_handles_labels() ax.legend([lines[2], lines[3]], ['Start', 'End'], labelspacing=1.0) plt.show() .. rst-class:: sphx-glr-horizontal * .. image-sg:: /auto_examples/images/sphx_glr_dumbell_010.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_010.png, /auto_examples/images/sphx_glr_dumbell_010_2_00x.png 2.00x :class: sphx-glr-multi-img * .. image-sg:: /auto_examples/images/sphx_glr_dumbell_011.png :alt: dumbell :srcset: /auto_examples/images/sphx_glr_dumbell_011.png, /auto_examples/images/sphx_glr_dumbell_011_2_00x.png 2.00x :class: sphx-glr-multi-img .. rst-class:: sphx-glr-timing **Total running time of the script:** (0 minutes 1.575 seconds) .. _sphx_glr_download_auto_examples_dumbell.py: .. only:: html .. container:: sphx-glr-footer sphx-glr-footer-example .. container:: binder-badge .. image:: images/binder_badge_logo.svg :target: https://mybinder.org/v2/gh/sphinx-gallery/sphinx-gallery.github.io/master?urlpath=lab/tree/notebooks/auto_examples/dumbell.ipynb :alt: Launch binder :width: 150 px .. container:: sphx-glr-download sphx-glr-download-jupyter :download:`Download Jupyter notebook: dumbell.ipynb ` .. container:: sphx-glr-download sphx-glr-download-python :download:`Download Python source code: dumbell.py ` .. container:: sphx-glr-download sphx-glr-download-zip :download:`Download zipped: dumbell.zip ` .. only:: html .. rst-class:: sphx-glr-signature `Gallery generated by Sphinx-Gallery `_