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

import visioplot as vp

vp.apply_style()

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")

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")

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 提供 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

• 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

• 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月}}）

请检查：

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

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

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

MIT