Matplotlib turns Python data into static, animated, and interactive visualizations. Start with a Figure and Axes, plot data with an Axes method, and make the result useful by adding labels, choosing suitable scales, and saving it in the format your work needs. This guide builds from a first line plot to reusable multi-panel code and selected advanced techniques.
Install Matplotlib and make your first plot
For a standard Python environment, install Matplotlib with pip:
python -m pip install -U matplotlibOther documented package-manager options include conda install -c conda-forge matplotlib, pixi add matplotlib, and uv add matplotlib. Installation and compatibility details can change; consult the official installation guide if a command fails or you need version-specific instructions.
This complete example creates a small dataset, draws a line, labels it, and displays the figure:
#1 Best Overall
import matplotlib.pyplot as plt
x = [0, 1, 2, 3, 4]
y = [0, 1, 4, 9, 16]
fig, ax = plt.subplots()
ax.plot(x, y, label="y = x squared")
ax.set_title("A simple line plot")
ax.set_xlabel("x")
ax.set_ylabel("y")
ax.legend()
plt.show()plt.subplots() returns a Figure and an Axes. The Axes receives the data and labels; plt.show() asks the active display setup to show the result. In a notebook or another environment that renders figures automatically, an explicit call to show() may not be necessary.
Understand Figure, Axes, Axis, and Artist
Matplotlib’s object model is easier to use once its similar-sounding terms are separated:
- Figure: the overall container for a visualization. A figure can contain one or several Axes.
- Axes: a plotting area where data, labels, legends, and other plot elements are configured. A single Figure can hold a grid of Axes.
- Axis: an individual x- or y-axis object that manages details such as scale and tick placement. “Axes” means the plotting area; “Axis” means one coordinate axis.
- Artist: the general term for visible elements in a figure, including lines, text, and other drawn objects.
In the first example, fig is the Figure and ax is the Axes. Calls such as ax.plot() and ax.set_xlabel() configure that plotting area. This distinction is central to the Matplotlib quick-start guide.
Choose pyplot or the explicit Figure/Axes interface
Matplotlib offers two closely related ways to write plotting code. Choose based on how much structure the work needs, rather than treating one as universally correct.
Recommended Free Tools
| Approach | Explicitness | Quick exploration | Reusable or multi-panel code | Helper functions |
|---|---|---|---|---|
| pyplot state-based calls | Lower: calls such as plt.plot() act on the current plotting state. |
Convenient for short, interactive experiments. | Can become harder to manage as figures and subplots accumulate. | Plotting logic is less explicit about which Axes it modifies. |
| Explicit Figure/Axes calls | Higher: retain fig and ax, then call methods such as ax.plot(). |
Works for exploration, though it requires naming the objects. | Well suited to complex figures, multiple Axes, and reusable scripts. | Pass an Axes into a helper so the function knows exactly where to draw. |
For a quick experiment, pyplot can be concise:
import matplotlib.pyplot as plt
plt.plot([0, 1, 2], [0, 1, 4])
plt.xlabel("x")
plt.ylabel("y")
plt.show()For code that will grow or be called repeatedly, make the Axes an explicit input:
import matplotlib.pyplot as plt
def add_measurement(ax, x, y, label):
ax.plot(x, y, label=label)
ax.set_xlabel("Time")
ax.set_ylabel("Measurement")
fig, ax = plt.subplots()
add_measurement(ax, [0, 1, 2], [2, 3, 5], "Sample")
ax.legend()
plt.show()The helper can now draw into a caller-provided Axes, which also makes it easier to reuse the same plotting logic in different figures. The quick-start guide recommends the explicit object-oriented style for complicated plots and reusable scripts; avoid old pylab examples, which the documentation describes as strongly deprecated.
Make a chart clear and readable
Label the message, not just the variables
A title should tell readers what the figure shows, and axis labels should include meaningful names and units where applicable. If a line or marker represents a series, give it a descriptive label and call ax.legend() so the mapping is visible. Labels such as “Sales (USD)” communicate more than “y.”
Choose scales and ticks deliberately
Scales and tick locations shape how a reader interprets values. Use a scale appropriate to the data and make ticks legible rather than allowing dense labels to crowd the plot. String values can be interpreted as categorical positions; plotting many distinct strings may create an excessive number of ticks. For dense categories, consider showing a smaller meaningful subset or adjusting the figure layout.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Use color, annotations, and multiple Axes with purpose
Use color to distinguish related data series, not as a substitute for labels. An annotation can point out a specific value or event that matters to the reader. When comparisons need different scales or separate visual space, put them in separate Axes within one Figure rather than forcing everything into one plot.
For example, two panels can share the same x values while retaining separate y labels:
import matplotlib.pyplot as plt
x = [0, 1, 2, 3]
values_a = [2, 4, 3, 6]
values_b = [10, 8, 11, 9]
fig, axes = plt.subplots(2, 1, sharex=True)
axes[0].plot(x, values_a, color="tab:blue")
axes[0].set_ylabel("Series A")
axes[1].plot(x, values_b, color="tab:orange")
axes[1].set_ylabel("Series B")
axes[1].set_xlabel("Time")
fig.suptitle("Two measurements over time")
fig.tight_layout()
plt.show()Each entry in axes is an Axes, so the same explicit method calls apply to both panels. Matplotlib’s quick-start material covers labels, legends, scales, ticks, and subplot arrangements in more depth.
Display a figure or save it to a file
Displaying a window and writing a file are different tasks. A window depends on an interactive backend and the GUI support available in the current environment. File output can use a non-interactive backend; documented examples include Agg, ps, pdf, and svg. Backend and optional-dependency requirements vary by system and workflow, so a working file export does not guarantee that a desktop window can open.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitchesTo save a figure, call savefig on the Figure and choose a filename with the desired format extension:
fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 1, 4])
ax.set_xlabel("x")
ax.set_ylabel("y")
fig.savefig("plot.png")
fig.savefig("plot.svg")PNG is a raster image; SVG is a vector format. Matplotlib also supports other image and vector output formats. Certain GUI frameworks, formats, LaTeX rendering, or animation workflows may require optional dependencies. If plt.show() does not open a window, check the official installation and backend guidance for the environment in use.
Move from plotting basics to advanced Matplotlib
You do not need advanced features to make a sound first chart. Add them when the plot’s purpose calls for them, following the progression in the official tutorials.
- Styles and rcParams: apply a consistent look across figures or configure defaults for a project.
- Layout and legends: manage spacing and legend placement as the figure gains panels or annotations.
- Transforms and paths: control how elements are positioned or constructed beyond the simplest data-coordinate plots.
- Path effects: adjust the rendering of visual elements for specific presentation needs.
- Animation: create changing visualizations; check the relevant workflow’s dependencies and output requirements.
- Faster rendering: techniques such as blitting can help with animation and repeated updates, but are an optimization layer rather than a prerequisite for ordinary plots.
The Matplotlib documentation describes the library as supporting static, animated, and interactive visualizations and links to further learning resources. Start with the Figure/Axes model, then learn only the advanced features that solve a concrete presentation or performance problem.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
