As mentioned in the Installation page, Docker is potentially the easiest way to install PRISMS-PF. However, it is not performant and unsuitable for large simulations. We'll get into those reasons with a brief introduction to Docker.

Introduction to Docker

Docker is a platform that allows you to run applications in containers. What are containers? Containers are typically stripped down versions of virtual machines that allow you to run an application in an isolated and reproducible environment. This custom environment is defined by a Dockerfile, which is a text file that contains all the instructions to build the container image. The image can then be run on any machine that has Docker installed, regardless of the underlying operating system.

Importantly for PRISMS-PF, Docker allows you to run our software without needing to install any dependencies. All you have to do is download the Docker image! Depending on your operating system and the difference (if any) between the your hardware and the emulated hardware, the running of a Docker image may add some overhead, which will slow down your simulations. Additionally, with the Docker image, you're stuck with the image we provide. If you want to change the compiler, the configuration of dependencies, or any other things, you should consider Installing from Source instead. If you would like to learn more about Docker, here is a nice resource.

Installation with Docker

To install PRISMS-PF with Docker, you will need to have Docker installed on your machine. You can find instructions for installing Docker on the official Docker website.

After you have installed Docker, find a working directory where we can put your files. This is where we will clone PRISMS-PF so you can interact with the files and applications there.

Note: In the Docker image, PRISMS-PF has been installed system-wide. You don't have clone PRISMS-PF again if you already have your own applications.

mkdir ~/prisms_pf_docker

git clone https://github.com/prisms-center/phaseField.git

Next, we will pull the docker image with

docker pull landinjm/prisms-pf:alpine-master-minimal

Finally, we will launch an interactive container with

docker run -it -v ~/prisms_pf_docker/phaseField:/home/prisms-pf/phaseField

landinjm/prisms-pf:alpine-master-minimal

You can then run the applications in the container as you would normally. See the Tutorial for more information.