This release is a pre-release and may not be stable for production use.
A Modelica to computer algebra system (CAS) translator written in Python.
Overview
Pymoca can be used in applications that need to translate Modelica mathematical models into other forms. Pymoca can "flatten" a model containing a connected set of components defined by object-oriented Modelica classes into a set of variables and simultaneous equations that are easier to further process for analysis or simulation. It is particularly suited to provide Modelica models in symbolic form to computer algebra systems. A common use in this context is to provide differential and algebraic equations for use in optimal control problems. Pymoca can translate Modelica to CasADi, SymPy, and ModelicaXML, but most development and usage has been with CasADi.
Install
For parser support without backend dependencies:
pip install pymoca
Other options are:
pip install "pymoca[casadi]" # CasADi backend dependencies
pip install "pymoca[sympy]" # SymPy backend dependencies
pip install "pymoca[lxml]" # ModelicaXML backend dependencies
pip install "pymoca[examples]" # To run Jupyter notebook examples in the repo
pip install "pymoca[all]" # All of the above
pip install "pymoca[all,test]" # Add test dependencies to all
Usage
The Command Line Interface
A pymoca script is installed into your PATH with the PyPI install. Run pymoca --help at the command line for usage help. Pymoca error checking is not always complete or easy to understand, so it is better to develop the Modelica code with other tools and then use Pymoca for translation.
Scripting
Pymoca reads and understands Modelica code (pymoca.parser) and provides access to an internal representation of the code called an Abstract Syntax Tree or AST (pymoca.ast). The AST is further processed to generate output in various formats (pymoca.backends). The pymoca.tree module provides functionality to transform the AST into a form that can be more easily used by the backends to generate the target output. In particular, pymoca.tree provides classes and functions to convert a hierarchical, object-oriented Modelica model of connected components into a "flat" system of equations and associated variables, parameters, and constants.
The test suite contains examples showing how to use Pymoca and the subset of Modelica that it currently supports.
Here is an example using a simple spring and damper model from the test suite:
from pprint import pprint
import pymoca.parser
import pymoca.backends.casadi.generator as casadi_backend
MODELICA_MODEL = """
model Spring
Real x, v_x;
parameter Real c = 0.1;
parameter Real k = 2;
equation
der(x) = v_x;
der(v_x) = -k*x - c*v_x;
end Spring;
"""
print("Modelica Model:\n", MODELICA_MODEL)
print("\nEquations from the parsed AST in a JSON representation:")
ast = pymoca.parser.parse(MODELICA_MODEL)
pprint(ast.to_json(ast.classes["Spring"].equations))
print("\nGenerated CasADi model:")
casadi_model = casadi_backend.generate(ast, "Spring")
print(casadi_model)
Some more interesting examples are in Jupyter notebooks:
Roadmap
See the GitHub Projects for plans. In particular, see the Info Panel in the Modelica Flattening project for an overview of a project getting some current focus. Breaking API changes are expected.
5 maintainers
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 pymoca-0.12.0rc1.tar.gz.
File metadata
- Download URL: pymoca-0.12.0rc1.tar.gz
- Upload date:
- Size: 213.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc4bc70596a44444e60de7e382678e3269ddd42242afb9ac15fd739ee3e65a89
|
|
| MD5 |
fc20db54febe72553cb10ac689b69a97
|
|
| BLAKE2b-256 |
034b2673e325006db9e70aadf461a6444de19cfd21a2a8fd983ab8e588b17fc8
|
Provenance
The following attestation bundles were made for pymoca-0.12.0rc1.tar.gz:
Publisher:
ci.yml on pymoca/pymoca
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pymoca-0.12.0rc1.tar.gz -
Subject digest:
cc4bc70596a44444e60de7e382678e3269ddd42242afb9ac15fd739ee3e65a89 - Sigstore transparency entry: 2277510371
- Sigstore integration time:
-
Permalink:
pymoca/pymoca@685b381e4b3fcab9911d7d5187beef0b5e1c17e2 -
Branch / Tag:
refs/tags/0.12.0.rc1 - Owner: https://github.com/pymoca
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@685b381e4b3fcab9911d7d5187beef0b5e1c17e2 -
Trigger Event:
push
-
Statement type:
File details
Details for the file pymoca-0.12.0rc1-py3-none-any.whl.
File metadata
- Download URL: pymoca-0.12.0rc1-py3-none-any.whl
- Upload date:
- Size: 175.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f8fc6bc5123e8138800be2e23f6eac0b2f5d5c67c3494ba273702779e6d485b9
|
|
| MD5 |
02c3d7be438b3a9340db2aaf932dd1f8
|
|
| BLAKE2b-256 |
a0c294c43128e3143de4a115e49b66b760ef1c29404c896ca8076eca61343d49
|
Provenance
The following attestation bundles were made for pymoca-0.12.0rc1-py3-none-any.whl:
Publisher:
ci.yml on pymoca/pymoca
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pymoca-0.12.0rc1-py3-none-any.whl -
Subject digest:
f8fc6bc5123e8138800be2e23f6eac0b2f5d5c67c3494ba273702779e6d485b9 - Sigstore transparency entry: 2277510402
- Sigstore integration time:
-
Permalink:
pymoca/pymoca@685b381e4b3fcab9911d7d5187beef0b5e1c17e2 -
Branch / Tag:
refs/tags/0.12.0.rc1 - Owner: https://github.com/pymoca
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@685b381e4b3fcab9911d7d5187beef0b5e1c17e2 -
Trigger Event:
push
-
Statement type:
