rsplotlib 0.2.6__tar.gz → 0.2.9__tar.gz

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/.github/workflows/ci.yml

@@ -14,21 +14,20 @@ concurrency:
 permissions:
   contents: read
 
+env:
+  CARGO_TERM_COLOR: always
+  RUST_BACKTRACE: 1
+
 jobs:
   test:
     name: Test (${{ matrix.os }}, py${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
+      # 覆盖最低支持版本 3.10、当前主力 3.13 与最新 3.14，三大平台全跑。
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
         python-version: ["3.10", "3.13", "3.14"]
-        # 补测最低支持版本 3.8；macOS(arm64) 对 3.8 支持不稳定，故仅在 Linux/Windows 上测。
-        include:
-          - os: ubuntu-latest
-            python-version: "3.10"
-          - os: windows-latest
-            python-version: "3.10"
     steps:
       - uses: actions/checkout@v4
 
@@ -79,4 +78,4 @@ jobs:
         run: cargo fmt --all -- --check
 
       - name: Run clippy
-        run: cargo clippy -- -D warnings
+        run: cargo clippy --all-targets -- -D warnings

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/.gitignore

@@ -32,7 +32,8 @@ test/
 test*.py
 *.png
 main*.py
-debug.txt
+.trae/
+debug.md
 out/
 wheelhouse/
 N237S NB.csv

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/Cargo.lock

@@ -50,9 +50,9 @@ checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
 
 [[package]]
 name = "bytemuck"
-version = "1.25.0"
+version = "1.25.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c8efb64bd706a16a1bdde310ae86b351e4d21550d98d056f22f8a7f7a2183fec"
+checksum = "d6aedf8ae72766347502cf3cb4f41cf5e9cc37d28bee90f1fdaaae15f9cf9424"
 
 [[package]]
 name = "byteorder"
@@ -417,12 +417,14 @@ dependencies = [
 
 [[package]]
 name = "rsplotlib"
-version = "0.2.6"
+version = "0.2.9"
 dependencies = [
+ "ab_glyph",
  "jpeg-decoder",
  "jpeg-encoder",
  "owned_ttf_parser",
  "plotters",
+ "plotters-backend",
  "png 0.18.1",
  "pyo3",
 ]

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rsplotlib"
-version = "0.2.6"
+version = "0.2.9"
 edition = "2024"
 readme = "README.md"
 
@@ -15,6 +15,10 @@ png = "0.18.1"
 owned_ttf_parser = "0.25.1"
 jpeg-encoder = "0.7.0"
 jpeg-decoder = "0.3.2"
+# 与 plotters 0.3.7 相同版本的 ab_glyph / plotters-backend（均已在 Cargo.lock 锁定，
+# 不引入新下载）：glyph 缓存需直接引用 ab_glyph 光栅化器与后端 trait 类型。
+ab_glyph = "0.2.32"
+plotters-backend = "0.3.7"
 
 [profile.release]
 lto = "fat"

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rsplotlib
-Version: 0.2.6
+Version: 0.2.9
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -71,6 +71,21 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 - **统计图表**：直方图、箱线图、饼图、误差棒图、茎叶图、阶梯图
 - **高级图表**：堆叠面积图、热力图/图像显示、填充区域图
 
+### 颜色映射与颜色条
+
+- **50+ 内置颜色映射**：`viridis`、`plasma`、`inferno`、`magma`、`cividis`、`jet`、`coolwarm`、`RdBu`、`Blues`、`Greens`、`Reds`、`hot`、`cool`、`gray`、`terrain`、`twilight` 等，任意名称加 `_r` 后缀即可反转（如 `viridis_r`）
+- **颜色条 Colorbar**：`plt.colorbar()` / `fig.colorbar()`，Rust 渲染，支持 `location`、`orientation`、`shrink`、`aspect`、`pad`、`fraction`、`label`、`extend`、`ticks`、`format`
+- **颜色归一化**：`LogNorm` / `Normalize`（来自 `rsplotlib.colors`），通过 `norm=` 参数使用
+
+### 图像输入 / 输出
+
+- **`imshow`**：支持二维数据（经颜色映射，可用对数归一化）与 RGB/RGBA 图像，支持 `alpha`、`origin`、`interpolation` 控制
+- **`imread` / `imsave`**：读写 PNG/JPEG 图像
+
+### 数学公式渲染
+
+- **LaTeX 风格 `$...$`**：上下标、`\frac`、`\sqrt[n]{}`、希腊字母、重音与字体样式命令，在标题、轴标签、`text`、`annotate`、图例、柱状图标签中生效
+
 ### 辅助元素
 
 - **参考线**：水平参考线 (`axhline`)、垂直参考线 (`axvline`)
@@ -357,24 +372,27 @@ plt.savefig('module_level.png')
 
 ### 绘图函数
 
-| 函数             | 说明                        | 模块级接口 | Axes 接口 |
-| ---------------- | --------------------------- | ---------- | --------- |
-| `plot()`         | 折线图                      | ✅         | ✅        |
-| `scatter()`      | 散点图（支持颜色/大小数组） | ✅         | ✅        |
-| `bar()`          | 柱状图                      | ✅         | ✅        |
-| `barh()`         | 水平柱状图                  | ✅         | ✅        |
-| `hist()`         | 直方图                      | ✅         | ✅        |
-| `pie()`          | 饼图                        | ✅         | ✅        |
-| `boxplot()`      | 箱线图                      | ✅         | ✅        |
-| `fill_between()` | 曲线间填充                  | ✅         | ✅        |
-| `errorbar()`     | 误差棒图                    | ✅         | ✅        |
-| `stem()`         | 茎叶图                      | ✅         | ✅        |
-| `step()`         | 阶梯图                      | ✅         | ✅        |
-| `imshow()`       | 图像/热力图                 | ✅         | ✅        |
-| `stackplot()`    | 堆叠面积图                  | ✅         | ✅        |
-| `semilogx()`     | x 轴对数坐标折线图          | ✅         | ✅        |
-| `semilogy()`     | y 轴对数坐标折线图          | ✅         | ✅        |
-| `loglog()`       | 双对数坐标折线图            | ✅         | ✅        |
+| 函数             | 说明                        | 模块级接口    | Axes 接口 |
+| ---------------- | --------------------------- | ------------- | --------- |
+| `plot()`         | 折线图                      | ✅            | ✅        |
+| `scatter()`      | 散点图（支持颜色/大小数组） | ✅            | ✅        |
+| `bar()`          | 柱状图                      | ✅            | ✅        |
+| `barh()`         | 水平柱状图                  | ✅            | ✅        |
+| `hist()`         | 直方图                      | ✅            | ✅        |
+| `pie()`          | 饼图                        | ✅            | ✅        |
+| `boxplot()`      | 箱线图                      | ✅            | ✅        |
+| `fill_between()` | 曲线间填充                  | ✅            | ✅        |
+| `errorbar()`     | 误差棒图                    | ✅            | ✅        |
+| `stem()`         | 茎叶图                      | ✅            | ✅        |
+| `step()`         | 阶梯图                      | ✅            | ✅        |
+| `imshow()`       | 图像/热力图                 | ✅            | ✅        |
+| `stackplot()`    | 堆叠面积图                  | ✅            | ✅        |
+| `semilogx()`     | x 轴对数坐标折线图          | ✅            | ✅        |
+| `semilogy()`     | y 轴对数坐标折线图          | ✅            | ✅        |
+| `loglog()`       | 双对数坐标折线图            | ✅            | ✅        |
+| `colorbar()`     | 为 mappable 添加颜色条      | ✅（plt/fig） | ❌        |
+| `imread()`       | 读取 PNG/JPEG 图像为数组    | ✅            | ❌        |
+| `imsave()`       | 将数组写出为 PNG/JPEG       | ✅            | ❌        |
 
 ### 辅助元素
 
@@ -556,6 +574,66 @@ ax.vlines(x, color=None, linestyle=None, linewidth=None)
 
 - `y` / `x` (list/array): 位置列表
 
+### Axes.imshow / plt.imshow
+
+将二维数据显示为热力图，或渲染 RGB/RGBA 图像。
+
+```python
+ax.imshow(x, cmap=None, norm=None, aspect=None, interpolation=None,
+          alpha=None, vmin=None, vmax=None, origin=None, extent=None)
+```
+
+**参数：**
+
+- `x` (二维数组或 HxWx3/4 图像): 标量场或 RGB(A) 图像
+- `cmap` (str): 二维数据的颜色映射名（默认 `'viridis'`），加 `_r` 反转
+- `norm` (`Normalize` / `LogNorm` / `'linear'` / `'log'`): 数值到颜色的映射
+- `interpolation` (str): `'none'` / `'nearest'` 为块状缩放，其余为平滑模式
+- `origin` (str): `'upper'`（默认）或 `'lower'`
+- `vmin` / `vmax` (float): 数值范围裁剪；`alpha` (float): 不透明度
+- 注意：`extent` 为兼容签名而接受，但当前被忽略
+
+```python
+im = ax.imshow([[1, 2], [3, 4]], cmap='plasma', origin='lower')
+```
+
+### colorbar
+
+为 mappable（如 `imshow` / `scatter` 的返回值）添加颜色条。
+
+```python
+plt.colorbar(mappable=None, ax=None, **kwargs)
+fig.colorbar(mappable=None, ax=None, **kwargs)
+```
+
+**生效的关键字参数：** `location`、`orientation`、`shrink`、`aspect`、`pad`、
+`fraction`、`label`、`extend`、`ticks`、`format`。其余 matplotlib 关键字虽被接受，
+但当前不生效。
+
+```python
+im = plt.imshow([[1, 2], [3, 4]], cmap='viridis')
+plt.colorbar(im, label='数值', shrink=0.8)
+```
+
+### 颜色归一化（LogNorm）
+
+```python
+from rsplotlib.colors import LogNorm
+plt.imshow(data, cmap='viridis', norm=LogNorm())
+plt.colorbar()
+```
+
+### 数学公式（`$...$`）
+
+所有承载文本的接口都支持美元符号之间的 LaTeX 风格公式，包括标题、轴标签、
+`text`、`annotate`、图例标签与柱状图标签。
+
+```python
+plt.title(r'$\alpha^2 + \frac{1}{2}\sqrt{x}$')
+```
+
+支持：上下标、`\frac`、`\sqrt[n]{}`、希腊字母、重音与字体样式命令。
+
 ---
 
 ## 性能优势
@@ -583,13 +661,17 @@ rsplotlib 在架构设计上通过"分层下沉"策略实现性能优化：
 
 ### 性能关键路径下沉到 Rust
 
-| 功能                        | 传统实现                            | rsplotlib 实现                  |
-| --------------------------- | ----------------------------------- | ------------------------------- |
-| `scatter(c=colors)`         | Python 层遍历每个点                 | Rust 层 `ScatterMulti` 统一渲染 |
-| `scatter(s=sizes)`          | Python 层遍历每个点                 | Rust 层统一大小数组处理         |
-| `hlines([y1, y2, y3, ...])` | Python `for` 循环多次调用 `axhline` | Rust 层单次调用批量处理         |
-| `vlines([x1, x2, x3, ...])` | Python `for` 循环多次调用 `axvline` | Rust 层单次调用批量处理         |
-| `savefig(dpi=300)`          | 无 DPI 支持 / Python 层缩放         | Rust 层直接写入 PNG DPI 元数据  |
+| 功能                             | 传统实现                            | rsplotlib 实现                  |
+| -------------------------------- | ----------------------------------- | ------------------------------- |
+| `scatter(c=colors)`              | Python 层遍历每个点                 | Rust 层 `ScatterMulti` 统一渲染 |
+| `scatter(s=sizes)`               | Python 层遍历每个点                 | Rust 层统一大小数组处理         |
+| `hlines([y1, y2, y3, ...])`      | Python `for` 循环多次调用 `axhline` | Rust 层单次调用批量处理         |
+| `vlines([x1, x2, x3, ...])`      | Python `for` 循环多次调用 `axvline` | Rust 层单次调用批量处理         |
+| `savefig(dpi=300)`               | 无 DPI 支持 / Python 层缩放         | Rust 层直接写入 PNG DPI 元数据  |
+| `hist()` / `boxplot()`（大数据） | Python 层物化每个数值               | 零拷贝缓冲区下沉到 Rust         |
+| 百万级点折线                     | 渲染每一段线段                      | 自动 min/max（M4）抽稀          |
+| 大图 `imshow`                    | 单线程逐像素                        | 多线程按行渲染                  |
+| 重复文本渲染                     | 每个字形重复栅格化                  | 按 (字体, 字符, 字号) 缓存字形  |
 
 ### 为什么选择 Rust + Python 混合架构
 
@@ -718,6 +800,9 @@ def axhspan(ymin, ymax, **kwargs):
 - 当前版本不支持 3D 绘图
 - 不支持动画/交互式图表
 - `contour` / `violinplot` / `hexbin` 为占位实现
+- `imshow(extent=...)` 为兼容签名而接受，但当前被忽略
+- `colorbar()` 仅部分 matplotlib 关键字生效（见 [colorbar](#colorbar)）
+- `data=` 当前仅 `scatter` 支持（`plot` 不支持）
 
 ---
 
@@ -775,8 +860,9 @@ MIT License — 详见 [LICENSE](LICENSE) 文件。
 ## 相关链接
 
 - **GitHub**: https://github.com/YJ-Niu/rsplotlib
+- **发行说明**: [RELEASE_NOTES_zh.md](RELEASE_NOTES_zh.md)
 
 ---
 
-_最后更新：2026-07-03 · 版本 v0.1.9_
+_最后更新：2026-07-12 · 版本 v0.2.9_
 

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/README.md

@@ -48,6 +48,21 @@
 - **Statistical Charts**: Histograms, box plots, pie charts, error bars, stem plots, step plots
 - **Advanced Charts**: Stacked area plots, heatmap/image display, fill-between regions
 
+### Colormaps & Colorbar
+
+- **50+ Built-in Colormaps**: `viridis`, `plasma`, `inferno`, `magma`, `cividis`, `jet`, `coolwarm`, `RdBu`, `Blues`, `Greens`, `Reds`, `hot`, `cool`, `gray`, `terrain`, `twilight`, and more - any name reversible with a `_r` suffix (e.g. `viridis_r`)
+- **Colorbar**: `plt.colorbar()` / `fig.colorbar()`, Rust-rendered, with `location`, `orientation`, `shrink`, `aspect`, `pad`, `fraction`, `label`, `extend`, `ticks`, `format`
+- **Color Normalization**: `LogNorm` / `Normalize` (from `rsplotlib.colors`) via the `norm=` argument
+
+### Image Input / Output
+
+- **`imshow`**: 2D data (via colormap, log-norm capable) and RGB/RGBA images, with `alpha`, `origin`, and `interpolation` control
+- **`imread` / `imsave`**: read and write PNG/JPEG images
+
+### Math Text Rendering
+
+- **LaTeX-style `$...$`**: superscripts/subscripts, `\frac`, `\sqrt[n]{}`, Greek letters, accents, and font-style commands - active in titles, axis labels, `text`, `annotate`, legend, and bar labels
+
 ### Annotation & Reference Elements
 
 - **Reference Lines**: Horizontal (`axhline`), vertical (`axvline`)
@@ -352,6 +367,9 @@ plt.savefig('module_level.png')
 | `semilogx()`     | X-axis log-scale line plot                | Yes          | Yes         |
 | `semilogy()`     | Y-axis log-scale line plot                | Yes          | Yes         |
 | `loglog()`       | Log-log scale line plot                   | Yes          | Yes         |
+| `colorbar()`     | Colorbar for a mappable                   | Yes (plt/fig)| No          |
+| `imread()`       | Read a PNG/JPEG image into an array       | Yes          | No          |
+| `imsave()`       | Write an array to PNG/JPEG                 | Yes          | No          |
 
 ### Annotation Elements
 
@@ -536,6 +554,67 @@ ax.vlines(x, color=None, linestyle=None, linewidth=None)
 
 - `y` / `x` (list/array): Position list
 
+### Axes.imshow / plt.imshow
+
+Display 2D data as a heatmap or render an RGB/RGBA image.
+
+```python
+ax.imshow(x, cmap=None, norm=None, aspect=None, interpolation=None,
+          alpha=None, vmin=None, vmax=None, origin=None, extent=None)
+```
+
+**Parameters:**
+
+- `x` (2D array or HxWx3/4 image): scalar field or RGB(A) image
+- `cmap` (str): colormap name for 2D data (default `'viridis'`); append `_r` to reverse
+- `norm` (`Normalize` / `LogNorm` / `'linear'` / `'log'`): value-to-color mapping
+- `interpolation` (str): `'none'` / `'nearest'` for block scaling, or a smooth mode
+- `origin` (str): `'upper'` (default) or `'lower'`
+- `vmin` / `vmax` (float): value range clamp; `alpha` (float): opacity
+- Note: `extent` is accepted for compatibility but currently ignored.
+
+```python
+im = ax.imshow([[1, 2], [3, 4]], cmap='plasma', origin='lower')
+```
+
+### colorbar
+
+Add a colorbar for a mappable (e.g. the return value of `imshow` / `scatter`).
+
+```python
+plt.colorbar(mappable=None, ax=None, **kwargs)
+fig.colorbar(mappable=None, ax=None, **kwargs)
+```
+
+**Effective keyword arguments:** `location`, `orientation`, `shrink`, `aspect`,
+`pad`, `fraction`, `label`, `extend`, `ticks`, `format`. Other matplotlib kwargs
+are accepted but currently have no effect.
+
+```python
+im = plt.imshow([[1, 2], [3, 4]], cmap='viridis')
+plt.colorbar(im, label='value', shrink=0.8)
+```
+
+### Color Normalization (LogNorm)
+
+```python
+from rsplotlib.colors import LogNorm
+plt.imshow(data, cmap='viridis', norm=LogNorm())
+plt.colorbar()
+```
+
+### Math Text (`$...$`)
+
+Any text-bearing API accepts LaTeX-style math between dollar signs, including
+titles, axis labels, `text`, `annotate`, legend labels, and bar labels.
+
+```python
+plt.title(r'$\alpha^2 + \frac{1}{2}\sqrt{x}$')
+```
+
+Supported: superscripts/subscripts, `\frac`, `\sqrt[n]{}`, Greek letters,
+accents, and font-style commands.
+
 ---
 
 ## Performance Advantages
@@ -572,9 +651,13 @@ rsplotlib achieves performance optimization through a layered-down architecture
 | --------------------------- | ---------------------------------------------- | ------------------------------------- |
 | `scatter(c=colors)`         | Python iterates over every point               | Rust `ScatterMulti` unified rendering |
 | `scatter(s=sizes)`          | Python iterates over every point               | Rust unified size array processing    |
-| `hlines([y1, y2, y3, ...])` | Python `for` loop calling `axhline` repeatedly | Single Rust call, batch processing    |
-| `vlines([x1, x2, x3, ...])` | Python `for` loop calling `axvline` repeatedly | Single Rust call, batch processing    |
+| `hlines([y1, y2, y3, ...])` | Python `for` loop calling `axhline` repeatedly | Single Rust call, batch processing |
+| `vlines([x1, x2, x3, ...])` | Python `for` loop calling `axvline` repeatedly | Single Rust call, batch processing |
 | `savefig(dpi=300)`          | No DPI support / Python scaling                | Rust writes PNG DPI metadata directly |
+| `hist()` / `boxplot()` (large data) | Python materializes every value        | Zero-copy buffer push-down to Rust    |
+| Line plot with millions of points  | Renders every segment                   | Automatic min/max (M4) decimation     |
+| `imshow` on large images    | Single-threaded pixel loop                     | Multi-threaded row rendering          |
+| Repeated text rendering     | Re-rasterize each glyph                        | Glyph cache keyed by (font, char, size) |
 
 ### Why a Rust + Python Hybrid Architecture?
 
@@ -703,6 +786,9 @@ PRs are welcome! Please include:
 - 3D plotting is not supported in the current version
 - Animated/interactive charts are not supported
 - `contour` / `violinplot` / `hexbin` are placeholder implementations
+- `imshow(extent=...)` is accepted for signature compatibility but currently ignored
+- `colorbar()` honors only a subset of matplotlib kwargs (see [colorbar](#colorbar))
+- `data=` is currently supported by `scatter` only (not `plot`)
 
 ---
 
@@ -760,7 +846,8 @@ MIT License - See the [LICENSE](LICENSE) file for details.
 ## Related Links
 
 - **GitHub**: https://github.com/YJ-Niu/rsplotlib
+- **Release Notes**: [RELEASE_NOTES.md](RELEASE_NOTES.md)
 
 ---
 
-_Last updated: 2026-07-03 / Version v0.1.9_
+_Last updated: 2026-07-12 / Version v0.2.9_

{rsplotlib-0.2.6 → rsplotlib-0.2.9}/README_zh.md

@@ -46,6 +46,21 @@
 - **统计图表**：直方图、箱线图、饼图、误差棒图、茎叶图、阶梯图
 - **高级图表**：堆叠面积图、热力图/图像显示、填充区域图
 
+### 颜色映射与颜色条
+
+- **50+ 内置颜色映射**：`viridis`、`plasma`、`inferno`、`magma`、`cividis`、`jet`、`coolwarm`、`RdBu`、`Blues`、`Greens`、`Reds`、`hot`、`cool`、`gray`、`terrain`、`twilight` 等，任意名称加 `_r` 后缀即可反转（如 `viridis_r`）
+- **颜色条 Colorbar**：`plt.colorbar()` / `fig.colorbar()`，Rust 渲染，支持 `location`、`orientation`、`shrink`、`aspect`、`pad`、`fraction`、`label`、`extend`、`ticks`、`format`
+- **颜色归一化**：`LogNorm` / `Normalize`（来自 `rsplotlib.colors`），通过 `norm=` 参数使用
+
+### 图像输入 / 输出
+
+- **`imshow`**：支持二维数据（经颜色映射，可用对数归一化）与 RGB/RGBA 图像，支持 `alpha`、`origin`、`interpolation` 控制
+- **`imread` / `imsave`**：读写 PNG/JPEG 图像
+
+### 数学公式渲染
+
+- **LaTeX 风格 `$...$`**：上下标、`\frac`、`\sqrt[n]{}`、希腊字母、重音与字体样式命令，在标题、轴标签、`text`、`annotate`、图例、柱状图标签中生效
+
 ### 辅助元素
 
 - **参考线**：水平参考线 (`axhline`)、垂直参考线 (`axvline`)
@@ -332,24 +347,27 @@ plt.savefig('module_level.png')
 
 ### 绘图函数
 
-| 函数             | 说明                        | 模块级接口 | Axes 接口 |
-| ---------------- | --------------------------- | ---------- | --------- |
-| `plot()`         | 折线图                      | ✅         | ✅        |
-| `scatter()`      | 散点图（支持颜色/大小数组） | ✅         | ✅        |
-| `bar()`          | 柱状图                      | ✅         | ✅        |
-| `barh()`         | 水平柱状图                  | ✅         | ✅        |
-| `hist()`         | 直方图                      | ✅         | ✅        |
-| `pie()`          | 饼图                        | ✅         | ✅        |
-| `boxplot()`      | 箱线图                      | ✅         | ✅        |
-| `fill_between()` | 曲线间填充                  | ✅         | ✅        |
-| `errorbar()`     | 误差棒图                    | ✅         | ✅        |
-| `stem()`         | 茎叶图                      | ✅         | ✅        |
-| `step()`         | 阶梯图                      | ✅         | ✅        |
-| `imshow()`       | 图像/热力图                 | ✅         | ✅        |
-| `stackplot()`    | 堆叠面积图                  | ✅         | ✅        |
-| `semilogx()`     | x 轴对数坐标折线图          | ✅         | ✅        |
-| `semilogy()`     | y 轴对数坐标折线图          | ✅         | ✅        |
-| `loglog()`       | 双对数坐标折线图            | ✅         | ✅        |
+| 函数             | 说明                        | 模块级接口    | Axes 接口 |
+| ---------------- | --------------------------- | ------------- | --------- |
+| `plot()`         | 折线图                      | ✅            | ✅        |
+| `scatter()`      | 散点图（支持颜色/大小数组） | ✅            | ✅        |
+| `bar()`          | 柱状图                      | ✅            | ✅        |
+| `barh()`         | 水平柱状图                  | ✅            | ✅        |
+| `hist()`         | 直方图                      | ✅            | ✅        |
+| `pie()`          | 饼图                        | ✅            | ✅        |
+| `boxplot()`      | 箱线图                      | ✅            | ✅        |
+| `fill_between()` | 曲线间填充                  | ✅            | ✅        |
+| `errorbar()`     | 误差棒图                    | ✅            | ✅        |
+| `stem()`         | 茎叶图                      | ✅            | ✅        |
+| `step()`         | 阶梯图                      | ✅            | ✅        |
+| `imshow()`       | 图像/热力图                 | ✅            | ✅        |
+| `stackplot()`    | 堆叠面积图                  | ✅            | ✅        |
+| `semilogx()`     | x 轴对数坐标折线图          | ✅            | ✅        |
+| `semilogy()`     | y 轴对数坐标折线图          | ✅            | ✅        |
+| `loglog()`       | 双对数坐标折线图            | ✅            | ✅        |
+| `colorbar()`     | 为 mappable 添加颜色条      | ✅（plt/fig） | ❌        |
+| `imread()`       | 读取 PNG/JPEG 图像为数组    | ✅            | ❌        |
+| `imsave()`       | 将数组写出为 PNG/JPEG       | ✅            | ❌        |
 
 ### 辅助元素
 
@@ -531,6 +549,66 @@ ax.vlines(x, color=None, linestyle=None, linewidth=None)
 
 - `y` / `x` (list/array): 位置列表
 
+### Axes.imshow / plt.imshow
+
+将二维数据显示为热力图，或渲染 RGB/RGBA 图像。
+
+```python
+ax.imshow(x, cmap=None, norm=None, aspect=None, interpolation=None,
+          alpha=None, vmin=None, vmax=None, origin=None, extent=None)
+```
+
+**参数：**
+
+- `x` (二维数组或 HxWx3/4 图像): 标量场或 RGB(A) 图像
+- `cmap` (str): 二维数据的颜色映射名（默认 `'viridis'`），加 `_r` 反转
+- `norm` (`Normalize` / `LogNorm` / `'linear'` / `'log'`): 数值到颜色的映射
+- `interpolation` (str): `'none'` / `'nearest'` 为块状缩放，其余为平滑模式
+- `origin` (str): `'upper'`（默认）或 `'lower'`
+- `vmin` / `vmax` (float): 数值范围裁剪；`alpha` (float): 不透明度
+- 注意：`extent` 为兼容签名而接受，但当前被忽略
+
+```python
+im = ax.imshow([[1, 2], [3, 4]], cmap='plasma', origin='lower')
+```
+
+### colorbar
+
+为 mappable（如 `imshow` / `scatter` 的返回值）添加颜色条。
+
+```python
+plt.colorbar(mappable=None, ax=None, **kwargs)
+fig.colorbar(mappable=None, ax=None, **kwargs)
+```
+
+**生效的关键字参数：** `location`、`orientation`、`shrink`、`aspect`、`pad`、
+`fraction`、`label`、`extend`、`ticks`、`format`。其余 matplotlib 关键字虽被接受，
+但当前不生效。
+
+```python
+im = plt.imshow([[1, 2], [3, 4]], cmap='viridis')
+plt.colorbar(im, label='数值', shrink=0.8)
+```
+
+### 颜色归一化（LogNorm）
+
+```python
+from rsplotlib.colors import LogNorm
+plt.imshow(data, cmap='viridis', norm=LogNorm())
+plt.colorbar()
+```
+
+### 数学公式（`$...$`）
+
+所有承载文本的接口都支持美元符号之间的 LaTeX 风格公式，包括标题、轴标签、
+`text`、`annotate`、图例标签与柱状图标签。
+
+```python
+plt.title(r'$\alpha^2 + \frac{1}{2}\sqrt{x}$')
+```
+
+支持：上下标、`\frac`、`\sqrt[n]{}`、希腊字母、重音与字体样式命令。
+
 ---
 
 ## 性能优势
@@ -558,13 +636,17 @@ rsplotlib 在架构设计上通过"分层下沉"策略实现性能优化：
 
 ### 性能关键路径下沉到 Rust
 
-| 功能                        | 传统实现                            | rsplotlib 实现                  |
-| --------------------------- | ----------------------------------- | ------------------------------- |
-| `scatter(c=colors)`         | Python 层遍历每个点                 | Rust 层 `ScatterMulti` 统一渲染 |
-| `scatter(s=sizes)`          | Python 层遍历每个点                 | Rust 层统一大小数组处理         |
-| `hlines([y1, y2, y3, ...])` | Python `for` 循环多次调用 `axhline` | Rust 层单次调用批量处理         |
-| `vlines([x1, x2, x3, ...])` | Python `for` 循环多次调用 `axvline` | Rust 层单次调用批量处理         |
-| `savefig(dpi=300)`          | 无 DPI 支持 / Python 层缩放         | Rust 层直接写入 PNG DPI 元数据  |
+| 功能                             | 传统实现                            | rsplotlib 实现                  |
+| -------------------------------- | ----------------------------------- | ------------------------------- |
+| `scatter(c=colors)`              | Python 层遍历每个点                 | Rust 层 `ScatterMulti` 统一渲染 |
+| `scatter(s=sizes)`               | Python 层遍历每个点                 | Rust 层统一大小数组处理         |
+| `hlines([y1, y2, y3, ...])`      | Python `for` 循环多次调用 `axhline` | Rust 层单次调用批量处理         |
+| `vlines([x1, x2, x3, ...])`      | Python `for` 循环多次调用 `axvline` | Rust 层单次调用批量处理         |
+| `savefig(dpi=300)`               | 无 DPI 支持 / Python 层缩放         | Rust 层直接写入 PNG DPI 元数据  |
+| `hist()` / `boxplot()`（大数据） | Python 层物化每个数值               | 零拷贝缓冲区下沉到 Rust         |
+| 百万级点折线                     | 渲染每一段线段                      | 自动 min/max（M4）抽稀          |
+| 大图 `imshow`                    | 单线程逐像素                        | 多线程按行渲染                  |
+| 重复文本渲染                     | 每个字形重复栅格化                  | 按 (字体, 字符, 字号) 缓存字形  |
 
 ### 为什么选择 Rust + Python 混合架构
 
@@ -693,6 +775,9 @@ def axhspan(ymin, ymax, **kwargs):
 - 当前版本不支持 3D 绘图
 - 不支持动画/交互式图表
 - `contour` / `violinplot` / `hexbin` 为占位实现
+- `imshow(extent=...)` 为兼容签名而接受，但当前被忽略
+- `colorbar()` 仅部分 matplotlib 关键字生效（见 [colorbar](#colorbar)）
+- `data=` 当前仅 `scatter` 支持（`plot` 不支持）
 
 ---
 
@@ -750,7 +835,8 @@ MIT License — 详见 [LICENSE](LICENSE) 文件。
 ## 相关链接
 
 - **GitHub**: https://github.com/YJ-Niu/rsplotlib
+- **发行说明**: [RELEASE_NOTES_zh.md](RELEASE_NOTES_zh.md)
 
 ---
 
-_最后更新：2026-07-03 · 版本 v0.1.9_
+_最后更新：2026-07-12 · 版本 v0.2.9_