快速入门
了解 rsplotlib 的设计理念,完成环境配置并绘制你的第一张图表。
1.1项目简介
rsplotlib 是一款由 Rust 强力驱动的高性能 Python 绘图库,通过 PyO3 提供 Matplotlib 兼容的 Python API。其核心渲染引擎完全由 Rust 编写,在保持 Matplotlib 兼容接口的同时,利用 Rust 的内存安全和零成本抽象带来显著的性能提升。
保持与 Matplotlib 的高度兼容,降低迁移成本。
将渲染、批量操作等关键路径下沉到 Rust 层。
无需安装原生 Matplotlib,仅需 Python 解释器。
在 macOS、Linux、Windows 上渲染质量完全一致。
1.2环境准备
系统要求
| 依赖 | 版本 | 说明 |
|---|---|---|
| Python | 3.8+ | CPython 实现 |
| Rust | 1.70+ | 从源码构建时需要 |
| maturin | 1.13+ | Rust-Python 包构建工具 |
安装步骤
# 从 PyPI 安装(需 Python 3.8+)
pip install rsplotlib
# 升级到最新版本
pip install --upgrade rsplotlib
# uv 是更快的 Python 包管理器
# 安装 uv: https://docs.astral.sh/uv/
uv pip install rsplotlib
# 或在 uv 项目中添加依赖
uv add rsplotlib
# 1. 克隆仓库
git clone https://github.com/YJ-Niu/rsplotlib.git
cd rsplotlib
# 2. 安装 maturin 并构建
pip install maturin
maturin develop --release
# 使用项目构建脚本
./build_wheel.sh
# 安装生成的 wheel 包
pip install target/wheels/rsplotlib-*.whl
# 仅编译 Rust cdylib
cargo build --release
# macOS: 复制为 Python 扩展模块
cp target/release/librsplotlib.dylib \
python/rsplotlib/rsplotlib.cpython-39-darwin.so
# 设置 PYTHONPATH
export PYTHONPATH="$PWD/python:$PYTHONPATH"
1.3第一个图表
让我们从最基础的折线图开始,体验 rsplotlib 的基本工作流程。
from rsplotlib import pyplot as plt
from rsplotlib.pylab import mpl
# 可选:配置中文显示字体
mpl.rcParams['font.sans-serif'] = ['PingFang SC', 'Microsoft YaHei']
# 创建 Figure 和 Axes
fig, ax = plt.subplots(figsize=(8, 6))
# 准备数据
x = [0, 1, 2, 3, 4, 5]
y = [1, 2, 4, 8, 16, 32]
# 绘制线条
ax.plot(x, y, label='指数增长', linewidth=2.0, color='steelblue')
# 装饰图表
ax.set_title('我的第一个 rsplotlib 图表')
ax.set_xlabel('时间 (秒)')
ax.set_ylabel('数值')
ax.legend()
ax.grid(True)
# 保存图表
fig.savefig('my_first_chart.png', dpi=300)
figsize 控制图像英寸尺寸,dpi
控制每英寸点数。两者相乘决定最终像素分辨率。屏幕显示推荐
dpi=150,出版打印推荐
dpi=300。