Dinamica EGO Docker: Run the environmental modeling platform Dinamica EGO alongside geospatial R tooling in a Docker container for simplified deployment and development.
This repository provides the tooling for containerizing a rocker/r-ver and Dinamica EGO environment. Dinamica EGO is a sophisticated platform for environmental modeling, offering a wide range of modeling and analysis capabilities.
Please note: Dinamica EGO is copyrighted software, and its use is subject to the terms and conditions of the Dinamica EGO License Agreement. Ensure that you have the necessary permissions to use and distribute this software in accordance with the license.
The docker image provides direct access to the
DinamicaConsole
.
Because the Dinamica license forbids redistribution of the software, you need to build the image for yourself.
To build the image yourself, you only need to clone this repository and run:
docker build -t dinamica-ego:latest .
To run a script /my/folder/example.ego
from the mounted folder, run:
docker run -v /my/folder/:/model dinamica-ego example.ego
Dinamica EGO can communicate with external applications, like R
, by exposing a
communication session, as explained
on the wiki.
For the R integration to work, the container includes a pre-installed version of R.
To install more dependencies, add them to the base environment manually.
The container does not default to starting a coupled R/Dinamica session.
Dinamica EGO uses a temporary directory to store intermediate files.
These are stored inside the DINAMICA_EGO_8_TEMP_DIR="/tmp/dinamica"
environment variable.
If you prefer, you can mount a host directory into the container:
docker run -v /my/temp/dir/:/tmp/dinamica dinamica-ego
The second way to use the container is to start an interactive shell session:
docker run -it --rm -v /my/folder/:/model dinamica-ego bash
The environment variable DINAMICA_EGO_CLI
points to the DinamicaConsole
executable.
For further details, take a look at the Dockerfile.
Warning
The Apptainer definition file has not been tested with Dinamica EGO 8.3.
To use the image with Apptainer
you need to convert the image to a SIF image.
To respect the various caveats migrating to Apptainer,
there exists the example definition file dinamica_ego.def
.
Please be aware that the use of Dinamica EGO is subject to the terms and conditions of the Dinamica EGO License Agreement. Ensure that you have the necessary permissions and comply with the licensing terms when using this software.
- Dinamica EGO
- Copyright 1998-2024 Centro de Sensoriamento Remoto / Universidade Federal de Minas Gerais - Brazil.
- All Rights Reserved.
- No warranty whatsoever is provided.
- This repo is licensed under the MIT License
If you have any questions or suggestions, please write an issue in this repository. For questions regarding Dinamica EGO, find the Guidebook 2.0, FAQ, and Google Group online.