marcusfuchs/modelicainaction

Modelica In Action

Modelica In Action

This repository contains examples that demonstrate how to create, compile and simulate Modelica models using JModelica.org.

Notes

All the make commands mentioned in this guide reference the Makefile located in the root directory of this repository.

Installation

In order to simplify your life the repository contains all the code necessary to create a Docker container that runs JModelica.org. In case you wonder what's a Docker container

Docker containers wrap a piece of software in a complete filesystem that contains everything needed to run: code, runtime, system tools, system libraries – anything that can be installed on a server. This guarantees that the software will always run the same, regardless of its environment (see https://www.docker.com/what-docker for more info).

In this case I created a "recipe", also known as Docker file, that describes how to build a container with installed everything that's needed to work with JModelica.org.

Once created and started, the container and your computer will interact as shown in the following image.

Upon start, some folders included in this repository will be shared with the container, in the meantime the container runs an IPython server. The container exposes the port used by the IPython server to your local machine. In this way you can connect to the IPython server in the container with a browser. Once you access the IPython server you can start working with JModelica.org.

The Docker container is based on a so called image (something similar to a snapshot of a virtual machine). To create the image you have two options

• manually build the image with the command make build-image

• download the image with the command make download-image

The second option is preferable because it doesn't require you to wait while Docker compiles from source JModelica.org and all its dependencies.

You can verify that the container image has been built (or downloaded) using the command docker images. In my case when I run the command I see

$ docker images
REPOSITORY                   TAG                 IMAGE ID            CREATED             SIZE
modelicainaction/jmodelica   1.0                 adcc4c39b0d6        1 hour ago          2.698 GB
ubuntu                       16.04               f753707788c5        8 weeks ago         127.2 MB

Starting the container

Once the container image has been created we can start it. To start the container run the command make start. This command starts the container with installed JModelica.org and an IPython notebook server listening on port 8888. The same port used by the IPython server is exposed by the container and redirected to the localhost. This means that if you open a browser and go to http://127.0.0.1:8888 you should see something like this

By default the container is configured to share the following folders

• modelica - a folder containing the source code of the Modelica models used in the examples

• ipynotebooks - a folder containing the ipython notebooks with examples

Every Modelica model located in the folder modelica will be immediately visible to JModelica.org. The same is true for the folder ipynotebooks, every notebook it contains will be automatically visible when you open the browser and go to http://127.0.0.1:8888.

You can verify that the container is running with the command docker ps -a

$ docker ps -a
CONTAINER ID        IMAGE                            COMMAND                  CREATED             STATUS              PORTS                      NAMES
639bd33a27fb        modelicainaction/jmodelica:1.0   "sh -c 'ipython noteb"   4 hours ago         Up 4 hours          127.0.0.1:8888->8888/tcp   prickly_mayer

and you can stop and remove the container (not the container image) with the command docker stop 639bd33a27fb && docker rm 639bd33a27fb where 639bd33a27fb is the container id.