No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.

fmi_adapter_examples package from fmi_adapter repo

fmi_adapter fmi_adapter_examples

Package Summary

Tags No category tags.
Version 1.0.2
License Apache License 2.0
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/boschresearch/fmi_adapter.git
VCS Type git
VCS Version master
Last Updated 2018-10-12
Dev Status MAINTAINED
Released RELEASED

Package Description

Provides small examples for use of the fmi_adapter package

Additional Links

Maintainers

  • Ralph Lange

Authors

  • Ralph Lange

General information about this repository, including legal information, build instructions and known issues/limitations, are given in README.md in the repository root.

The fmi_adapter_examples package

This ROS package provides few examples for the use of the fmi_adapter package. It contains two FMU files DampedPendulum.fmu and TransportDelay.fmu (both created with the FMU SDK) and corresponding launch files. Furthermore, it includes a model of a damped pendulum in the Modelica language to create your own FMU.

Running the provided sample FMUs

Use roslaunch fmi_adapter_examples simple_damped_pendulum.launch to simulate a damped pendulum (share/DampedPendulum.fmu) with a length of 1m. The pendulum's angle is published at /fmi_adapter_node/a with the default rate of 100Hz. The step size of the FMU's solver is 1ms.

damped_pendulum_with_transport_delay.launch starts two nodes. The first one simulates share/DampedPendulum.fmu, where the length parameter is set to 25m by the launch file. The second node runs share/TransportDelay.fmu, where the delay parameter is set to 2.33s. The input subscription of the transport delay is remapped to the pendulum's angle topic and the delayed angle is published at /transport_delay/y.

Both launch files also open rqt_plot to visualize the angle(s).

Plot created by damped_pendulum_with_transport_delay.launch

Create and simulate your own DampedPendulum.fmu

There are several modeling tools that support the Modelica language and provide FMU export. Examples are Dymola, JModelica, and OpenModelica.

In the following, we explain the process by the example of OpenModelica, which has been also used to create the model of the damped pendulum at share/DampedPendulum.mo.

Screenshot of the DampedPendulum model in OMEdit V1.12.0

  • Navigate to Tools -> Options -> FMI and ensure that Version=2.0, Type=Co-Simulation and Platforms=Dynamic is selected.
  • Then click FMI -> Export FMU.
  • The path of the resulting FMU file is shown in the message browser at the bottom of the window, typically /tmp/OpenModelica_[user]/OMEdit/DampedPendulum.fmu.

Now, you are prepared for simulating the FMU using the fmi_adapter package.

  • Either use the generic launch file of the package roslaunch fmi_adapter fmi_adapter_node.launch fmu_path:=/tmp/OpenModelica_[user]/OMEdit/DampedPendulum.fmu or invoke the package's node directly by rosrun fmi_adapter node _fmu_path:=/tmp/OpenModelica_[user]/OMEdit/DampedPendulum.fmu

  • You may visualize the pendulum's angle over time by rqt_plot /fmi_adapter_node/revolute1_angle

DampedPendulum.fmu simulation results in rqt_plot

Please see the README.md of the fmi_adapter package for how to load and run an FMU inside an application-specific ROS node or library.

Note on bug with mmc_mk_modelica_array in OpenModelica 1.12.0: If the fmi_adapter node crashes with the error message undefined symbol: mmc_mk_modelica_array, please patch the files

  • /usr/include/omc/c/meta/meta_modelica.h
  • /usr/include/omc/c/meta/meta_modelica_data.h

according to https://github.com/OpenModelica/OMCompiler/pull/2397/files and export the FMU again. Details on this bug are given in https://trac.openmodelica.org/OpenModelica/ticket/4899.

CHANGELOG

Changelog for package fmi_adapter_examples

1.0.2 (2018-10-12)

  • Added two sample FMUs with corresponding launch files.

1.0.1 (2018-07-16)

  • Throwing runtime_error in case of failed fmi2 function call in FMIAdapter.

1.0.0 (2018-07-13)

  • Initial version.

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Package Dependencies

No dependencies on ROS packages.

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmi_adapter_examples at answers.ros.org

No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.