Update matplotlib.md

This commit is contained in:
SANAULLAH authored and GitHub committed 2026-07-19 13:06:55 +05:00
1 parent 1a758e10f4
commit 44dec48c01
1 file changed
+306 -175
+306 -175
View File
@@ -1,38 +1,58 @@
---
title: 'Matplotlib'
date: 06-06-2025
title: Matplotlib
date: 2026-07-19
background: bg-[#1a073e]
tags:
- 'data visualization'
- 'matplotlib'
- 'plotting'
- data visualization
- matplotlib
- plotting
categories:
- 'Python'
- Python
intro: |
[Matplotlib](https://matplotlib.org/) is a comprehensive library for creating static, animated, and interactive plots in Python.
This cheat sheet provides a quick reference from basic to advanced usage, covering essential features for data science, machine learning, and scientific computing.
[Matplotlib](https://matplotlib.org/) is a comprehensive library for creating static, animated, and interactive plots in Python.
This cheat sheet provides a production-grade reference for matplotlib ≥3.8 with emphasis on publication-quality figures, OOP interface, and performance optimization.
plugins:
- copyCode
---
---
## Getting Started {.cols-2}
### Importing
### Import Convention
```python
import matplotlib.pyplot as plt # Core plotting library
import numpy as np # For numerical operations
import matplotlib.pyplot as plt
import numpy as np
# For high-quality figures
plt.rcParams['figure.dpi'] = 120
plt.rcParams['savefig.dpi'] = 300
plt.rcParams['font.size'] = 10
plt.rcParams['axes.labelsize'] = 12
plt.rcParams['axes.titlesize'] = 14
plt.rcParams['legend.fontsize'] = 10
```
### Two Interfaces
| Description | Code |
|-------------|------|
| Pyplot (procedural) - quick | `plt.plot(x, y); plt.show()` |
| OOP (explicit) - production | `fig, ax = plt.subplots(); ax.plot(x, y); fig.savefig('fig.pdf')` |
| Create figure and axes | `fig, ax = plt.subplots(figsize=(8, 6))` |
| Create figure with grid | `fig, axes = plt.subplots(2, 2, figsize=(10, 8))` |
| Get current figure/axes | `fig = plt.gcf(); ax = plt.gca()` |
### Basic Plot
```python
x = np.linspace(0, 10, 100) # 100 points between 0 and 10
y = np.sin(x) # Sine function values
plt.plot(x, y) # Create a line plot
plt.show() # Display the plot
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)
ax.set_title("Sine Wave")
ax.set_xlabel("x")
ax.set_ylabel("sin(x)")
plt.show()
```
---
@@ -41,226 +61,337 @@ plt.show() # Display the plot
### Line Plot
```python
plt.plot(x, y) # Line plot of y vs x
plt.title("Sine Wave") # Set title
plt.xlabel("x-axis") # Label x-axis
plt.ylabel("y-axis") # Label y-axis
plt.grid(True) # Show gridlines
plt.show()
```
| Description | Code |
|-------------|------|
| Simple line plot | `ax.plot(x, y)` |
| With custom style | `ax.plot(x, y, 'r--o', linewidth=2, markersize=4)` |
| Multiple series | `ax.plot(x, y1, label='sin'); ax.plot(x, y2, label='cos'); ax.legend()` |
| Step plot | `ax.step(x, y, where='mid')` |
| Stacked lines | `ax.stackplot(x, y1, y2, labels=['A','B'])` |
| Fill between | `ax.fill_between(x, y1, y2, alpha=0.3)` |
### Scatter Plot
```python
plt.scatter(x, y) # Scatter plot
plt.title("Scatter Plot")
plt.show()
```
| Description | Code |
|-------------|------|
| Basic scatter | `ax.scatter(x, y)` |
| Scatter with sizes | `ax.scatter(x, y, s=sizes, c=colors, alpha=0.6, cmap='viridis')` |
| Scatter with categorical colors | `ax.scatter(x, y, c=labels, cmap='Set1', edgecolors='black')` |
| 3D scatter | `ax.scatter3D(x, y, z, c=z, cmap='viridis')` |
### Bar Plot
### Bar Charts
```python
categories = ['A', 'B', 'C']
values = [10, 20, 15]
plt.bar(categories, values) # Vertical bar chart
plt.title("Bar Chart")
plt.show()
```
| Description | Code |
|-------------|------|
| Vertical bar | `ax.bar(categories, values, width=0.8, color='steelblue')` |
| Horizontal bar | `ax.barh(categories, values, height=0.8)` |
| Grouped bar | `ax.bar(x - width/2, y1, width, label='A'); ax.bar(x + width/2, y2, width, label='B')` |
| Stacked bar | `ax.bar(x, y1, label='A'); ax.bar(x, y2, bottom=y1, label='B')` |
| Error bars | `ax.bar(x, y, yerr=errors, capsize=5)` |
### Horizontal Bar Plot
### Histograms
```python
plt.barh(categories, values) # Horizontal bar chart
plt.title("Horizontal Bar Chart")
plt.show()
```
| Description | Code |
|-------------|------|
| Basic histogram | `ax.hist(data, bins=30, edgecolor='black')` |
| Multiple histograms | `ax.hist([data1, data2], bins=30, label=['A','B'], alpha=0.6)` |
| Density (normalized) | `ax.hist(data, bins=30, density=True, histtype='step')` |
| Cumulative | `ax.hist(data, bins=30, cumulative=True, histtype='step')` |
| 2D histogram | `ax.hist2d(x, y, bins=30, cmap='viridis')` |
### Histogram
### Pie Charts
```python
data = np.random.randn(1000) # Random normal distribution
plt.hist(data, bins=30) # Histogram with 30 bins
plt.title("Histogram")
plt.show()
```
| Description | Code |
|-------------|------|
| Basic pie | `ax.pie(sizes, labels=labels, autopct='%1.1f%%')` |
| Exploded pie | `ax.pie(sizes, labels=labels, explode=(0, 0.1, 0, 0), shadow=True)` |
| Donut chart | `ax.pie(sizes, labels=labels, wedgeprops=dict(width=0.3))` |
| Custom colors | `ax.pie(sizes, labels=labels, colors=plt.cm.Set3(range(len(sizes))))` |
### Pie Chart
### Box Plots
```python
sizes = [25, 35, 20, 20]
labels = ['A', 'B', 'C', 'D']
plt.pie(sizes, labels=labels, autopct='%1.1f%%') # Pie chart with % labels
plt.title("Pie Chart")
plt.show()
```
| Description | Code |
|-------------|------|
| Basic box plot | `ax.boxplot(data)` |
| Grouped box plots | `ax.boxplot([data1, data2, data3], labels=['A','B','C'])` |
| With notches | `ax.boxplot(data, notch=True, patch_artist=True)` |
| Violin plot | `ax.violinplot(data, showmeans=True, showmedians=True)` |
---
## Customization {.row-span-2}
| Feature | Code Example | Description |
| --------------- | ------------------------------------------------------------------------------------ | ------------------------------------------- |
| Title | `plt.title("Title")` | Set the title of the plot |
| X/Y Labels | `plt.xlabel("X")`, `plt.ylabel("Y")` | Label the axes |
| Grid | `plt.grid(True)` | Show grid |
| Legend | `plt.legend(["line1"])` | Add legend |
| Line Style | `plt.plot(x, y, linestyle='--')` | Dashed line |
| Color | `plt.plot(x, y, color='green')` | Set line color |
| Marker | `plt.plot(x, y, marker='o')` | Show markers on points |
| Axis Limits | `plt.xlim(0, 10)`, `plt.ylim(-1, 1)` | Set axis range |
| Tick Labels | `plt.xticks([...])`, `plt.yticks([...])` | Customize tick positions |
| Text Annotation | `plt.text(5, 0, "Midpoint")` | Add text at a specific coordinate |
| Arrow | `plt.annotate("Peak", xy=(7, 1), xytext=(6, 1.5), arrowprops=dict(arrowstyle="->"))` | Add annotation arrow |
| Style Sheets | `plt.style.use('ggplot')` | Use predefined styles like `seaborn`, `bmh` |
### Figure Elements
| Description | Code |
|-------------|------|
| Title | `ax.set_title("Title", fontsize=14, fontweight='bold')` |
| Axis labels | `ax.set_xlabel("X Label", fontsize=12); ax.set_ylabel("Y Label")` |
| Axis limits | `ax.set_xlim(0, 10); ax.set_ylim(-1.5, 1.5)` |
| Grid | `ax.grid(True, linestyle='--', alpha=0.7)` |
| Legend | `ax.legend(loc='best', frameon=True, fancybox=True, shadow=True)` |
| Legend outside | `ax.legend(bbox_to_anchor=(1.05, 1), loc='upper left')` |
### Line & Marker Styles
| Description | Code |
|-------------|------|
| Linestyles | `'-'`, `'--'`, `'-.'`, `':'` |
| Markers | `'.'`, `'o'`, `'v'`, `'^'`, `'s'`, `'*'`, `'+'`, `'x'` |
| Color specification | `'r'`, `'#FF5733'`, `(0.2, 0.4, 0.6)`, `'red'` |
| Line width | `linewidth=2` or `lw=2` |
| Marker size | `markersize=6` or `ms=6` |
| Transparency | `alpha=0.5` |
### Text & Annotations
| Description | Code |
|-------------|------|
| Add text | `ax.text(x, y, "Text", fontsize=10, ha='center', va='bottom')` |
| Annotate with arrow | `ax.annotate("Peak", xy=(7, 1), xytext=(6, 1.5), arrowprops=dict(arrowstyle='->', color='red'))` |
| Math expressions | `ax.text(5, 0.5, r'$E = mc^2$', fontsize=14)` |
| Formula in title | `ax.set_title(r'$\sin(x) + \cos(x)$')` |
### Ticks & Scales
| Description | Code |
|-------------|------|
| Custom ticks | `ax.set_xticks([0, 2, 4, 6, 8, 10])` |
| Custom tick labels | `ax.set_xticklabels(['zero', 'two', 'four', 'six', 'eight', 'ten'])` |
| Rotate ticks | `plt.xticks(rotation=45)` |
| Log scale | `ax.set_xscale('log'); ax.set_yscale('log')` |
| Symlog | `ax.set_xscale('symlog', linthresh=0.01)` |
| Twin axes | `ax2 = ax.twinx(); ax2.plot(x, y2, 'r-')` |
### Colormaps
| Description | Code |
|-------------|------|
| Sequential | `'viridis'`, `'plasma'`, `'inferno'`, `'magma'`, `'cividis'` |
| Diverging | `'RdBu'`, `'RdBu_r'`, `'coolwarm'`, `'seismic'` |
| Qualitative | `'Set1'`, `'Set2'`, `'Set3'`, `'tab10'`, `'tab20'` |
| Reversed | `'viridis_r'` |
| Use colormap | `plt.cm.viridis(np.linspace(0, 1, 10))` |
### Stylesheets
| Description | Code |
|-------------|------|
| Default | `plt.style.use('default')` |
| Seaborn | `plt.style.use('seaborn-v0_8')` |
| FiveThirtyEight | `plt.style.use('fivethirtyeight')` |
| GGPlot | `plt.style.use('ggplot')` |
| Dark background | `plt.style.use('dark_background')` |
| Publication | `plt.style.use('bmh')` |
| Available styles | `print(plt.style.available)` |
---
## Subplots & Layouts
## Subplots & Layouts {.row-span-2}
### Multiple Subplots
### Creating Subplots
```python
fig, axs = plt.subplots(2, 2) # Create 2x2 grid of subplots
axs[0, 0].plot(x, y) # Top-left subplot
axs[0, 1].scatter(x, y) # Top-right subplot
axs[1, 0].bar(categories, values) # Bottom-left subplot
axs[1, 1].hist(data) # Bottom-right subplot
plt.tight_layout() # Adjust spacing to prevent overlap
plt.show()
```
| Description | Code |
|-------------|------|
| 2x2 grid | `fig, axes = plt.subplots(2, 2, figsize=(10, 8))` |
| Access subplot | `axes[0, 0].plot(x, y)` |
| Flatten axes array | `axes_flat = axes.flatten()` |
| Share x-axis | `fig, axes = plt.subplots(2, 1, sharex=True)` |
| Share y-axis | `fig, axes = plt.subplots(2, 1, sharey=True)` |
| Add subplot manually | `ax = fig.add_subplot(2, 2, 1)` |
| GridSpec | `gs = fig.add_gridspec(2, 2, width_ratios=[1, 2], height_ratios=[1, 2])` |
| Span multiple cells | `ax = fig.add_subplot(gs[0, :])` |
### Figure Size
### Layout Adjustments
```python
plt.figure(figsize=(10, 5)) # Set figure size (width, height in inches)
```
| Description | Code |
|-------------|------|
| Automatic spacing | `plt.tight_layout(pad=1.5)` |
| Fine-tune spacing | `plt.subplots_adjust(left=0.1, right=0.9, top=0.9, bottom=0.1, wspace=0.3, hspace=0.3)` |
| Constrained layout | `fig, axes = plt.subplots(constrained_layout=True)` |
| Colorbar | `fig.colorbar(im, ax=axes, orientation='vertical', fraction=0.02, pad=0.02)` |
### Figure Size & DPI
| Description | Code |
|-------------|------|
| Set figure size | `fig = plt.figure(figsize=(8, 6))` |
| Set DPI | `fig.set_dpi(150)` |
| Auto-figure size | `fig.set_size_inches(8, 6)` |
| Save with DPI | `fig.savefig('fig.png', dpi=300, bbox_inches='tight')` |
---
## Advanced Visualizations {.cols-2}
### Heatmap
### Image & Heatmap
```python
data = np.random.rand(10, 10) # Random 10x10 matrix
plt.imshow(data, cmap='hot', interpolation='nearest') # Display as image
plt.colorbar() # Show color scale
plt.title("Heatmap")
plt.show()
```
| Description | Code |
|-------------|------|
| Display image | `ax.imshow(image, cmap='gray', interpolation='bilinear')` |
| Heatmap | `im = ax.imshow(matrix, cmap='hot', aspect='auto')` |
| Colorbar | `fig.colorbar(im, ax=ax, label='Intensity')` |
| Hide axes | `ax.axis('off')` |
| Aspect ratio | `ax.set_aspect('equal')` |
### Contour Plot
### Contour & Surface
```python
X, Y = np.meshgrid(x, x)
Z = np.sin(X) * np.cos(Y)
plt.contour(X, Y, Z) # Contour lines
plt.title("Contour Plot")
plt.show()
```
| Description | Code |
|-------------|------|
| Contour lines | `contour = ax.contour(X, Y, Z, levels=20, cmap='viridis')` |
| Filled contour | `ax.contourf(X, Y, Z, levels=20, cmap='viridis')` |
| Contour labels | `ax.clabel(contour, inline=True, fontsize=8)` |
| 3D surface | `ax.plot_surface(X, Y, Z, cmap='viridis', alpha=0.8)` |
| 3D wireframe | `ax.plot_wireframe(X, Y, Z, color='black', alpha=0.3)` |
### 3D Plot
### 3D Plots
```python
from mpl_toolkits.mplot3d import Axes3D
fig = plt.figure()
ax = fig.add_subplot(111, projection='3d') # 3D subplot
ax.plot3D(x, y, np.cos(x)) # 3D line
plt.title("3D Plot")
plt.show()
```
| Description | Code |
|-------------|------|
| Setup 3D axes | `from mpl_toolkits.mplot3d import Axes3D; fig = plt.figure(); ax = fig.add_subplot(111, projection='3d')` |
| 3D line | `ax.plot3D(x, y, z)` |
| 3D scatter | `ax.scatter3D(x, y, z, c=z, cmap='viridis')` |
| 3D bar | `ax.bar3d(x, y, z, dx, dy, dz)` |
| Set 3D view | `ax.view_init(elev=30, azim=45)` |
### Specialized Plots
| Description | Code |
|-------------|------|
| Error bars | `ax.errorbar(x, y, yerr=errors, xerr=x_errors, fmt='o', capsize=5)` |
| Stem plot | `ax.stem(x, y)` |
| Event plot | `ax.eventplot(data, lineoffsets=1, linelengths=0.5)` |
| Stream plot | `ax.streamplot(X, Y, U, V, density=1.5)` |
| Quiver (vector field) | `ax.quiver(x, y, u, v, scale=0.5)` |
| Polar plot | `ax = fig.add_subplot(111, projection='polar'); ax.plot(theta, r)` |
---
## Working with Images
```python
import matplotlib.image as mpimg
img = mpimg.imread('image.jpg') # Load image
plt.imshow(img) # Display image
plt.axis('off') # Hide axes
plt.title("Image Display")
plt.show()
```
| Description | Code |
|-------------|------|
| Load image | `import matplotlib.image as mpimg; img = mpimg.imread('image.jpg')` |
| Display image | `ax.imshow(img)` |
| Save image | `mpimg.imsave('output.jpg', img, dpi=300)` |
| Resize with interpolation | `ax.imshow(img, interpolation='bicubic')` |
| RGB channels | `red = img[:,:,0]; green = img[:,:,1]; blue = img[:,:,2]` |
---
## For Machine Learning
### Plotting Loss vs Epoch
### Training Curves
```python
epochs = range(1, 11)
loss = [0.9, 0.7, 0.5, 0.4, 0.3, 0.25, 0.2, 0.18, 0.15, 0.13]
plt.plot(epochs, loss)
plt.title("Training Loss")
plt.xlabel("Epoch")
plt.ylabel("Loss")
plt.show()
```
| Description | Code |
|-------------|------|
| Loss vs epochs | `ax.plot(epochs, train_loss, label='Train'); ax.plot(epochs, val_loss, label='Validation')` |
| Learning rate schedule | `ax.semilogy(epochs, learning_rates)` |
| Accuracy | `ax.plot(epochs, train_acc, 'b-', label='Train'); ax.plot(epochs, val_acc, 'r-', label='Val')` |
| Multiple metrics | `ax1 = ax.twinx(); ax1.plot(epochs, loss, 'r-')` |
### Confusion Matrix (Heatmap)
### Confusion Matrix
```python
from sklearn.metrics import confusion_matrix
import seaborn as sns
| Description | Code |
|-------------|------|
| Confusion matrix | `from sklearn.metrics import confusion_matrix; cm = confusion_matrix(y_true, y_pred)` |
| Heatmap | `im = ax.imshow(cm, cmap='Blues', interpolation='nearest')` |
| Annotate values | `for i in range(cm.shape[0]): for j in range(cm.shape[1]): ax.text(j, i, cm[i, j], ha='center', va='center')` |
| Normalized | `cm_norm = cm.astype('float') / cm.sum(axis=1)[:, np.newaxis]` |
y_true = [0, 1, 2, 2, 0]
y_pred = [0, 0, 2, 2, 1]
cm = confusion_matrix(y_true, y_pred) # Create confusion matrix
sns.heatmap(cm, annot=True, fmt='d', cmap='Blues') # Heatmap visualization
plt.title("Confusion Matrix")
plt.show()
```
### ROC & Precision-Recall
### ROC Curve
| Description | Code |
|-------------|------|
| ROC curve | `from sklearn.metrics import roc_curve, auc; fpr, tpr, _ = roc_curve(y_true, y_scores); auc_val = auc(fpr, tpr)` |
| ROC plot | `ax.plot(fpr, tpr, label=f'AUC = {auc_val:.2f}'); ax.plot([0,1], [0,1], 'k--')` |
| Precision-Recall | `from sklearn.metrics import precision_recall_curve; precision, recall, _ = precision_recall_curve(y_true, y_scores)` |
| PR plot | `ax.plot(recall, precision, label='PR Curve')` |
```python
from sklearn.metrics import roc_curve, auc
### Feature Analysis
fpr, tpr, _ = roc_curve([0, 0, 1, 1], [0.1, 0.4, 0.35, 0.8]) # Compute ROC
roc_auc = auc(fpr, tpr) # Area under curve
plt.plot(fpr, tpr, label=f'AUC = {roc_auc:.2f}')
plt.plot([0, 1], [0, 1], 'k--') # Diagonal line
plt.xlabel("False Positive Rate")
plt.ylabel("True Positive Rate")
plt.title("ROC Curve")
plt.legend()
plt.show()
```
| Description | Code |
|-------------|------|
| Feature importance | `ax.barh(feature_names, importances, color='steelblue')` |
| Correlation matrix | `im = ax.imshow(corr_matrix, cmap='RdBu_r', vmin=-1, vmax=1)` |
| Pairwise scatter | `import seaborn as sns; sns.pairplot(df)` |
| Parallel coordinates | `from pandas.plotting import parallel_coordinates; parallel_coordinates(df, 'class')` |
---
## Saving Plots
## Animations
```python
plt.savefig("figure.png", dpi=300, bbox_inches='tight') # Save plot to file
```
| Description | Code |
|-------------|------|
| Basic animation | `from matplotlib.animation import FuncAnimation; anim = FuncAnimation(fig, update, frames=100, interval=50)` |
| Save animation | `anim.save('animation.gif', writer='pillow', fps=20)` |
| Update function | `def update(frame): ax.clear(); ax.plot(x[:frame], y[:frame]); return ax,` |
| Interactive animation | `plt.ion(); fig, ax = plt.subplots(); ax.plot(x, y); plt.pause(0.01); plt.ioff()` |
---
## Saving & Exporting
### File Formats
| Description | Code |
|-------------|------|
| PNG (high DPI) | `fig.savefig('figure.png', dpi=300, bbox_inches='tight')` |
| PDF (vector) | `fig.savefig('figure.pdf', bbox_inches='tight')` |
| SVG (vector) | `fig.savefig('figure.svg', bbox_inches='tight')` |
| EPS (vector) | `fig.savefig('figure.eps', bbox_inches='tight')` |
| Transparent background | `fig.savefig('figure.png', transparent=True)` |
| With metadata | `fig.savefig('figure.pdf', metadata={'Author': 'Name', 'Title': 'Plot'})` |
### Publication Quality
| Description | Code |
|-------------|------|
| High-res for paper | `plt.rcParams['figure.dpi'] = 300` |
| Fonts for publication | `plt.rcParams['font.family'] = 'serif'; plt.rcParams['font.serif'] = ['Times New Roman']` |
| Multiple figures | `fig.savefig('figure.pdf', bbox_inches='tight', pad_inches=0.05)` |
| Size constraints | `fig = plt.figure(figsize=(3.4, 2.4))` (single column) |
---
## Show & Clear
```python
plt.show() # Show plot window
plt.clf() # Clear current figure (useful when plotting in loops)
plt.close() # Close figure window (useful in scripts or GUI apps)
```
| Description | Code |
|-------------|------|
| Display plot | `plt.show()` |
| Clear current figure | `plt.clf()` |
| Clear current axes | `plt.cla()` |
| Close all figures | `plt.close('all')` |
| Close specific figure | `plt.close(fig)` |
| Suppress display | `plt.ioff()` |
---
## More Useful Functions
## Performance & Memory
| Function | Use Case |
| ------------------------------ | ------------------------------- |
| `plt.fill_between(x, y1, y2)` | Fill area between curves |
| `plt.axhline(y=value)` | Draw horizontal line at y |
| `plt.axvline(x=value)` | Draw vertical line at x |
| `plt.errorbar(x, y, yerr=...)` | Plot with error bars |
| `plt.twinx()` | Create secondary y-axis |
| `plt.subplots_adjust(...)` | Manually adjust subplot spacing |
| `plt.gca()` | Get current axes |
| `plt.gcf()` | Get current figure |
| Description | Code |
|-------------|------|
| Fast plotting (AGG backend) | `import matplotlib; matplotlib.use('Agg')` |
| Interactive backend | `import matplotlib; matplotlib.use('TkAgg')` |
| Reduce memory | `ax.plot(x[::10], y[::10])` (downsample) |
| Efficient scatter | `ax.scatter(x, y, s=1)` (small markers) |
| Disable antialiasing | `ax.plot(x, y, antialiased=False)` |
| Batch plotting | `fig, axes = plt.subplots(2, 2); for ax in axes.flat: ax.plot(x, y)` |
---
## Common Pitfalls & Best Practices
| Pitfall | Solution |
|---------|----------|
| Mixing pyplot and OOP | Stick to one interface; prefer OOP for production |
| Overlapping legends | Place legend outside: `ax.legend(bbox_to_anchor=(1.05, 1), loc='upper left')` |
| Small fonts in publication | Set `plt.rcParams['font.size'] = 12` globally |
| Slow rendering | Downsample data or use `agg` backend |
| Figures cut off | Use `bbox_inches='tight'` in savefig |
| Memory leaks in loops | Use `plt.clf()` or `plt.close()` after each iteration |
| Inconsistent colormaps | Use same colormap for comparable visualizations |
| Missing axis labels | Always label for reproducibility |
| 3D plot overlapping | Adjust view with `ax.view_init()` |
---