Skip to content

Commit 0559b17

Browse files
authored
change to markdown and add status badge (#185)
1 parent ebe47be commit 0559b17

File tree

2 files changed

+77
-69
lines changed

2 files changed

+77
-69
lines changed

README.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# OMPython
2+
3+
OMPython is a Python interface that uses ZeroMQ or CORBA (omniORB) to
4+
communicate with OpenModelica.
5+
6+
[![FMITest](https://github.com/OpenModelica/OMPython/actions/workflows/FMITest.yml/badge.svg)]
7+
(https://github.com/OpenModelica/OMPython/actions/workflows/FMITest.yml)
8+
[![Test](https://github.com/OpenModelica/OMPython/actions/workflows/Test.yml/badge.svg)]
9+
(https://github.com/OpenModelica/OMPython/actions/workflows/Test.yml)
10+
11+
## Dependencies
12+
13+
### Using ZeroMQ
14+
15+
- Python 2.7 and 3.x supported
16+
- PyZMQ is required
17+
18+
### Using omniORB
19+
20+
- Currently, only Python 2.7 is supported
21+
- omniORB is required:
22+
- Windows: included in the OpenModelica installation
23+
- Linux: Install omniORB including Python 2 support (the omniidl
24+
command needs to be on the PATH). On Ubuntu, this is done by
25+
running
26+
`sudo apt-get install omniorb python-omniorb omniidl omniidl-python`
27+
28+
## Installation
29+
30+
Installation using `pip` is recommended.
31+
32+
### Linux
33+
34+
Install the latest OMPython master by running:
35+
36+
python -m pip install -U https://github.com/OpenModelica/OMPython/archive/master.zip
37+
38+
### Windows
39+
40+
Install the version as packaged with your OpenModelica installation by
41+
running:
42+
43+
cd %OPENMODELICAHOME%\share\omc\scripts\PythonInterface
44+
python -m pip install -U .
45+
46+
Instead, to Install the latest version of the OMPython master branch
47+
only, previously cloned into `<OMPythonPath>`, run:
48+
49+
cd <OMPythonPath>
50+
python -m pip install -U .
51+
52+
## Usage
53+
54+
Running the following commads should get you started
55+
56+
``` python
57+
import OMPython
58+
help(OMPython)
59+
```
60+
61+
or read the [OMPython
62+
documentation](https://openmodelica.org/doc/OpenModelicaUsersGuide/latest/ompython.html)
63+
online.
64+
65+
## Bug Reports
66+
67+
- See OMPython bugs on the [OpenModelica
68+
trac](https://trac.openmodelica.org/OpenModelica/query?component=OMPython)
69+
or submit a [new
70+
ticket](https://trac.openmodelica.org/OpenModelica/newticket).
71+
- [Pull requests](https://github.com/OpenModelica/OMPython/pulls) are
72+
welcome.
73+
74+
## Contact
75+
76+
- Adeel Asghar, <adeel.asghar@liu.se>
77+
- Arunkumar Palanisamy, <arunkumar.palanisamy@liu.se>

README.rst

Lines changed: 0 additions & 69 deletions
This file was deleted.

0 commit comments

Comments
 (0)