skowrons/azure2 repository overview

⁠Overview

The container is based on AlmaLinux 9 where a working AZURE2 binary is installed. The container uses port 8888 where a Jupyter server is exposed for easy R-matrix analysis through the brick-james package. Most of the most useful package for numerical and statistica analysis are installed as well.

Since docker containers does not have persistent storage, ie. once they are destroyed the data are cancelled, it is advisable to create a persistent volume attached to it. In this way the analysed data can be preserved (see⁠).

⁠Running

The most common issue seems to be the DISPLAY variable, used to let the docker use the GUI of the hosting system. When it is not binded properly, the AZURE2 GUI does not start. The Jupyter server and the analysis tools, however, are not affected by this. The following two commands were tested on several MacOS systems and Linux systems and should cover majority of cases. No testing was performed on Windows systems. For these, the usage of WSL⁠ could be a good workaround.

⁠MacOS

In order to run it on MacOS, use the following commands:

xhost +
docker volume create azure2-volume
docker run -d \
       --name=azure2 \
       --hostname=azure2 \
       --restart=always \
       -p 8888:8888 \
       -e DISPLAY=docker.for.mac.host.internal:0 \
       -v /tmp/.X11-unix:/tmp/.X11-unix \
       -v azure2-volume:/home/azure2/reactions \
       skowrons/azure2:latest bash -c "./entrypoint.sh"

⁠Linux

In order to run it on Linux, use the following commands:

xhost +
docker volume create azure2-volume
docker run -d \
       --name=azure2 \
       --hostname=azure2 \
       --restart=always \
       -p 8888:8888 \
       -e DISPLAY=:0 \
       -v /tmp/.X11-unix:/tmp/.X11-unix \
       -v azure2-volume:/home/azure2/reactions \
       skowrons/azure2:latest bash -c "./entrypoint.sh"

⁠Usage

If started with the previous commands, the docker container for AZURE2 will run indefinitely and will start at each boot. In order to access it, we can run the following:

docker exec -it azure2 bash

which starts a bash session inside our azure2 container. Once inside the container, we can simply run AZURE2 as:

AZURE2

Alternatively, it is possible to run AZURE2 directly:

docker exec -it azure2 AZURE2

In order to exchange files with the docker container please use the following:

docker [source] cp azure2:[destination] # Copy file to container
docker cp azure2:[source] [destination] # Copy file from container

Finally, the container starts a Jupyter server session as well. In order to access it go to: http://localhost:8888⁠

⁠Examples

⁠AZURE2 R-Matrix Summer School 2024

You can find the example at r-matrix-school-2024⁠ repository. To run it:

git clone https://github.com/skowrons94/r-matrix-school-2024.git
cd r-matrix-school-2024/
./setup_linux.sh
docker cp reactions/ azure2:/home/azure2/reactions/

This will start the AZURE2 container, create a azure2-volume if it does not exist, attach it to the container and copy the R-matrix examples to it. The container exposes the port 8888 where a Jupyter server is running. It can be accessed at http://localhost:8888⁠. In order to run AZURE2 GUI instead:

docker exec -it azure2 bash     # Enter in the container
AZURE2                          # Run AZURE2

After this, the AZURE2 window should appear. In case of problems, write to Jakub Skowronski⁠.