modelica
A Modelica toolchain written only in Python. It reads Modelica source, flattens it to a DAE, simulates it, and draws it. It also speaks the two exchange standards of the Modelica Association: FMI 3.0 for one component, and SSP 2.0 for a system of them.
The distribution is named
modelica. The git repository keeps its older name,pymodelica. PyPI holds the namepymodelicafor an abandoned Modelon/JModelica.org upload.
pip install modelica # the core: parse, model structure, diagrams. No dependencies.
pip install "modelica[sim]" # adds numpy and scipy, and therefore simulation
Documentation: https://jorgeecardona.gitlab.io/pymodelica/ — the architecture, the example corpus, and seven notebooks that are executed when the site is built.
Status
Pre-alpha. This is a full rewrite of a Python 2 experiment from 2010. No code of that experiment is left. Only the goal is. Python 3.12 or later.
Why this exists
Python has two halves of a Modelica toolchain, and not the middle. FMPy and PyFMI run an FMU that some other tool compiled. The tools that compile Modelica — Dymola, OpenModelica, JModelica — are large programs, and none of them is Python.
So two things are missing. Nothing in Python takes Modelica source all the way to a trajectory. And nothing treats the model itself — the flat equations, the incidence structure, the index — as an ordinary Python value that you can read and change.
That gap is the project. Every stage is a value you can hold.
The layers
You can use each layer without the layers above it.
| Module | What it does |
|---|---|
modelica.lang |
Modelica source to tokens to an AST. The lexer and the parser are written by hand. They carry source positions, so an error can say where. |
modelica.build |
Python classes to the same AST values. A second front end, not a wrapper around the first. |
modelica.ir |
AST to a flat model: variables, equations, an expression IR. Then matching, BLT sorting and index reduction. |
modelica.sim |
Flat model to an ODE or DAE problem. Solver backends, and events. |
modelica.diagram |
Any of the above to a picture: components and connections, equations and variables, or blocks in solution order. |
modelica.fmi |
FMI 3.0. Read an FMU and simulate it, or export a flat model as one. |
modelica.ssp |
SSP 2.0. Read the .ssd, .ssv and .ssb files in a .ssp, and run a co-simulation master over the components. |
Read the architecture notes for the data model and the order the layers were built in.
See a model
A Modelica model is a graph. The components are the boxes and connect() gives the lines.
The source text holds that graph, but a person cannot see it there. After flattening it is
gone: the equations keep every piece of the information and none of the shape.
python -m modelica.diagram examples/models/DCMotor.mo examples/library/Electrical.mo \
examples/library/Rotational.mo examples/library/Machines.mo --depth 2 > motor.svg
The picture needs no other program. This package draws the SVG itself. The image names no colour, so it reads correctly on a light page and on a dark one.
from modelica import diagram
picture = diagram.of("examples/models/RLCCircuit.mo", "examples/library/Electrical.mo")
picture.write("rlc.svg") # an image
print(picture.to_mermaid()) # or text for a Markdown page
print(picture.to_dot()) # or source for Graphviz
A notebook shows the picture when you put it on the last line of a cell.
Development
make install-hooks # once, after you clone. A pre-commit hook bumps the version and runs ruff.
make check # lint, typecheck and test. This is what CI runs.
make docs # build the documentation site, strictly.
.prototools pins the toolchain, which is moon and uv. proto install brings up all of
it. moon.yml holds the order of every task, and CI runs one command: moon run :ci.
Releasing
There is no manual release step. The version in pyproject.toml is the only source of
truth.
- The pre-commit hook increases the patch version when a file under
src/**/*.pychanges. scripts/ci-version-guardfails the pipeline if the shipped source moved and the version did not. A hook can be bypassed. This cannot.- On
main,moon run :releasepublishes to PyPI, but only if that version is not there yet. It uses GitLab OIDC Trusted Publishing, so no API token is stored anywhere.
The same pipeline publishes the documentation to GitLab Pages.
The documentation
The documentation is at https://jorgeecardona.gitlab.io/pymodelica/. The same pipeline that tests the code builds it, and it executes every notebook on the way, so a page that stopped working fails the build.
The pages follow ASD-STE100 Simplified Technical English. How these pages are written lists the rules and the two places this project departs from them.
License
MIT © Jorge Cardona
Trademarks
Modelica® is a registered trademark of the Modelica Association. FMI and SSP are also its trademarks. This page uses those names to identify the language this software reads and the standards it implements.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file modelica-0.0.56.tar.gz.
File metadata
- Download URL: modelica-0.0.56.tar.gz
- Upload date:
- Size: 507.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6d870b0da31a1bf8e1c942c3b1e15aff66db7d31a1e624f020203d605b33ebc5
|
|
| MD5 |
e1168b833ca126121df3c8577d835a7c
|
|
| BLAKE2b-256 |
6b573ecbd0e26ff2aafd908e1474679c6d89bfb7863696c84b6bf27bc85070b7
|
File details
Details for the file modelica-0.0.56-py3-none-any.whl.
File metadata
- Download URL: modelica-0.0.56-py3-none-any.whl
- Upload date:
- Size: 208.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc287f674558b6a4b10376da705d6be2b95b0e5cc224e8c38cbf84fb1c7071d6
|
|
| MD5 |
2ddac3f79ab68ea99fe8f3033dd8d37a
|
|
| BLAKE2b-256 |
f284b0946da9cb63b304cf111c9d5f352718bdb8fe69ead6875894429cc188aa
|
