Matplotlib — Comprehensive Visualization Library for Python

What it is

Matplotlib is the original and most comprehensive plotting library in Python. Created in 2003, it produces static, animated, and interactive visualizations. Libraries like seaborn, pandas plotting, and scikit-learn visualization are built on top of Matplotlib.

The library targets data scientists, researchers, and engineers who need publication-quality figures. It supports line plots, scatter plots, bar charts, histograms, heatmaps, 3D surfaces, and dozens of other plot types.

How it saves time or tokens

Matplotlib provides a single API for all plot types, so you learn one library and apply it everywhere. The pyplot interface mimics MATLAB, making it accessible to users coming from that ecosystem. For AI workflows, Matplotlib is the default rendering engine when you call .plot() on a pandas DataFrame or visualize model metrics in scikit-learn.

Saving figures to PNG, PDF, or SVG is a one-line call, which simplifies report generation in automated pipelines.

How to use

1. Install with pip install matplotlib.
2. Import matplotlib.pyplot as plt and create plots using functions like plt.plot(), plt.scatter(), or plt.bar().
3. Save with plt.savefig('output.png') or display interactively with plt.show().

Example

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 2 * np.pi, 100)
plt.figure(figsize=(8, 4))
plt.plot(x, np.sin(x), label='sin(x)')
plt.plot(x, np.cos(x), label='cos(x)')
plt.xlabel('x')
plt.ylabel('y')
plt.title('Trigonometric Functions')
plt.legend()
plt.grid(True)
plt.savefig('trig_plot.png', dpi=150)

Related on TokRepo

• AI tools for research -- Data analysis and visualization tools
• AI tools for coding -- Python development libraries

Common pitfalls

• The pyplot state machine can produce unexpected results when creating multiple figures in a loop. Use the object-oriented API (fig, ax = plt.subplots()) for scripts that generate many plots.
• Matplotlib renders plots in a GUI window by default. In headless environments like servers or Docker containers, set matplotlib.use('Agg') before importing pyplot to use the non-interactive backend.
• Large datasets with millions of points cause slow rendering. Downsample your data or use rasterized=True for scatter plots to keep file sizes manageable.