dynawo/dynawo-ci Docker 镜像 - 轩辕镜像

Dynaωo - An hybrid C++/Modelica suite of simulation tools for power systems - Docker Images

![MPL-2.0 License]([] ![Docker Cloud Build Status]([]

[***]

This repository contains Dynaωo's Docker images.

Table of Contents

• About this repository
• User image
• Developer Image
• License
• Maintainers
• Links

About this repository

Dynaωo is an hybrid C++/Modelica open source suite of simulation tools for power systems. It aims at providing power system stakeholders with a transparent, flexible, interoperable and robust suite of simulation tools that could ease collaboration and cooperation in the power system community. To achieve this goal, Dynaωo is based on two mains principles: the use of a high-level modeling language Modelica and a strict separation between modeling and solving parts.

We provide this repository to ease users with Dynaωo' installation and provide a quick way to try the simulation tool.

User image

From Docker Hub

Under the Users folder we provide a Dockerfile to build an image integrating the latest Dynaωo version. This image is available on Docker Hub. Then if you already have docker installed on your machine you can directly execute the following command:

bash
$> docker run -it dynawo/dynawo

The previous command is a very basic one to just test Dynaωo very quickly. We recommend you to create a container by sharing a folder of your host machine so that you can access it inside and outside the container to create your own test cases. You can launch the following command (FOLDER_PATH needs to be modified with appropriate value):

For Linux, Unix and Windows Docker Toolbox (with Docker Quickstart Terminal)

bash
$> docker run -it -e LOCAL_USER_ID=`id -u $USER` -e LOCAL_GROUP_ID=`id -g $USER` -v FOLDER_PATH:/home/dynawo_user/SharedFolder dynawo/dynawo

For Windows Docker Desktop CE

bash
> docker run -it -v FOLDER_PATH:/home/dynawo_user/SharedFolder dynawo/dynawo

For FOLDER_PATH syntax on Windows you can find help here.

Once inside the container the user can use the dynawo alias and launch:

bash
dynawo_user@contaiderID:dynawo$> dynawo nrt

From sources

You can also build your image from sources by following these instructions.

Developer Image

Under the Developer folder we provide a Dockerfile to build an image containing all necessary tools to compile Dynaωo. This time the approach is to store the sources on your machine, so that you can use your favorite IDE to develop, and use the container to compile the code.

Linux, Unix and Windows Toolbox (with Docker Quickstart Terminal)

First you have to build an image with the following commands:

bash
$> git clone [***] dynawo-docker
$> cd dynawo-docker/Developer
$> ./build_docker_image.sh

Then you need to create the container, this time we create a mirror user of you inside the container to be able to access files inside and outside the container. We share your entire HOME inside the container as the HOME of the mirror user in the container. We also provide this account with sudo privileges.

bash
$> ./create_container.sh

Now you can connect to the newly created container with:

bash
$> ./connect_to_container.sh

You can now download and install Dynaωo were you want to on your system, your home folder has been shared inside the container as the home folder of the user in the container (user with the same name uid and gid as you). For this you can use the script provided in the container and launch, we call MY_DYNAWO_PATH the path were you want to install Dynaωo on your machine:

bash
your_user_name@contaiderID:~$> /opt/install_dynawo.sh --prefix MY_DYNAWO_PATH

At the end of the script Dynaωo source code is available on your machine and has been fully compiled, you can then launch:

bash
your_user_name@contaiderID:MY_DYNAWO_PATH/dynawo$> dynawo nrt
your_user_name@contaiderID:MY_DYNAWO_PATH/dynawo$> dynawo help

Windows Desktop CE for Windows

This time you need to launch a Windows command line interpreter. You also need to have Git for Windows installed to first checkout this repository. Then execute the following commands to create the image and a container:

bash
> cd PATH_TO_THIS_REPOSITORY/Developer
> docker build docker build -t dynawo-dev --no-cache .
> docker run -it --name=dynawo-dev -v c:/Users/myName:/home/dynawo_developer dynawo-dev

You need to enable sharing of your C drive, follow official instructions here. Inside the container we created a user named dynawo_developer. You can then install Dynaωo inside the container with the following command:

bash
dynawo_developer@contaiderID:~$> /opt/install_dynawo.sh --prefix MY_DYNAWO_PATH

For MacOS or Windows users we recommend using this solution as no toolchain is provided to compile Dynaωo natively on those OS. In this approach the Docker container is used as a substitute bash, with Linux compiler, to compile the code while still being able to edit Dynaωo source code natively on your machine with your favorite IDE. We also warn about the resources you allowed to the Docker deamon as it could result in very slow compilation or even failures, if it occurs we recommend to increase CPU and RAM allowed to Docker in the settings.

License

Dynaωo is licensed under the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one at [***] You can also see the LICENSE file for more information.

See here for external libraries licenses.

Maintainers

Dynaωo is currently maintained by people at RTE, in case of questions or issues, you can also send an e-mail to ***.

Links

For more information about Dynaωo:

• Consult Dynaωo website
• Contact us at ***