Generate Publication-Quality Visualizations with Matplotlib

Matplotlib Visualization Guide covers static, animated, and interactive Python plotting through pyplot and the object-oriented Figure and Axes API. It explains the hierarchy of figures, plotting areas, visible artists, and axes that manage ticks and labels. Explicit object-oriented control is recommended for maintained code and complex figures, while pyplot remains convenient for quick exploration.

The workflow chooses an appropriate plot type, creates figure and axes objects, plots data, adds labels and legends, manages spacing, and saves or displays the result. Plot types include lines for trends, scatter plots for relationships, bars for categories, histograms for distributions, heatmaps for matrices, contours for surfaces, and box or violin plots for distribution comparisons.

Use it for scientific or statistical figures, customized charts, multiple panels, export to PNG, PDF, or SVG, interactive plotting, animation, or 3D visualization. Figure size is measured in inches rather than pixels, with resolution determining the exported pixel dimensions.

Avoid relying on implicit pyplot state for complicated figures. Close figures explicitly when generating many outputs, and choose layout management to prevent overlapping elements. Helper examples require compatible dependencies; the current examples use Matplotlib 3.10 or later for tick_labels and orientation. Select a new path when saving a style because the helper refuses to overwrite existing styles or previews.

Inputs include arrays or DataFrames, plot-type requirements, labels, styles, and the target output medium. Outputs include individual charts, grid or mosaic layouts, GridSpec arrangements, vector exports, transparent images, and 3D surfaces, scatter plots, or lines. A minimal explicit plot is:

import matplotlib.pyplot as plt

fig, ax = plt.subplots()
ax.plot([1, 2, 3, 4])
ax.set_ylabel('some numbers')
plt.show()

Styling uses named or numeric colors, colormaps, style sheets, rcParams, text, and annotations. Sequential maps suit ordered values, diverging maps suit meaningful centers, and qualitative maps suit categories. Colorblind-friendly choices, contrast, hatching, descriptive labels, and legends improve accessibility. Avoid perceptually uneven rainbow maps.

Export settings control DPI, whitespace, background color, and transparency. Large data can benefit from downsampling or rasterized elements, while animations can use blitting. Reusable plotting functions can return figure and axes objects for further customization.

NumPy and pandas supply plotting data, Seaborn builds higher-level statistics, Jupyter supports inline or widget interaction, and GUI frameworks can embed figures. The plot-template and style-configurator helpers support repeatable setup; histogram modes additionally use SciPy. Saved previews accompany their style files. Troubleshooting covers spacing, state confusion, font configuration, memory use, and DPI interpretation.