..
  https://devguide.python.org/documentation/markup/#sections
  https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#sections
  # with overline, for parts    : ######################################################################
  * with overline, for chapters : **********************************************************************
  = for sections                : ======================================================================
  - for subsections             : ----------------------------------------------------------------------
  ^ for subsubsections          : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  " for paragraphs              : """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

..
  # https://rsted.info.ucl.ac.be/
  # https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#paragraph-level-markup
  # https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#footnotes
  # https://documatt.com/restructuredtext-reference/element/admonition.html
  # attention, caution, danger, error, hint, important, note, tip, warning, admonition, seealso
  # versionadded, versionchanged, deprecated, versionremoved, rubric, centered, hlist

.. _external_resources:

******************
External Resources
******************

============================
Books, chapters and articles
============================

* `Scientific Visualization: Python + Matplotlib (2021)
  <https://hal.inria.fr/hal-03427242/>`_
  by Nicolas P. Rougier

* `Mastering matplotlib
  <https://www.packtpub.com/product/mastering-matplotlib/9781783987542>`_
  by Duncan M. McGreggor

* `Interactive Applications Using Matplotlib
  <https://www.packtpub.com/product/interactive-applications-using-matplotlib/9781783988846>`_
  by Benjamin Root

* `Matplotlib for Python Developers
  <https://www.packtpub.com/product/matplotlib-for-python-developers/9781847197900>`_
  by Sandro Tosi

* `Matplotlib chapter <http://www.aosabook.org/en/matplotlib.html>`_
  by John Hunter and Michael Droettboom in The Architecture of Open Source
  Applications

* `Ten Simple Rules for Better Figures
  <https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1003833>`_
  by Nicolas P. Rougier, Michael Droettboom and Philip E. Bourne

* `Learning Scientific Programming with Python chapter 7
  <https://scipython.com/book/chapter-7-matplotlib/>`_
  by Christian Hill

* `Hands-On Data Analysis with Pandas, chapters 5 and 6
  <https://www.packtpub.com/product/hands-on-data-analysis-with-pandas-second-edition/9781800563452>`_
  by Stefanie Molin

======
Videos
======

* `Anatomy of Matplotlib
  <https://conference.scipy.org/scipy2013/tutorial_detail.php?id=103>`_
  by Benjamin Root

* `Data Visualization Basics with Python (O'Reilly)
  <https://www.oreilly.com/library/view/data-visualization-basics/9781771375573/>`_
  by Randal S. Olson

* `Introduction to NumPy and Matplotlib
  <https://www.youtube.com/watch?v=3Fp1zn5ao2M&feature=plcp>`_ by Eric Jones

..
  # https://www.youtube.com/watch?v=3Fp1zn5ao2M

..  youtube:: 3Fp1zn5ao2M

* `Matplotlib Introduction
  <https://www.youtube.com/playlist?list=PLeo1K3hjS3uu4Lr8_kro2AqaO6CFYgKOl>`_
  by codebasics

..
  # https://www.youtube.com/watch?v=qqwf4Vuj8oM&list=PLeo1K3hjS3uu4Lr8_kro2AqaO6CFYgKOl&index=1
..  youtube:: qqwf4Vuj8oM

* `Plotting with matplotlib <https://www.youtube.com/watch?v=P7SVi0YTIuE>`_
  by Mike Müller

..  youtube:: P7SVi0YTIuE

* `Matplotlib
  <https://www.youtube.com/watch?v=wB9C0Mz9gSo>`_
  by Derek Banas

..  youtube:: wB9C0Mz9gSo

=========
Tutorials
=========

* `Matplotlib tutorial <https://www.labri.fr/perso/nrougier/teaching/matplotlib/>`_
  by Nicolas P. Rougier

* `Anatomy of Matplotlib - IPython Notebooks
  <https://github.com/WeatherGod/AnatomyOfMatplotlib>`_
  by Benjamin Root

* `Beyond the Basics: Data Visualization in Python
  <https://github.com/stefmolin/python-data-viz-workshop>`_
  by Stefanie Molin

=========
Galleries
=========

* `Past winners for JDH plotting contest <https://jhepc.github.io/gallery.html>`_
  by Nelle Varoquaux

* `The Python Graph Gallery <https://www.python-graph-gallery.com>`_
  by Yan Holtz