lynx.Diagram.load

classmethod Diagram.load(filename: str | Path, namespace: Dict[str, Any] | None = None) → Diagram

Load diagram from JSON file with optional expression re-evaluation.

Parameters:

• filename – Path to load file

• namespace – Optional namespace for expression re-evaluation. If provided, parameter expressions will be re-evaluated using variables from this namespace. Pass globals() to use current Python environment, or pass explicit parameter dict.

Returns:

Diagram object with expressions re-evaluated if namespace provided

Raises:

• FileNotFoundError – If file doesn’t exist

• ValueError – If JSON is malformed or invalid diagram data

Examples

>>> # No re-evaluation (backward compatible)
>>> diagram = Diagram.load("mydiagram.json")
>>>
>>> # Re-evaluate with current notebook/script variables
>>> kp = 611.0
>>> ki = 63.0
>>> diagram = Diagram.load("mydiagram.json", namespace=globals())
>>>
>>> # Re-evaluate with explicit parameter values
>>> diagram = Diagram.load(
...     "mydiagram.json",
...     namespace={"kp": 500.0, "ki": 50.0}
... )