ospx 0.1.0

Extension package to farn, adding support to build OSP simulation cases using FMUs

ospx

ospx is an extension package to farn, adding support to build OSP (co-)simulation cases using functional mockup units (FMUs).

ospx supports

• building of case-specific OSP (co-)simulation configuration files
• watching the progress of cosim, and saving final simulation results as a pandas dataframe.

Installation

pip install ospx

ospx requires the following (sub-)package:

• dictIO: foundation package, enabling ospx to handle configuration files in dictIO dict file format.

However, dictIO gets installed automatically with ospx.

Usage Example

ospx provides both an API for use inside Python as well as a CLI for shell execution of core functions.

Reading a caseDict file and building the case-specific OSP (co-)simulation configuration files:

from ospx import OspCaseBuilder

OspCaseBuilder.build('caseDict')

The above task can also be invoked from the command line, using the 'ospCaseBuilder' command line script installed with ospx:

ospCaseBuilder caseDict

For more examples and usage, please refer to ospx's documentation on GitHub Pages.

File Format

A caseDict is a file in dictIO dict file format used with farn.

For a documentation of the caseDict file format, see File Format in ospx's documentation on GitHub Pages.

For a detailed documentation of the dictIO dict file format used by farn, see dictIO's documentation on GitHub Pages.

Development Setup

1. Install Python 3.9 or higher, i.e. Python 3.9 or Python 3.10

2. Update pip and setuptools:

   $ python -m pip install --upgrade pip setuptools
   

3. git clone the farn repository into your local development directory:

   git clone https://github.com/dnv-opensource/ospx path/to/your/dev/ospx
   

4. In the ospx root folder:

   Create a Python virtual environment:

   $ python -m venv .venv
   

   Activate the virtual environment:
   ..on Windows:

   > .venv\Scripts\activate.bat
   

   ..on Linux:

   $ source .venv/bin/activate
   

   Update pip and setuptools:

   $ python -m pip install --upgrade pip setuptools
   

   Install farn's dependencies:

   $ pip install -r requirements.txt
   

Meta

Copyright (c) 2022 DNV open source

Frank Lumpitzsch – @LinkedIn – [e-mail]

Claas Rostock – @LinkedIn – [e-mail]

Seunghyeon Yoo – @LinkedIn – [e-mail]

Distributed under the MIT license. See LICENSE for more information.

https://github.com/dnv-opensource/ospx

Contributing

1. Fork it (https://github.com/dnv-opensource/ospx/fork)
2. Create your branch (git checkout -b myBranchName)
3. Commit your changes (git commit -am 'place your commit message here')
4. Push to the branch (git push origin myBranchName)
5. Create a new Pull Request

For your contribution, please make sure you follow the STYLEGUIDE before creating the Pull Request.