Home

About

MILC collaboration code for lattice QCD calculations

The MILC Code is a body of high performance research software written in C (with some C++) for doing SU(3) lattice gauge theory on high performance computers as well as single-processor workstations. A wide variety of applications are included.

This Wiki is the best place to learn how to get started with the MILC code. Additional (but sometimes out-of-date) information can be found in milc_qcd/doc/milcv7.pdf.

Quickstart Guide

Getting the MILC Code

It is recommended to use the develop branch of milc_qcd, since that is the active branch. The MILC code can be obtained by doing the following:

git clone --branch develop https://github.com/milc-qcd/milc_qcd.git

Building the MILC Code

• Building the MILC Code
  1. Building MILC for scalar
  2. Building QMP and QIO
  3. Building MILC for parallel (CPU)
  4. Building MILC for GPU (QUDA)

Running the MILC Code

​ MILC executables take as input a structured file of runtime parameters. The structure and content of these input parameter files can differ significantly from application to application, and a good starting point is to look at the sample input files in the test/ directory of the application you want to use. For example, if you want to use the ks_spectrum_hisq target of the ks_spectrum application, look at the parameter files milc_qcd/ks_spectrum/test/ks_spectrum_hisq.*.sample-in.

Sample build and run scripts for different systems can be found in milc_qcd/systems.

Applications

Commonly used applications include:

• Eigensolvers
• Gradient flow
  1. Gauge flow
  2. Fermion flow
• Gauge generation
• Spectrum measurements