Notebook Magic#

Platform wheels bundle the Rust engine. The standard installation includes NumPy, pandas, Matplotlib and IPython, so data bindings, Figure import and Notebook magics are ready to use.

1python -m pip install laymesh

Installation and source development

Workflow#

%load_ext laymesh.ipython invokes load_ipython_extension(ipython) to register LayMeshMagics:

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

Both magics display an SVG preview. Line magic reads a file; cell magic reads cell content. Both support -o/--output, --dpi, --plot-dpi, and --save-source. Default --plot-dpi is 300 and affects only Figure PNG fallback. load_ipython_extension lives in ipython.py, not the top-level laymesh exports.

Limits and related topics#

Native arrays and DataFrames · Save source and render independently · Matplotlib import

workflow#

Complete sources and executable verification fixtures for this workflow are listed in the feature coverage map. Follow this page’s input conditions and limits when composing features.

A complete two-cell example#

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

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

Run the registration cell first. The cell magic reads the Notebook namespace, expands {{values}}, renders a preview and writes a portable source/resource pair. Placeholders are unquoted names, not arbitrary Python expressions. Re-executing updates generated files; regular manually edited source is protected from accidental generated-file overwrite.

render_source and render_file also accept quality=None, compression=None, background=None, webp_lossless=None, webp_method=None, webp_alpha_quality=None, and webp_near_lossless=None. Magics accept the corresponding --quality, --compression, --background and --webp-* flags. Export formats and encoding options