visioplot 1.0.16

Matplotlib to editable SVG and Visio (VSDX) export toolkit

Visioplot

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

它提供两层能力：

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

功能概览

• 将 Matplotlib 图导出为更适合 MS Office 的 SVG。
• 支持将 SVG 进一步导出为 VSDX，或直接复制到剪贴板。
• 支持类 LaTeX 文本解析：上下标、粗体、斜体、粗斜体。
• 提供统一样式入口，适配论文和工程汇报常见图表需求。

适用场景

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

环境要求

• Python 3.10 及以上。
• 主要依赖：matplotlib、beautifulsoup4、lxml、numpy。
• Visio 导出功能需要：Windows + Microsoft Visio + pywin32。

快速开始

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()
exporter = vp.savefig("demo.svg", bbox_inches="tight", pad_inches=0)
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 个完整示例，覆盖：

1. axisartist + SVG 导出
2. Fig(fig) + SVG 导出
3. 公式文本样式 + Visio 剪贴板导出
4. 复杂文本组合 + 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)
• exit()

文本语法（简版）

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

常见问题

Q1: tovsd() 或 toclip() 报错

请检查：

• 是否在 Windows 上运行
• 是否安装了 Microsoft Visio

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

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

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

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

License

MIT