Skip to content

Ptolemy GUI

Jump to bottom
Jeroen van Maanen edited this page Sep 5, 2018 · 15 revisions

The ROBOpop software components are built around the Ptolemy II framework. By default the integrated system is deployed as a collection of RESTful web services. To experiment, however, it is much more convenient to use the Ptolemy Graphical User Interface, than hand-crafting Ptolemy models in XML.

Note that, to expose the models created with Ptolemy outside its container, it is necessary to setup a Shared Directory.

An excellent user manual for Plolemy II is available as a PDF download: System Design, Modeling, and Simulation using Ptolemy II

OS/X

Some fiddling is required on OS/X to make the user interface of a Ptolemy instance that is running within a Docker container appear on the display of the host. This page assumes that Docker is installed using the Docker for Mac package.

In addition to Docker you need X Window server on the host. This documentation assumes XQuartz is used.

In the Security tab of the XQuartz Preferences make sure that the feature "Allow connections from network clients" is enabled.

Then, we need to add an IP address that can be reached by Ptolemy. (The X Window server runs on the host, the Ptolemy software that acts as an X Window client runs in a Docker container. The client needs to be able to contact the server.[1]) This IP address needs to be registered with the X Window server using the xhost command. The script docker/robopop/osx-host.sh can be used to arrange this. It also echoes the relevant IP address.

At this point is is possibly necessary to restart XQuarz, or even log off and log on again, to make the new configuration effective.

After that, execute the steps up to, but not including running ./docker-compose-up.sh in the README.

Finaly, run:

  • ./docker-compose-up.sh -v --gui -d "$(./osx-host.sh):0"

Note

[1] Access host (not vm) from inside container

Linux

I would expect this to work:

  • ./docker-compose-up.sh -v --gui

Maybe it is necessary to add -d localhost.

Windows

Not figured out yet

  • Install Git, not only to clone the scripts, but also to get a decent Un*x shell to execute them.
  • Use Xming as an X server?
  • How to connect to the host?
  • Difference between Windows 10 (Docker for Windows on Windows Hyper V) and earlier Windows versions (Docker Toolbox on Oracle VM VirtualBox)

Clone this wiki locally