Visioplot

Visioplot 是一个面向科研绘图和工程汇报场景的 Python 工具库，目标是让 Matplotlib 图在 Visio、Word 或 PPT 中更好呈现。

它提供两层能力：

绘图输出层：把 Matplotlib 输出的 SVG 图修改为更适合 MS Office 编辑的 SVG。
办公流转层：在 Windows + Visio 环境下将 SVG 转为 VSDX 或复制到剪贴板。

功能概览

将 Matplotlib 图导出为更适合 MS Office 的 SVG。
支持将 SVG 进一步导出为 VSDX，或直接复制到剪贴板。
支持类 LaTeX 文本解析：上下标、粗体、斜体、粗斜体。
支持上下标语法糖（如 _**x**、^*x*），内部自动规范化后解析。
提供统一样式入口，适配论文和工程汇报常见图表需求。
支持通过 gid="out" 标记图元，导出时对超出轴域内容做独立处理，便于后续编辑。

适用场景

在 Python 中完成绘图后，需要在 Visio / PPT 中继续精修图形。
需要把超出坐标轴范围的曲线做可编辑线段化处理。
需要在 Visio 中保留部分文本样式，例如上下标、粗斜体。

环境要求

Python 3.10 及以上
Visio 导出功能需要：Windows + Microsoft Visio

安装

pip install visioplot

快速开始

1) 统一绘图样式

import visioplot as vp

vp.apply_style()

2) 普通 plt 流程导出 SVG

import matplotlib.pyplot as plt
import mpl_toolkits.axisartist as AA
import visioplot as vp

vp.apply_style()
plt.figure(figsize=vp.cm(9, 6.75))
plt.axes(axes_class=AA.Axes)
plt.plot([1, 2, 3], [3, 5, 4], label="inax", marker="s")
plt.plot([1, 2, 3], [5, 15, 3], gid="out", label="outax", linestyle="--", marker="o")
plt.legend()

vp.savefig("demo.svg")

3) Figure 对象导出 SVG

import matplotlib.pyplot as plt
import mpl_toolkits.axisartist as AA
import visioplot as vp

vp.apply_style()

fig = plt.figure()
ax = fig.add_subplot(axes_class=AA.Axes)
ax.plot([1, 2, 3], [3, 2, 4], label="inax")
ax.plot([1, 2, 3], [5, 15, 3], gid="out", label="outax")
ax.legend()

vp.Fig(fig).savefig("demo_fig.svg")

4) 导出到 Visio（VSDX / 剪贴板）

import matplotlib.pyplot as plt
import visioplot as vp

vp.apply_style()

plt.plot([1, 2, 3], [3, 5, 4], label="inax", marker="s")
plt.plot([1, 2, 3], [5, 15, 3], gid="out", label="outax", linestyle="--", marker="o")
plt.legend()
plt.tight_layout(pad=0.2)
exporter = vp.savefig("demo.svg")
exporter.tovsd()   # 保存为 demo.vsdx
exporter.toclip()  # 导出并复制到剪贴板

调试输出

库默认关闭 debug 输出。需要查看解析/导出调试信息时：

import visioplot as vp

vp.set_debug(True)
# ... run your code
vp.set_debug(False)

main.py 示例

仓库根目录的 main.py 提供 4 个完整示例，覆盖：

axisartist + SVG 导出
Fig(fig) + SVG 导出
公式文本样式 + Visio 剪贴板导出
复杂文本组合 + Visio 剪贴板导出

直接运行：

python main.py

当前示例输出文件：

example1_axisartist.svg
example2_fig.svg
example3_formula_text.svg
example4_parser.svg

API 概览

包级导出（visioplot）

apply_style(style=None, inline_svg=True)
reset_style()
cm(*args)
set_debug(enabled=True)
savefig(path, **kwargs) -> VisioExporter
Fig(fig).savefig(path, **kwargs) -> VisioExporter

VisioExporter

tovsd(vsdx_path=None, clipboard=False)
toclip(vsdx_path=None, clipboard=True)

文本语法（简版）

斜体：*text*
粗体：**text**
粗斜体：***text***
下标：x_2、x_{abc}
上标：x^2、x^{abc}
下标斜体：c_*x*

语法糖规则：

_**abc** 等价于 _{**abc**}
^*abc* 等价于 ^{*abc*}
支持嵌套（例如 E_{m_{1~3月}}）

常见问题

Q1: tovsd() 或 toclip() 报错

请检查：

是否在 Windows 上运行
是否安装了 Microsoft Visio
Office/Visio 版本是否支持 SVG 导入（建议 2019/365）

Q2: 我只想要 SVG，不需要 Visio

只调用 vp.savefig("xxx.svg") 即可，不要调用 tovsd()/toclip()。

Q3: 为什么有些字符字体在 Visio 里会变化

Visio 对不同字符会做字体回退。当前代码已对部分希腊字符做专门处理，但具体效果仍取决于本机字体与 Visio 字体映射。

License

MIT

Metadata

Release files for visioplot 1.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for visioplot 1.2.4
File	Size	Uploaded
visioplot-1.2.4.tar.gz	45.9 kB	May 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for visioplot 1.2.4
File	Interpreter	ABI	Platform	Reset
visioplot-1.2.4-py3-none-any.whl 43.8 kB May 12, 2026	Python 3	none	any	Details

Total release size: 89.7 kB

Release files / visioplot-1.2.4.tar.gz

Download URL	visioplot-1.2.4.tar.gz
Size	45.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`976f271020f7f55f392befff5bd88f8da01a326311941052c1361178aa8e718e`
BLAKE2b-256 checksum How to use checksums	`52f504acafbf9f4a0f557f36ea83265610a2156b5d74c9b5759a7c99ecf7645e`
Upload date	May 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / visioplot-1.2.4-py3-none-any.whl

Download URL	visioplot-1.2.4-py3-none-any.whl
Size	43.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`101e348543ea39fbcfee3aae7187239aeca91ebc5b3ef2f1ce09251ce028067c`
BLAKE2b-256 checksum How to use checksums	`a04d0586e7d0cef4af8448bd8dbb9647899619b0c8a3310b3958c4402b7548aa`
Upload date	May 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`