All docs
Engine·
classmethod
Engine.load
opens a saved project and returns an engine
Python
Engine.load(path, *, event_bus=None, workspace=None) -> Engine
Returns Engine — the restored engine, with entities and cached outputs reattached
Parameters#
| name | type | default | description |
|---|---|---|---|
path |
str |
— | the .lsd file (or JSON) written by save |
event_bus |
EventBus | None |
None |
bus to attach; a fresh one is created when omitted |
workspace |
str | None |
None |
override the stored workspace path |
Example#
Python
from lsdtools import Engine
engine = Engine.load("survey.lsd")
engine.run_all(resume=True)
Notes#
Loads the project's declared packages first, so every step/entity class is registered before
deserialization. Reattaches persisted step outputs, so cached results are reused without re-running.
The workspace override lets a host define a project by where its .lsd file lives (portable, and
sibling projects in one folder share input data).
See also#
By LSD Team · Last updated Jul 17, 2026
Ask on Discord
View as Markdown