Matplotlib Python数据可视化教程：从基础图表到高级定制，掌握科学绘图核心技能

matplotlib by davila7/claude-code-templates

418 周安装量

23,800 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/davila7/claude-code-templates --skill matplotlib

Python Web框架数据可视化数据分析

🇨🇳中文介绍

Matplotlib

概述

Matplotlib 是 Python 的基础可视化库，用于创建静态、动画和交互式图表。本技能提供了有效使用 matplotlib 的指导，涵盖了 pyplot 接口（MATLAB 风格）和面向对象的 API（Figure/Axes），以及创建出版物质量可视化的最佳实践。

何时使用此技能

在以下情况下应使用此技能：

创建任何类型的图表（折线图、散点图、条形图、直方图、热力图、等高线图等）
生成科学或统计可视化
自定义图表外观（颜色、样式、标签、图例）
创建包含子图的多面板图形
将可视化导出为各种格式（PNG、PDF、SVG 等）
构建交互式图表或动画
处理 3D 可视化
将图表集成到 Jupyter notebooks 或 GUI 应用程序中

核心概念

Matplotlib 层次结构

Matplotlib 使用对象的层次结构：

Figure - 所有绘图元素的顶级容器
Axes - 实际显示数据的绘图区域（一个 Figure 可以包含多个 Axes）
Artist - 图形上所有可见元素（线条、文本、刻度线等）
Axis - 处理刻度和标签的数值线对象（x 轴、y 轴）

两种接口

1. pyplot 接口（隐式，MATLAB 风格）

import matplotlib.pyplot as plt

plt.plot([1, 2, 3, 4])
plt.ylabel('some numbers')
plt.show()

适用于快速、简单的绘图
自动维护状态
适用于交互式工作和简单脚本

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 基本绘图创建

单图工作流程：

import matplotlib.pyplot as plt
import numpy as np

# 创建图形和坐标轴（OO 接口 - 推荐）
fig, ax = plt.subplots(figsize=(10, 6))

# 生成并绘制数据
x = np.linspace(0, 2*np.pi, 100)
ax.plot(x, np.sin(x), label='sin(x)')
ax.plot(x, np.cos(x), label='cos(x)')

# 自定义
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.set_title('Trigonometric Functions')
ax.legend()
ax.grid(True, alpha=0.3)

# 保存和/或显示
plt.savefig('plot.png', dpi=300, bbox_inches='tight')
plt.show()

创建子图布局：

# 方法 1：规则网格
fig, axes = plt.subplots(2, 2, figsize=(12, 10))
axes[0, 0].plot(x, y1)
axes[0, 1].scatter(x, y2)
axes[1, 0].bar(categories, values)
axes[1, 1].hist(data, bins=30)

# 方法 2：马赛克布局（更灵活）
fig, axes = plt.subplot_mosaic([['left', 'right_top'],
                                 ['left', 'right_bottom']],
                                figsize=(10, 8))
axes['left'].plot(x, y)
axes['right_top'].scatter(x, y)
axes['right_bottom'].hist(data)

# 方法 3：GridSpec（最大控制）
from matplotlib.gridspec import GridSpec
fig = plt.figure(figsize=(12, 8))
gs = GridSpec(3, 3, figure=fig)
ax1 = fig.add_subplot(gs[0, :])  # 顶行，所有列
ax2 = fig.add_subplot(gs[1:, 0])  # 底部两行，第一列
ax3 = fig.add_subplot(gs[1:, 1:])  # 底部两行，最后两列

3. 图表类型及用例

折线图 - 时间序列、连续数据、趋势

ax.plot(x, y, linewidth=2, linestyle='--', marker='o', color='blue')

散点图 - 变量间关系、相关性

ax.scatter(x, y, s=sizes, c=colors, alpha=0.6, cmap='viridis')

条形图 - 分类比较

ax.bar(categories, values, color='steelblue', edgecolor='black')
# 对于水平条形图：
ax.barh(categories, values)

直方图 - 分布

ax.hist(data, bins=30, edgecolor='black', alpha=0.7)

热力图 - 矩阵数据、相关性

im = ax.imshow(matrix, cmap='coolwarm', aspect='auto')
plt.colorbar(im, ax=ax)

等高线图 - 二维平面上的三维数据

contour = ax.contour(X, Y, Z, levels=10)
ax.clabel(contour, inline=True, fontsize=8)

箱线图 - 统计分布

ax.boxplot([data1, data2, data3], labels=['A', 'B', 'C'])

小提琴图 - 分布密度

ax.violinplot([data1, data2, data3], positions=[1, 2, 3])

有关全面的图表类型示例和变体，请参阅 references/plot_types.md。

4. 样式和自定义

颜色指定方法：

命名颜色：'red'、'blue'、'steelblue'
十六进制代码：'#FF5733'
RGB 元组：(0.1, 0.2, 0.3)
颜色映射：cmap='viridis'、cmap='plasma'、cmap='coolwarm'

使用样式表：

plt.style.use('seaborn-v0_8-darkgrid')  # 应用预定义样式
# 可用样式：'ggplot'、'bmh'、'fivethirtyeight' 等。
print(plt.style.available)  # 列出所有可用样式

使用 rcParams 自定义：

plt.rcParams['font.size'] = 12
plt.rcParams['axes.labelsize'] = 14
plt.rcParams['axes.titlesize'] = 16
plt.rcParams['xtick.labelsize'] = 10
plt.rcParams['ytick.labelsize'] = 10
plt.rcParams['legend.fontsize'] = 12
plt.rcParams['figure.titlesize'] = 18

文本和注释：

ax.text(x, y, 'annotation', fontsize=12, ha='center')
ax.annotate('important point', xy=(x, y), xytext=(x+1, y+1),
            arrowprops=dict(arrowstyle='->', color='red'))

有关详细的样式选项和颜色映射指南，请参阅 references/styling_guide.md。

导出为各种格式：

# 用于演示/论文的高分辨率 PNG
plt.savefig('figure.png', dpi=300, bbox_inches='tight', facecolor='white')

# 用于出版物的矢量格式（可缩放）
plt.savefig('figure.pdf', bbox_inches='tight')
plt.savefig('figure.svg', bbox_inches='tight')

# 透明背景
plt.savefig('figure.png', dpi=300, bbox_inches='tight', transparent=True)

dpi：分辨率（出版物用 300，网页用 150，屏幕用 72）
bbox_inches='tight'：移除多余空白
facecolor='white'：确保白色背景（对透明主题有用）
transparent=True：透明背景

from mpl_toolkits.mplot3d import Axes3D

fig = plt.figure(figsize=(10, 8))
ax = fig.add_subplot(111, projection='3d')

# 曲面图
ax.plot_surface(X, Y, Z, cmap='viridis')

# 3D 散点图
ax.scatter(x, y, z, c=colors, marker='o')

# 3D 折线图
ax.plot(x, y, z, linewidth=2)

# 标签
ax.set_xlabel('X Label')
ax.set_ylabel('Y Label')
ax.set_zlabel('Z Label')

对于生产代码，使用面向对象接口（fig, ax = plt.subplots()）
仅将 pyplot 接口用于快速交互式探索
始终显式创建图形，而不是依赖隐式状态

2. 图形尺寸和 DPI

在创建时设置 figsize：fig, ax = plt.subplots(figsize=(10, 6))
为输出媒介使用适当的 DPI：
- 屏幕/笔记本：72-100 dpi
- 网页：150 dpi
- 打印/出版物：300 dpi

使用 constrained_layout=True 或 tight_layout() 防止元素重叠
推荐使用 fig, ax = plt.subplots(constrained_layout=True) 进行自动间距调整

4. 颜色映射选择

顺序型（viridis、plasma、inferno）：具有一致进展的有序数据
发散型（coolwarm、RdBu）：具有有意义的中心点（例如零）的数据
定性型（tab10、Set3）：分类/名义数据
避免使用彩虹色映射（jet）——它们在感知上不均匀

使用色盲友好的颜色映射（viridis、cividis）
除了颜色外，为条形图添加图案/填充
确保元素之间有足够的对比度
包含描述性标签和图例

对于大型数据集，在绘图调用中使用 rasterized=True 以减少文件大小
在绘图前使用适当的数据缩减（例如，对密集时间序列进行下采样）
对于动画，使用 blitting 以获得更好的性能

# 良好实践：清晰的结构
def create_analysis_plot(data, title):
    """创建标准化的分析图表。"""
    fig, ax = plt.subplots(figsize=(10, 6), constrained_layout=True)

    # 绘制数据
    ax.plot(data['x'], data['y'], linewidth=2)

    # 自定义
    ax.set_xlabel('X Axis Label', fontsize=12)
    ax.set_ylabel('Y Axis Label', fontsize=12)
    ax.set_title(title, fontsize=14, fontweight='bold')
    ax.grid(True, alpha=0.3)

    return fig, ax

# 使用函数
fig, ax = create_analysis_plot(my_data, 'My Analysis')
plt.savefig('analysis.png', dpi=300, bbox_inches='tight')

此技能在 scripts/ 目录中包含辅助脚本：

演示各种图表类型及最佳实践的模板脚本。将其用作创建新可视化的起点。

python scripts/plot_template.py

`style_configurator.py`

用于配置 matplotlib 样式偏好并生成自定义样式表的交互式工具。

python scripts/style_configurator.py

如需全面信息，请查阅参考文档：

references/plot_types.md - 包含代码示例和用例的完整图表类型目录
references/styling_guide.md - 详细的样式选项、颜色映射和自定义
references/api_reference.md - 核心类和方法参考
references/common_issues.md - 常见问题故障排除指南

与其他工具的集成

Matplotlib 与以下工具集成良好：

NumPy/Pandas - 直接从数组和 DataFrame 绘图
Seaborn - 基于 matplotlib 构建的高级统计可视化
Jupyter - 使用 %matplotlib inline 或 %matplotlib widget 进行交互式绘图
GUI 框架 - 嵌入到 Tkinter、Qt、wxPython 应用程序中

元素重叠：使用 constrained_layout=True 或 tight_layout()
状态混淆：使用 OO 接口以避免 pyplot 状态机问题
多个图形导致内存问题：使用 plt.close(fig) 显式关闭图形
字体警告：安装字体或使用 plt.rcParams['font.sans-serif'] 抑制警告
DPI 混淆：记住 figsize 是以英寸为单位，而不是像素：pixels = dpi * inches

🇺🇸English

Matplotlib

Overview

Matplotlib is Python's foundational visualization library for creating static, animated, and interactive plots. This skill provides guidance on using matplotlib effectively, covering both the pyplot interface (MATLAB-style) and the object-oriented API (Figure/Axes), along with best practices for creating publication-quality visualizations.

When to Use This Skill

This skill should be used when:

Creating any type of plot or chart (line, scatter, bar, histogram, heatmap, contour, etc.)
Generating scientific or statistical visualizations
Customizing plot appearance (colors, styles, labels, legends)
Creating multi-panel figures with subplots
Exporting visualizations to various formats (PNG, PDF, SVG, etc.)
Building interactive plots or animations
Working with 3D visualizations
Integrating plots into Jupyter notebooks or GUI applications

Core Concepts

The Matplotlib Hierarchy

Matplotlib uses a hierarchical structure of objects:

Figure - The top-level container for all plot elements
Axes - The actual plotting area where data is displayed (one Figure can contain multiple Axes)
Artist - Everything visible on the figure (lines, text, ticks, etc.)
Axis - The number line objects (x-axis, y-axis) that handle ticks and labels

Two Interfaces

1. pyplot Interface (Implicit, MATLAB-style)

import matplotlib.pyplot as plt

plt.plot([1, 2, 3, 4])
plt.ylabel('some numbers')
plt.show()

Convenient for quick, simple plots
Maintains state automatically
Good for interactive work and simple scripts

2. Object-Oriented Interface (Explicit)

import matplotlib.pyplot as plt

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

Recommended for most use cases
More explicit control over figure and axes
Better for complex figures with multiple subplots
Easier to maintain and debug

Common Workflows

1. Basic Plot Creation

Single plot workflow:

import matplotlib.pyplot as plt
import numpy as np

# Create figure and axes (OO interface - RECOMMENDED)
fig, ax = plt.subplots(figsize=(10, 6))

# Generate and plot data
x = np.linspace(0, 2*np.pi, 100)
ax.plot(x, np.sin(x), label='sin(x)')
ax.plot(x, np.cos(x), label='cos(x)')

# Customize
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.set_title('Trigonometric Functions')
ax.legend()
ax.grid(True, alpha=0.3)

# Save and/or display
plt.savefig('plot.png', dpi=300, bbox_inches='tight')
plt.show()

2. Multiple Subplots

Creating subplot layouts:

# Method 1: Regular grid
fig, axes = plt.subplots(2, 2, figsize=(12, 10))
axes[0, 0].plot(x, y1)
axes[0, 1].scatter(x, y2)
axes[1, 0].bar(categories, values)
axes[1, 1].hist(data, bins=30)

# Method 2: Mosaic layout (more flexible)
fig, axes = plt.subplot_mosaic([['left', 'right_top'],
                                 ['left', 'right_bottom']],
                                figsize=(10, 8))
axes['left'].plot(x, y)
axes['right_top'].scatter(x, y)
axes['right_bottom'].hist(data)

# Method 3: GridSpec (maximum control)
from matplotlib.gridspec import GridSpec
fig = plt.figure(figsize=(12, 8))
gs = GridSpec(3, 3, figure=fig)
ax1 = fig.add_subplot(gs[0, :])  # Top row, all columns
ax2 = fig.add_subplot(gs[1:, 0])  # Bottom two rows, first column
ax3 = fig.add_subplot(gs[1:, 1:])  # Bottom two rows, last two columns

3. Plot Types and Use Cases

Line plots - Time series, continuous data, trends

ax.plot(x, y, linewidth=2, linestyle='--', marker='o', color='blue')

Scatter plots - Relationships between variables, correlations

ax.scatter(x, y, s=sizes, c=colors, alpha=0.6, cmap='viridis')

Bar charts - Categorical comparisons

ax.bar(categories, values, color='steelblue', edgecolor='black')
# For horizontal bars:
ax.barh(categories, values)

Histograms - Distributions

ax.hist(data, bins=30, edgecolor='black', alpha=0.7)

Heatmaps - Matrix data, correlations

im = ax.imshow(matrix, cmap='coolwarm', aspect='auto')
plt.colorbar(im, ax=ax)

Contour plots - 3D data on 2D plane

contour = ax.contour(X, Y, Z, levels=10)
ax.clabel(contour, inline=True, fontsize=8)

Box plots - Statistical distributions

ax.boxplot([data1, data2, data3], labels=['A', 'B', 'C'])

Violin plots - Distribution densities

ax.violinplot([data1, data2, data3], positions=[1, 2, 3])

For comprehensive plot type examples and variations, refer to references/plot_types.md.

4. Styling and Customization

Color specification methods:

Named colors: 'red', 'blue', 'steelblue'
Hex codes: '#FF5733'
RGB tuples: (0.1, 0.2, 0.3)
Colormaps: cmap='viridis', cmap='plasma', cmap='coolwarm'

Using style sheets:

plt.style.use('seaborn-v0_8-darkgrid')  # Apply predefined style
# Available styles: 'ggplot', 'bmh', 'fivethirtyeight', etc.
print(plt.style.available)  # List all available styles

Customizing with rcParams:

plt.rcParams['font.size'] = 12
plt.rcParams['axes.labelsize'] = 14
plt.rcParams['axes.titlesize'] = 16
plt.rcParams['xtick.labelsize'] = 10
plt.rcParams['ytick.labelsize'] = 10
plt.rcParams['legend.fontsize'] = 12
plt.rcParams['figure.titlesize'] = 18

Text and annotations:

ax.text(x, y, 'annotation', fontsize=12, ha='center')
ax.annotate('important point', xy=(x, y), xytext=(x+1, y+1),
            arrowprops=dict(arrowstyle='->', color='red'))

For detailed styling options and colormap guidelines, see references/styling_guide.md.

5. Saving Figures

Export to various formats:

# High-resolution PNG for presentations/papers
plt.savefig('figure.png', dpi=300, bbox_inches='tight', facecolor='white')

# Vector format for publications (scalable)
plt.savefig('figure.pdf', bbox_inches='tight')
plt.savefig('figure.svg', bbox_inches='tight')

# Transparent background
plt.savefig('figure.png', dpi=300, bbox_inches='tight', transparent=True)

Important parameters:

dpi: Resolution (300 for publications, 150 for web, 72 for screen)
bbox_inches='tight': Removes excess whitespace
facecolor='white': Ensures white background (useful for transparent themes)
transparent=True: Transparent background

6. Working with 3D Plots

from mpl_toolkits.mplot3d import Axes3D

fig = plt.figure(figsize=(10, 8))
ax = fig.add_subplot(111, projection='3d')

# Surface plot
ax.plot_surface(X, Y, Z, cmap='viridis')

# 3D scatter
ax.scatter(x, y, z, c=colors, marker='o')

# 3D line plot
ax.plot(x, y, z, linewidth=2)

# Labels
ax.set_xlabel('X Label')
ax.set_ylabel('Y Label')
ax.set_zlabel('Z Label')

Best Practices

1. Interface Selection

Use the object-oriented interface (fig, ax = plt.subplots()) for production code
Reserve pyplot interface for quick interactive exploration only
Always create figures explicitly rather than relying on implicit state

2. Figure Size and DPI

Set figsize at creation: fig, ax = plt.subplots(figsize=(10, 6))
Use appropriate DPI for output medium:
- Screen/notebook: 72-100 dpi
- Web: 150 dpi
- Print/publications: 300 dpi

3. Layout Management

Use constrained_layout=True or tight_layout() to prevent overlapping elements
fig, ax = plt.subplots(constrained_layout=True) is recommended for automatic spacing

4. Colormap Selection

Sequential (viridis, plasma, inferno): Ordered data with consistent progression
Diverging (coolwarm, RdBu): Data with meaningful center point (e.g., zero)
Qualitative (tab10, Set3): Categorical/nominal data
Avoid rainbow colormaps (jet) - they are not perceptually uniform

5. Accessibility

Use colorblind-friendly colormaps (viridis, cividis)
Add patterns/hatching for bar charts in addition to colors
Ensure sufficient contrast between elements
Include descriptive labels and legends

6. Performance

For large datasets, use rasterized=True in plot calls to reduce file size
Use appropriate data reduction before plotting (e.g., downsample dense time series)
For animations, use blitting for better performance

7. Code Organization

# Good practice: Clear structure
def create_analysis_plot(data, title):
    """Create standardized analysis plot."""
    fig, ax = plt.subplots(figsize=(10, 6), constrained_layout=True)

    # Plot data
    ax.plot(data['x'], data['y'], linewidth=2)

    # Customize
    ax.set_xlabel('X Axis Label', fontsize=12)
    ax.set_ylabel('Y Axis Label', fontsize=12)
    ax.set_title(title, fontsize=14, fontweight='bold')
    ax.grid(True, alpha=0.3)

    return fig, ax

# Use the function
fig, ax = create_analysis_plot(my_data, 'My Analysis')
plt.savefig('analysis.png', dpi=300, bbox_inches='tight')

Quick Reference Scripts

This skill includes helper scripts in the scripts/ directory:

`plot_template.py`

Template script demonstrating various plot types with best practices. Use this as a starting point for creating new visualizations.

Usage:

python scripts/plot_template.py

`style_configurator.py`

Interactive utility to configure matplotlib style preferences and generate custom style sheets.

Usage:

python scripts/style_configurator.py

Detailed References

For comprehensive information, consult the reference documents:

references/plot_types.md - Complete catalog of plot types with code examples and use cases
references/styling_guide.md - Detailed styling options, colormaps, and customization
references/api_reference.md - Core classes and methods reference
references/common_issues.md - Troubleshooting guide for common problems

Integration with Other Tools

Matplotlib integrates well with:

NumPy/Pandas - Direct plotting from arrays and DataFrames
Seaborn - High-level statistical visualizations built on matplotlib
Jupyter - Interactive plotting with %matplotlib inline or %matplotlib widget
GUI frameworks - Embedding in Tkinter, Qt, wxPython applications

Common Gotchas

Overlapping elements : Use constrained_layout=True or tight_layout()
State confusion : Use OO interface to avoid pyplot state machine issues
Memory issues with many figures : Close figures explicitly with plt.close(fig)
Font warnings : Install fonts or suppress warnings with plt.rcParams['font.sans-serif']
DPI confusion : Remember that figsize is in inches, not pixels: pixels = dpi * inches

Additional Resources

Official documentation: https://matplotlib.org/
Gallery: https://matplotlib.org/stable/gallery/index.html
Cheatsheets: https://matplotlib.org/cheatsheets/
Tutorials: https://matplotlib.org/stable/tutorials/index.html

Weekly Installs

295

Repository

davila7/claude-…emplates

GitHub Stars

22.6K

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode242

gemini-cli193

claude-code192

codex190

cursor180

github-copilot175

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

43,600 周安装

Matplotlib Python数据可视化教程：从基础图表到高级定制，掌握科学绘图核心技能

🇨🇳中文介绍

Matplotlib

概述

何时使用此技能

核心概念

Matplotlib 层次结构

两种接口

相关 Skills

常见工作流程

1. 基本绘图创建

2. 多个子图

3. 图表类型及用例

4. 样式和自定义

5. 保存图形

6. 处理 3D 图表

最佳实践

1. 接口选择

2. 图形尺寸和 DPI

3. 布局管理

4. 颜色映射选择

5. 可访问性

6. 性能

7. 代码组织

快速参考脚本

plot_template.py

style_configurator.py

详细参考资料

与其他工具的集成

常见陷阱

其他资源

🇺🇸English

Matplotlib

Overview

When to Use This Skill

Core Concepts

The Matplotlib Hierarchy

Two Interfaces

Common Workflows

1. Basic Plot Creation

2. Multiple Subplots

3. Plot Types and Use Cases

4. Styling and Customization

5. Saving Figures

6. Working with 3D Plots

Best Practices

1. Interface Selection

2. Figure Size and DPI

3. Layout Management

4. Colormap Selection

5. Accessibility

6. Performance

7. Code Organization

Quick Reference Scripts

plot_template.py

style_configurator.py

Detailed References

Integration with Other Tools

Common Gotchas

Additional Resources

最新 Skills

`plot_template.py`

`style_configurator.py`

`plot_template.py`

`style_configurator.py`