non-det-alle/ns3-ortools

Docker image for experimentation with the NS-3 Network Simulator and Google OR-Tools.

Ns-3 and OR-Tools experimentation suite

Dockerfiles for the ns3-ortools docker image.

A pre-built image can be pulled with docker pull nondetalle/ns3-ortools:latest.

The image contains an installation of the Ns-3 network simulator (v3.36.1), Google's OR-Tools optimization library (v9.2), and the Simulation Execution Manager (SEM) package (v0.3.5) to run Ns-3 experiments campaigns.

OR-Tools bindings are integrated in Ns-3 via a modified ./ns3 Cmake wrapper and can be used in Ns-3 classes. The cURLpp library bindings are integrated as well in the same way.

The image runs jupyter-lab by default, following the configuration from jupyter's docker-stacks.

Usage:

If you are familiar with Ns-3 workflow, nothing is changed. After running and attaching to the image (docker run -ti IMAGE_NAME), your simulations and modules can be copied in the Ns-3 folders (/home/ns3/ns-3-dev) or imported there as an external volume (-v option), and Ns-3 can be built directly or via SEM.

To use jupyter lab from outside run with -p 8888:8888. To work on persistent data run with the -v /your/dir/path:/home/ns3/work option. For more options checkout the jupyter's docker-stacks documentation.

For more info refer directly to the documentations of linked software.