matplotlib · timhoffm · Aug 2, 2024 · Aug 1, 2024 · timhoffm · Aug 1, 2024
diff --git a/galleries/examples/animation/pause_resume.py b/galleries/examples/animation/pause_resume.py
@@ -1,7 +1,7 @@
 """
-=================================
-Pausing and resuming an animation
-=================================
+=============================
+Pause and resume an animation
+=============================
 
 This example showcases:
 

diff --git a/galleries/examples/axes_grid1/demo_axes_rgb.py b/galleries/examples/axes_grid1/demo_axes_rgb.py
@@ -1,7 +1,7 @@
 """
-==================================
-Showing RGB channels using RGBAxes
-==================================
+===============================
+Show RGB channels using RGBAxes
+===============================
 
 `~.axes_grid1.axes_rgb.RGBAxes` creates a layout of 4 Axes for displaying RGB
 channels: one large Axes for the RGB image and 3 smaller Axes for the R, G, B

diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
@@ -1,9 +1,9 @@
 """
 .. _demo-colorbar-with-inset-locator:
 
-==============================================================
-Controlling the position and size of colorbars with Inset Axes
-==============================================================
+===========================================================
+Control the position and size of a colorbar with Inset Axes
+===========================================================
 
 This example shows how to control the position, height, and width of colorbars
 using `~mpl_toolkits.axes_grid1.inset_locator.inset_axes`.

diff --git a/galleries/examples/axes_grid1/demo_imagegrid_aspect.py b/galleries/examples/axes_grid1/demo_imagegrid_aspect.py
@@ -1,6 +1,6 @@
 """
 =========================================
-Setting a fixed aspect on ImageGrid cells
+ImageGrid cells with a fixed aspect ratio
 =========================================
 """
 

diff --git a/galleries/examples/color/custom_cmap.py b/galleries/examples/color/custom_cmap.py
@@ -1,7 +1,7 @@
 """
-=========================================
-Creating a colormap from a list of colors
-=========================================
+=======================================
+Create a colormap from a list of colors
+=======================================
 
 For more detail on creating and manipulating colormaps see
 :ref:`colormap-manipulation`.

diff --git a/galleries/examples/images_contours_and_fields/image_annotated_heatmap.py b/galleries/examples/images_contours_and_fields/image_annotated_heatmap.py
@@ -1,7 +1,7 @@
 """
-===========================
-Creating annotated heatmaps
-===========================
+=================
+Annotated heatmap
+=================
 
 It is often desirable to show data which depends on two independent
 variables as a color coded image plot. This is often referred to as a

diff --git a/galleries/examples/lines_bars_and_markers/bar_colors.py b/galleries/examples/lines_bars_and_markers/bar_colors.py
@@ -1,7 +1,7 @@
 """
-==============
-Bar color demo
-==============
+====================================
+Bar chart with individual bar colors
+====================================
 
 This is an example showing how to control bar color and legend entries
 using the *color* and *label* parameters of `~matplotlib.pyplot.bar`.

diff --git a/galleries/examples/lines_bars_and_markers/fill_between_alpha.py b/galleries/examples/lines_bars_and_markers/fill_between_alpha.py
@@ -1,7 +1,7 @@
 """
-==============================
-Fill Between with transparency
-==============================
+==================================
+``fill_between`` with transparency
+==================================
 
 The `~matplotlib.axes.Axes.fill_between` function generates a shaded
 region between a min and max boundary that is useful for illustrating ranges.

diff --git a/galleries/examples/lines_bars_and_markers/fill_between_demo.py b/galleries/examples/lines_bars_and_markers/fill_between_demo.py
@@ -1,7 +1,7 @@
 """
-==============================
-Filling the area between lines
-==============================
+===============================
+Fill the area between two lines
+===============================
 
 This example shows how to use `~.axes.Axes.fill_between` to color the area
 between two lines.

diff --git a/galleries/examples/lines_bars_and_markers/fill_betweenx_demo.py b/galleries/examples/lines_bars_and_markers/fill_betweenx_demo.py
@@ -1,7 +1,7 @@
 """
-==================
-Fill Betweenx Demo
-==================
+========================================
+Fill the area between two vertical lines
+========================================
 
 Using `~.Axes.fill_betweenx` to color along the horizontal direction between
 two curves.

diff --git a/galleries/examples/lines_bars_and_markers/line_demo_dash_control.py b/galleries/examples/lines_bars_and_markers/line_demo_dash_control.py
@@ -1,7 +1,7 @@
 """
-==============================
-Customizing dashed line styles
-==============================
+===============================
+Dashed line style configuration
+===============================
 
 The dashing of a line is controlled via a dash sequence. It can be modified
 using `.Line2D.set_dashes`.

diff --git a/galleries/examples/lines_bars_and_markers/scatter_masked.py b/galleries/examples/lines_bars_and_markers/scatter_masked.py
@@ -1,7 +1,7 @@
 """
-==========================
-Scatter with masked values
-==========================
+===============================
+Scatter plot with masked values
+===============================
 
 Mask some data points and add a line demarking
 masked regions.

diff --git a/galleries/examples/lines_bars_and_markers/scatter_with_legend.py b/galleries/examples/lines_bars_and_markers/scatter_with_legend.py
@@ -1,7 +1,7 @@
 """
-===========================
-Scatter plots with a legend
-===========================
+==========================
+Scatter plot with a legend
+==========================
 
 To create a scatter plot with a legend one may use a loop and create one
 `~.Axes.scatter` plot per item to appear in the legend and set the ``label``

diff --git a/galleries/examples/lines_bars_and_markers/timeline.py b/galleries/examples/lines_bars_and_markers/timeline.py
@@ -1,7 +1,7 @@
 """
-===============================================
-Creating a timeline with lines, dates, and text
-===============================================
+====================================
+Timeline with lines, dates, and text
+====================================
 
 How to create a simple timeline using Matplotlib release dates.
 

diff --git a/galleries/examples/misc/bbox_intersect.py b/galleries/examples/misc/bbox_intersect.py
@@ -1,7 +1,7 @@
 """
-===========================================
-Changing colors of lines intersecting a box
-===========================================
+==================================
+Identify whether artists intersect
+==================================
 
 The lines intersecting the rectangle are colored in red, while the others
 are left as blue lines. This example showcases the `.intersects_bbox` function.

diff --git a/galleries/examples/misc/demo_ribbon_box.py b/galleries/examples/misc/demo_ribbon_box.py
@@ -1,6 +1,6 @@
 """
 ==========
-Ribbon Box
+Ribbon box
 ==========
 
 """

diff --git a/galleries/examples/misc/fig_x.py b/galleries/examples/misc/fig_x.py
@@ -1,9 +1,10 @@
 """
-=======================
-Adding lines to figures
-=======================
+==============================
+Add lines directly to a figure
+==============================
 
-Adding lines to a figure without any Axes.
+You can add artists such as a `.Line2D` directly to a figure. This is
+typically useful for visual structuring.
 
 .. redirect-from:: /gallery/pyplots/fig_x
 """
@@ -12,9 +13,9 @@
 
 import matplotlib.lines as lines
 
-fig = plt.figure()
-fig.add_artist(lines.Line2D([0, 1], [0, 1]))
-fig.add_artist(lines.Line2D([0, 1], [1, 0]))
+fig, axs = plt.subplots(2, 2, gridspec_kw={'hspace': 0.4, 'wspace': 0.4})
+fig.add_artist(lines.Line2D([0, 1], [0.47, 0.47], linewidth=3))
+fig.add_artist(lines.Line2D([0.5, 0.5], [1, 0], linewidth=3))
 plt.show()
 
 # %%

diff --git a/galleries/examples/misc/fill_spiral.py b/galleries/examples/misc/fill_spiral.py
@@ -1,6 +1,6 @@
 """
 ===========
-Fill Spiral
+Fill spiral
 ===========
 
 """

diff --git a/galleries/examples/pie_and_polar_charts/pie_and_donut_labels.py b/galleries/examples/pie_and_polar_charts/pie_and_donut_labels.py
@@ -1,7 +1,7 @@
 """
-==========================
-Labeling a pie and a donut
-==========================
+=============================
+A pie and a donut with labels
-A pie and a donut with labels
+Annotated pie and donut charts
-A pie and a donut with labels
+Annotated pie and donut charts
+=============================
 
 Welcome to the Matplotlib bakery. We will create a pie and a donut
 chart through the `pie method <matplotlib.axes.Axes.pie>` and

diff --git a/galleries/examples/shapes_and_collections/line_collection.py b/galleries/examples/shapes_and_collections/line_collection.py
@@ -1,7 +1,7 @@
 """
-=============================================
-Plotting multiple lines with a LineCollection
-=============================================
+==========================================
+Plot multiple lines using a LineCollection
-Plot multiple lines using a LineCollection
+Multiple lines using a LineCollection
-Plot multiple lines using a LineCollection
+Multiple lines using a LineCollection
+==========================================
 
 Matplotlib can efficiently draw multiple lines at once using a `~.LineCollection`.
 """

diff --git a/galleries/examples/statistics/errorbars_and_boxes.py b/galleries/examples/statistics/errorbars_and_boxes.py
@@ -1,7 +1,7 @@
 """
-====================================================
-Creating boxes from error bars using PatchCollection
-====================================================
+==================================================
+Create boxes from error bars using PatchCollection
+==================================================
 
 In this example, we snazz up a pretty standard error bar plot by adding
 a rectangle patch defined by the limits of the bars in both the x- and

diff --git a/galleries/examples/statistics/histogram_cumulative.py b/galleries/examples/statistics/histogram_cumulative.py
@@ -1,7 +1,7 @@
 """
-=================================
-Plotting cumulative distributions
-=================================
+========================
+Cumulative distributions
+========================
 
 This example shows how to plot the empirical cumulative distribution function
 (ECDF) of a sample. We also show the theoretical CDF.

diff --git a/galleries/examples/statistics/multiple_histograms_side_by_side.py b/galleries/examples/statistics/multiple_histograms_side_by_side.py
@@ -1,7 +1,7 @@
 """
-==========================================
-Producing multiple histograms side by side
-==========================================
+================================
+Multiple histograms side by side
-Multiple histograms side by side
+Grid of histograms
-Multiple histograms side by side
+Grid of histograms
+================================
 
 This example plots horizontal histograms of different samples along
 a categorical x-axis. Additionally, the histograms are plotted to

diff --git a/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py b/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py
@@ -1,7 +1,7 @@
 """
-===============================================
-Programmatically controlling subplot adjustment
-===============================================
+===========================================
+Programmatically control subplot adjustment
-Programmatically control subplot adjustment
+Custom subplot layout adjuster
-Programmatically control subplot adjustment
+Custom subplot layout adjuster
+===========================================
 
 .. note::
 

diff --git a/galleries/examples/subplots_axes_and_figures/axhspan_demo.py b/galleries/examples/subplots_axes_and_figures/axhspan_demo.py
@@ -1,7 +1,7 @@
 """
-=================================
-Drawing regions that span an Axes
-=================================
+==============================
+Draw regions that span an Axes
+==============================
 
 `~.Axes.axhspan` and `~.Axes.axvspan` draw rectangles that span the Axes in either
 the horizontal or vertical direction and are bounded in the other direction. They are

diff --git a/galleries/examples/subplots_axes_and_figures/demo_constrained_layout.py b/galleries/examples/subplots_axes_and_figures/demo_constrained_layout.py
@@ -1,7 +1,7 @@
 """
-=====================================
-Resizing Axes with constrained layout
-=====================================
+===================================
+Resize Axes with constrained layout
+===================================
 
 *Constrained layout* attempts to resize subplots in
 a figure so that there are no overlaps between Axes objects and labels

diff --git a/galleries/examples/subplots_axes_and_figures/demo_tight_layout.py b/galleries/examples/subplots_axes_and_figures/demo_tight_layout.py
@@ -1,7 +1,7 @@
 """
-===============================
-Resizing Axes with tight layout
-===============================
+=============================
+Resize Axes with tight layout
+=============================
 
 `~.Figure.tight_layout` attempts to resize subplots in a figure so that there
 are no overlaps between Axes objects and labels on the Axes.

diff --git a/galleries/examples/subplots_axes_and_figures/ganged_plots.py b/galleries/examples/subplots_axes_and_figures/ganged_plots.py
@@ -1,7 +1,7 @@
 """
-==========================
-Creating adjacent subplots
-==========================
+=================
+Adjacent subplots
+=================
 
 To create plots that share a common axis (visually) you can set the hspace
 between the subplots to zero. Passing sharex=True when creating the subplots

diff --git a/galleries/examples/subplots_axes_and_figures/gridspec_and_subplots.py b/galleries/examples/subplots_axes_and_figures/gridspec_and_subplots.py
@@ -1,7 +1,7 @@
 """
-==================================================
-Combining two subplots using subplots and GridSpec
-==================================================
+================================================
+Combine two subplots using subplots and GridSpec
+================================================
 
 Sometimes we want to combine two subplots in an Axes layout created with
 `~.Figure.subplots`.  We can get the `~.gridspec.GridSpec` from the Axes

diff --git a/galleries/examples/subplots_axes_and_figures/gridspec_multicolumn.py b/galleries/examples/subplots_axes_and_figures/gridspec_multicolumn.py
@@ -1,7 +1,7 @@
 """
-=======================================================
-Using Gridspec to make multi-column/row subplot layouts
-=======================================================
+=============================================
+Gridspec for multi-column/row subplot layouts
-Gridspec for multi-column/row subplot layouts
+Multi-column and row subplot layouts using Gridspec
-Gridspec for multi-column/row subplot layouts
+Multi-column and row subplot layouts using Gridspec
+=============================================
 
 `.GridSpec` is a flexible way to layout
 subplot grids.  Here is an example with a 3x3 grid, and

diff --git a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
@@ -1,7 +1,7 @@
 """
-===================================
-Managing multiple figures in pyplot
-===================================
+=================================
+Manage multiple figures in pyplot
+=================================
 
 `matplotlib.pyplot` uses the concept of a *current figure* and *current Axes*.
 Figures are identified via a figure number that is passed to `~.pyplot.figure`.

diff --git a/galleries/examples/subplots_axes_and_figures/share_axis_lims_views.py b/galleries/examples/subplots_axes_and_figures/share_axis_lims_views.py
@@ -1,6 +1,7 @@
 """
-Sharing axis limits and views
-=============================
+===========================
+Share axis limits and views
+===========================
 
 It's common to make two or more plots which share an axis, e.g., two subplots
 with time as a common axis.  When you pan and zoom around on one, you want the

diff --git a/galleries/examples/subplots_axes_and_figures/subplots_demo.py b/galleries/examples/subplots_axes_and_figures/subplots_demo.py
@@ -1,7 +1,7 @@
 """
-=================================================
-Creating multiple subplots using ``plt.subplots``
-=================================================
+===============================================
+Create multiple subplots using ``plt.subplots``
+===============================================
 
 `.pyplot.subplots` creates a figure and a grid of subplots with a single call,
 while providing reasonable control over how the individual plots are created.

diff --git a/galleries/examples/text_labels_and_annotations/autowrap.py b/galleries/examples/text_labels_and_annotations/autowrap.py
@@ -1,10 +1,10 @@
 """
-==================
-Auto-wrapping text
-==================
+==============
+Auto-wrap text
+==============
 
-Matplotlib can wrap text automatically, but if it's too long, the text will be
-displayed slightly outside of the boundaries of the axis anyways.
+Matplotlib can wrap text automatically, but if it's too long, the text will
+still be displayed slightly outside the boundaries of the axis.
 
 Note: Auto-wrapping does not work together with
 ``savefig(..., bbox_inches='tight')``. The 'tight' setting rescales the canvas

diff --git a/galleries/examples/text_labels_and_annotations/engineering_formatter.py b/galleries/examples/text_labels_and_annotations/engineering_formatter.py
@@ -1,7 +1,7 @@
 """
-=========================================
-Labeling ticks using engineering notation
-=========================================
+=======================================
+Format ticks using engineering notation
+=======================================
 
 Use of the engineering Formatter.
 """