OpenMPS with Docker

Install Docker

Installing Docker can be done by following the instructions here.

Running the QuSP/OpenMPS Docker Image

1) From the command-line, issue this command to launch the Docker container:

mkdir -p workspace && cd workspace && \
docker run --rm --interactive --tty --publish 8888:8888 \
           --volume $(pwd):/workspace/external qusp/openmps:3.1

Note: this creates a workspace directory in your present working directory, and mounts this directory as a virtual volume in your container under /workspace/external. Anything saved to /workspace/external in the container will be available under $(pwd)/workspace on your machine.

Once in the container, you should see something like this:

(openmps) root@35f86d7c5db5:/workspace# ls
examples  external  utils

2) To run the first OpenMPS example (called 01_IsingStatics.py) from the command-line, type

python examples/01_IsingStatics.py --PostProcess=False && \
python examples/01_IsingStatics.py --PostProcess=True
cp 01_IsingStatics.pdf external/

This will produce a plot called 01_IsingStatics.pdf under the $(pwd)/workspace directory. To view it, use your file browser, navigate to your $(pwd)/workspace, and open the file. To view all available examples, type

ls examples

The first three examples produce plots: 01_IsingStatics.py, 02_BoseHubbardStatics.py, 03_BoseHubbardDynamics.py

3) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:

bash utils/start-jupyter.sh

4) Then navigate to http://localhost:8888/lab