Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 77 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# OMPython

OMPython is a Python interface that uses ZeroMQ or CORBA (omniORB) to
communicate with OpenModelica.

[![FMITest](https://github.com/OpenModelica/OMPython/actions/workflows/FMITest.yml/badge.svg)]
(https://github.com/OpenModelica/OMPython/actions/workflows/FMITest.yml)
[![Test](https://github.com/OpenModelica/OMPython/actions/workflows/Test.yml/badge.svg)]
(https://github.com/OpenModelica/OMPython/actions/workflows/Test.yml)

## Dependencies

### Using ZeroMQ

- Python 2.7 and 3.x supported
- PyZMQ is required

### Using omniORB

- Currently, only Python 2.7 is supported
- omniORB is required:
- Windows: included in the OpenModelica installation
- Linux: Install omniORB including Python 2 support (the omniidl
command needs to be on the PATH). On Ubuntu, this is done by
running
`sudo apt-get install omniorb python-omniorb omniidl omniidl-python`

## Installation

Installation using `pip` is recommended.

### Linux

Install the latest OMPython master by running:

python -m pip install -U https://github.com/OpenModelica/OMPython/archive/master.zip

### Windows

Install the version as packaged with your OpenModelica installation by
running:

cd %OPENMODELICAHOME%\share\omc\scripts\PythonInterface
python -m pip install -U .

Instead, to Install the latest version of the OMPython master branch
only, previously cloned into `<OMPythonPath>`, run:

cd <OMPythonPath>
python -m pip install -U .

## Usage

Running the following commads should get you started

``` python
import OMPython
help(OMPython)
```

or read the [OMPython
documentation](https://openmodelica.org/doc/OpenModelicaUsersGuide/latest/ompython.html)
online.

## Bug Reports

- See OMPython bugs on the [OpenModelica
trac](https://trac.openmodelica.org/OpenModelica/query?component=OMPython)
or submit a [new
ticket](https://trac.openmodelica.org/OpenModelica/newticket).
- [Pull requests](https://github.com/OpenModelica/OMPython/pulls) are
welcome.

## Contact

- Adeel Asghar, <adeel.asghar@liu.se>
- Arunkumar Palanisamy, <arunkumar.palanisamy@liu.se>
69 changes: 0 additions & 69 deletions README.rst

This file was deleted.