LayMesh文档
EN

Notebook Magic#

平台 wheel 内置 Rust 引擎。默认安装包含 NumPy、pandas、Matplotlib 和 IPython,数据绑定、Figure 导入及 Notebook Magic 均可直接使用。

sh
python -m pip install laymesh

安装与源码开发

在当前内核中检查实际使用的安装与引擎:

python
import sys, laymeshprint(sys.executable, laymesh.__file__)!"{sys.executable}" -m laymesh --version

Python 默认使用所安装 wheel 的内置引擎;切换 Git 分支不会自动替换已经安装的包。测试实验分支时,在该内核用 %pip install /path/to/built-wheel.whl 安装实际构建文件,然后重启内核再注册 Magic。

操作流程#

%load_ext laymesh.ipython 调用 load_ipython_extension(ipython) 注册 LayMeshMagics;随后使用:

text
%laymesh figures/layout.lay -o figures/output.png --dpi 300%%laymesh -o figure.pdf --save-source figure.laypage = canvas(size=(100 mm, 70 mm))

两种 Magic 都通过 Rust CPU 渲染器生成 192 DPI JPEG 预览(质量 95,4:4:4 采样,透明区域默认合成到白底),以双倍像素密度显示在单元格中;导出与预览共用一次原生编译。--preview-dpi、--preview-quality、--preview-background 独立控制预览;--dpi、--quality、--background 仍只影响导出。画布本身的背景色保持不变。SVG 仍可显式导出,Python API 的 preview_svg 保持兼容。行 Magic 读取文件,单元格 Magic 读取正文;均支持 -o/--output、--dpi、--plot-dpi、--save-source。--plot-dpi 默认 300,只影响 Figure 回退图像。load_ipython_extension 位于 ipython.py,不在 laymesh 顶层导出。

限制与相关主题#

原生数组与 DataFrame · 保存源码与独立重渲染 · Matplotlib 导入

workflow#

本流程的完整源码与可执行验证文件列在功能覆盖清单。组合使用时请遵循本页的输入条件与限制。

完整的双单元格示例#

python
%load_ext laymesh.ipythonvalues = [1, 2, 4, 3]
text
%%laymesh -o figure.svg --save-source figure.laypage=canvas(size=(100mm,75mm))p=plot(size=(86mm,62mm))p.line(x=[0,1,2,3],y={{values}},marker=circle)page.add(p,offset=(7mm,6mm))

先运行注册单元格。单元格 magic 读取 Notebook 命名空间,展开 {{values}},生成预览并保存可独立运行的源码和资源。占位符是不加引号的名称,不执行任意 Python 表达式。再次执行会更新自动生成文件;普通手工源码受覆盖保护。

render_source 和 render_file 还接受 quality=None、compression=None、background=None、webp_lossless=None、webp_method=None、webp_alpha_quality=None、webp_near_lossless=None。Magics 接受相应的 --quality、--compression、--background 与 --webp-* 参数。导出格式与编码参数

默认导出 DPI 为 1200,--dpi 也控制 PDF 图片上限。支持 --config PATH 与 --pdf-* 压缩/精度保留参数,见导出配置。