model-parser¶

Convert process-model definitions to and from a canonical intermediate representation (IR).

model-parser owns the model scaffold contract for the Advanced Process Control toolchain: it parses an authoring format (today: ExprTk-style INI) into a normalized canonical IR (JSON), validates it, and lowers it to target views — starting with generated ModelingToolkit v11 Julia.

authoring (ExprTk INI)  --parse-->  AST  --normalize-->  canonical IR (JSON)
                                                          |
                                          emit julia  --> ModelingToolkit .jl

Where to read next¶

Product specification — authoritative scope, CLI, and behaviour.
Model library & versioning — hashes, SemVer, sibling model-library, authoring vs parameter sets.
Future work / todos — tracked implementation themes (not a substitute for issues or ADRs).
IR specification — IR shape and expression language.
Decision log — ADRs for major design choices.
PyPI package apc-model-parser — installable CLI (model-parser).

Install from PyPI¶

The distribution name is apc-model-parser; the CLI entry point is model-parser.

pipx install apc-model-parser
# or:
uv tool install apc-model-parser

model-parser --help

pipx and uv tool both install the tool into an isolated environment and put model-parser on your PATH.

For development from a clone, use uv sync --all-groups (see CI/CD and releases).