MILC is a collaborative project used and maintained by scientists studying the theory of strong interactions of subatomic physics, otherwise referred to as quantum chromodynamics (QCD). MILC performs simulations of four-dimensional SU(3) lattice gauge theory on MIMD parallel machines. MILC is publicly available for research purposes and publications of work using MILC or derivatives of this code should acknowledge this use.
Before running the NGC MILC container please ensure your system meets the following requirements.
The following examples demonstrate how to run the NGC MILC container on a single GPU using the SC15 student cluster competition benchmark.
The SC15 student cluster competition benchmark script is located
/workspace/examples directory inside of the container. Please
note that the SC15 cluster data will be downloaded by the script if it is not
already available in the directory mounted to
/data in the container.
Throughout this example the container version will be referenced as
$TAG, replace this with the tag you wish to run.
su3_rhmd_hisq: primary MILC application binary
Example command form:
su3_rhmd_hisq -geom $GEOM $INPUT_FILE $OUTPUT_FILE
$GEOM: a grid of virtual processors for GPU optimization
$INPUT_FILE: Input file to be processed
$OUTPUT_FILE: file in which to write results to
docker run --gpus all -it --rm -v $(pwd)/data:/data -v $(pwd):/sc15_cluster nvcr.io/hpc/milc:$TAG /workspace/examples/sc15_cluster.sh 1
Docker versions below 1.40 must enable GPU support with
docker run --rm --runtime nvidia --ipc=host -v $PWD:/host_pwd -w /host_pwd nvcr.io/hpc/milc:$TAG /workspace/examples/sc15_cluster.sh 1
mkdir run data singularity run --nv -B $(pwd)/data:/data -B $(pwd)/run:/sc15_cluster docker://nvcr.io/hpc/milc:$TAG /workspace/examples/sc15_cluster.sh 1
There is currently an issue in Singularity versions below v3.5 causing the
LD_LIBRARY_PATH to be incorrectly set within the container environment. As a workaround The
LD_LIBRARY_PATH must be unset before invoking Singularity:
LD_LIBRARY_PATH="" singularity run --nv -B $(pwd)/data:/data -B $(pwd)/run:/sc15_cluster docker://nvcr.io/hpc/milc:$TAG /workspace/examples/sc15_cluster.sh 1