Building EMOD source code from CentOS Docker images on Linux host machine

These steps walk you through building the EMOD source code from CentOS Docker images on a Linux host machine running Linux for CentOS 7.7. Before following these steps you must meet the prerequisites in Getting started with building EMOD source code from CentOS Docker images. Although these steps are specific to the dtk-build image, you can use them for the other images by replacing “dtk-build” with the desired image name, such as “dtk-runtime” or “dtk-sfts”.

Download Docker image to Linux host machine

To download Docker image to your Linux host machine type the following at command line prompt:

docker pull docker-production.packages.idmod.org/idm/centos:dtk-build

Run Docker container from Linux host machine

To run Docker image from your Linux host machine type the following at command line prompt:

docker run -it --user `id -u $USER`:`id -g $USER` -v ~/EMOD:/EMOD docker-production.packages.idmod.org/idm/centos:dtk-build

To see additional information about the options used with the “docker run” command, type “docker run –help” at a command line prompt.

Upon completion you will then see a new command prompt for the Docker image, which in this example is as follows:

bash-4.2$

To then build the EMOD executable, Eradication.exe, move to the /EMOD directory:

cd /EMOD

This directories contains the necessary build script and files.

Build binary executable from Docker image running Linux CentOS 7.7 within Linux host machine

To build a binary executable you run the “scons” script. For more information about the build script options, type “scons –help” from within the /EMOD directory. In this example the Generic disease model is built. Type the following at command line prompt:

scons --Disease=Generic

Upon completion you will see the following line at the end of the build process:

scons: done building targets.

For more information, see Build EMOD from source code.

Verify EMOD binary executable

You can verify the successful build of the EMOD binary executable by typing the following at command line prompt:

/EMOD/build/x64/Release/Eradication/Eradication --version

You should see a response similar to the following:

Intellectual Ventures(R)/EMOD Disease Transmission Kernel 2.20.17.0
Built on Oct 25 2019 by luser from master(2d8a9f2) checked in on 2019-04-05 15:49:43 -0700
Supports sim_types: GENERIC.

You can then use this executable for running simulations. For more information, see Run a simulation using the command line for generic, Run a simulation using the command line for HIV, or Run a simulation using the command line for malaria.