Skip to main content

LayMesh

Reproducible scientific figures and precise physical layouts from readable code. Compose native plots, images, vector shapes, text and formulas in one editable .lay source; export SVG, PDF and PNG/JPEG/TIFF/WebP/BMP/GIF/ICO/PNM/TGA with a native Rust engine.

中文文档 · English documentation · Examples · Source

Install

Requires Python 3.10+. Version 0.3.1 adds configurable raster export. Install an uploaded release or a reviewed local platform wheel:

python -m pip install laymesh
python -m laymesh --version

Platform wheels bundle one native Rust executable and formula fonts. Rendering requires no Rust compiler, Node.js or TeX installation and downloads no engine or fonts. Body fonts come from the operating system or user-provided files; missing glyphs warn and display vector boxes. Supply font files with a layout for reproducible text across machines.

The standard installation includes NumPy, pandas, Matplotlib and IPython. Data bindings, Matplotlib Figure import and Jupyter magics are ready to use.

Wheel targets are Windows x64, macOS 14+ on Intel and Apple Silicon, and Linux x64 / arm64. Linux requires glibc at least as new as the wheel's manylinux_2_XX tag. Availability depends on uploaded wheels; Alpine/musl, 32-bit platforms and Windows ARM64 have no wheels. Plots are rendered by the native engine.

First figure: CLI

Save this complete source as figure.lay:

page = canvas(size=(120 mm, 90 mm), background="#ffffff")
p = plot(size=(110 mm, 80 mm),
         x=axis(label="Time (s)"), y=axis(label="Signal"))
p.line(x=[0, 1, 2, 3], y=[1, 3, 2, 4], label="Experiment")
p.legend(position="top_left")
page.add(p, offset=(5 mm, 5 mm))
laymesh validate figure.lay
laymesh inspect figure.lay --json
laymesh render figure.lay -o figure.svg
laymesh render figure.lay -o figure.pdf
laymesh render figure.lay -o figure.png --dpi 300

python -m laymesh invokes the same CLI. Geometry defaults to mm; typography and line widths default to pt. Raster DPI changes output pixels while preserving physical dimensions. .lay is a restricted standalone language, separate from Python.

Image export options (0.3.1)

laymesh render figure.lay -o figure.jpg --dpi 300 --quality 95 --background "#ffffff"
laymesh render figure.lay -o figure.tif --dpi 600 --compression deflate
laymesh render figure.lay -o figure.webp --dpi 300 --webp-lossless false --quality 90 --webp-method 6

render_file and render_source accept dpi, quality, compression, background, webp_lossless, webp_method, webp_alpha_quality and webp_near_lossless. Notebook magics accept the corresponding CLI flags. Raster exports use 8-bit sRGB; PNG/JPEG/TIFF/BMP record DPI metadata. JPEG uses a matte; GIF has binary alpha; RGBA formats retain partial transparency. Export options.

Python API

from laymesh import render_source

source = '''
page = canvas(size=(120 mm, 90 mm), background="#ffffff")
p = plot(size=(110 mm, 80 mm),
         x=axis(label="Time (s)"), y=axis(label="Signal"))
p.line(x=[0, 1, 2, 3], y=[1, 3, 2, 4], label="Experiment")
p.legend(position="top_left")
page.add(p, offset=(5 mm, 5 mm))
'''
result = render_source(source, output="python-figure.svg", save_source="python-figure.lay")
print(result.output)

Use render_file("figure.lay", output="figure.pdf") to render existing source. Pass Python variables via namespace={"values": values} and refer to them with an unquoted {{values}} placeholder in .lay. Lists, dictionaries, NumPy arrays and pandas DataFrames can feed native plots. Matplotlib Figures can be placed as image assets. Keep calculations in Python; placeholders accept variable names, not expressions.

save_source saves expanded source and a sibling .assets/ directory for independent CLI rendering. Preserve that directory and any referenced modules, stylesheets or fonts with the .lay file. Python API and data examples.

Jupyter

Install LayMesh in the active kernel's environment. First run:

%load_ext laymesh.ipython
values = [1, 3, 2, 4]

Then run this separate cell:

%%laymesh -o notebook.pdf --save-source notebook.lay
page = canvas(size=(120 mm, 90 mm))
p = plot(size=(110 mm, 80 mm))
p.line(x=[0, 1, 2, 3], y={{values}})
page.add(p, offset=(5 mm, 5 mm))

The magic displays an SVG preview and writes the requested export. %laymesh figure.lay -o figure.png --dpi 300 renders an existing file. Both magics support --warnings show|hide. Notebook guide.

Scope

LayMesh provides physical units, anchors, cropping, paths, reusable modules, LCSS styles and native scientific plots including statistical, polar and radar layers. Layouts are single-page; panels use explicit positioning. Finish plot layers and decorations before placing a chart. Fixed plot areas keep their physical dimensions; decoration overflow emits a warning. Language reference.

中文

LayMesh 用一个可编辑的 .lay 文件组织科研图表、图片、文字与公式,导出 SVG、PDF、PNG。需要 Python 3.10+;运行 python -m pip install laymesh 即可安装全部功能,包括 NumPy/pandas 数据绑定和 Matplotlib Figure 导入。平台 wheel 内置原生 Rust 引擎和公式字体,正文使用系统或用户字体。支持 laymesh 命令、Python API 和 Jupyter Magic;保存源码与资源后可独立重新导出。中文入门。

LayMesh is MIT licensed. Bundled native dependencies, formula fonts and colormap data retain their own license texts inside the installed package. _vendor/manifest.json records engine, platform and build hashes; _vendor/licenses/manifest.json records dependency license provenance.

Exports default to 1200 DPI, independently of layout_dpi. PDF accepts dpi, pdf_image_compression, pdf_jpeg_quality, pdf_downsample, pdf_recompress_jpeg, pdf_preserve_16bit, pdf_preserve_alpha, pdf_alpha_background, pdf_auto_palette_limit, and pdf_auto_flatness_threshold. config=PATH selects project defaults; Notebook magics support corresponding --config and --pdf-* flags. See configuration.

Metadata

Release files for laymesh 0.3.2

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

Built distributions (wheels)

Table of built distributions (wheels) for laymesh 0.3.2
File Actions
laymesh-0.3.2-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for laymesh-0.3.2-py3-none-win_amd64.whl
laymesh-0.3.2-py3-none-manylinux_2_35_x86_64.whl Python 3 none Linux glibc 2.35+ x86-64 Details for laymesh-0.3.2-py3-none-manylinux_2_35_x86_64.whl
laymesh-0.3.2-py3-none-manylinux_2_35_aarch64.whl Python 3 none Linux glibc 2.35+ ARM64 Details for laymesh-0.3.2-py3-none-manylinux_2_35_aarch64.whl
laymesh-0.3.2-py3-none-macosx_14_0_x86_64.whl Python 3 none macOS 14.0+ x86-64 Details for laymesh-0.3.2-py3-none-macosx_14_0_x86_64.whl
laymesh-0.3.2-py3-none-macosx_14_0_arm64.whl Python 3 none macOS 14.0+ ARM64 Details for laymesh-0.3.2-py3-none-macosx_14_0_arm64.whl

Total release size: 33.6 MB

Release files / laymesh-0.3.2-py3-none-win_amd64.whl

Download URL laymesh-0.3.2-py3-none-win_amd64.whl
Size 6.8 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
b212809f7a942e0cb843a65eaad0cbd33582686a26bb5e17d923405a41daca06
BLAKE2b-256 checksum
How to use checksums
b49acc0baaa55f5271bd983d424a599967f5dba9106e6927c090cddac5d26096
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Release files / laymesh-0.3.2-py3-none-manylinux_2_35_x86_64.whl

Download URL laymesh-0.3.2-py3-none-manylinux_2_35_x86_64.whl
Size 7.2 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
8e7b1059f74cae4b9af6cea81fcc571063bbcda9a51032312e02596b854205d7
BLAKE2b-256 checksum
How to use checksums
3601cf5e9fe2d5a9b667fc5e0c0f35b57d63e9e0bca70140886438ec51628c0b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Release files / laymesh-0.3.2-py3-none-manylinux_2_35_aarch64.whl

Download URL laymesh-0.3.2-py3-none-manylinux_2_35_aarch64.whl
Size 6.6 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
43a800d4e9989f906f3f2780167a290c33ddf9b3d066697a88b3fa07df32ed9e
BLAKE2b-256 checksum
How to use checksums
3cdaec1b644c869c8820231bb516721c90c12605d7b49075aae736400231b461
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Release files / laymesh-0.3.2-py3-none-macosx_14_0_x86_64.whl

Download URL laymesh-0.3.2-py3-none-macosx_14_0_x86_64.whl
Size 6.8 MB
Tags Python 3 macOS 14.0+ x86-64
SHA-256 checksum
How to use checksums
67b7c6a70a5e9d63ebbf3fd1b9e6f4fe84302e17bc1e09ebe3bc716a9c4a70f5
BLAKE2b-256 checksum
How to use checksums
6d828855072ab29abf815b53ce528761aa5424dbc0df1447f45c616eea6f295d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Release files / laymesh-0.3.2-py3-none-macosx_14_0_arm64.whl

Download URL laymesh-0.3.2-py3-none-macosx_14_0_arm64.whl
Size 6.2 MB
Tags Python 3 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
66cb1164d291aea3ff865a61d8d0fab8ad193174ce9a397e2b9915788e3c0c97
BLAKE2b-256 checksum
How to use checksums
70381a9b93d21acc99a7f8fb7005e27162d13ca76d9ee0fe439859c219475383
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Security for laymesh 0.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for laymesh-0.3.2-py3-none-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page