CONTENTS
========

|
|__INPUT_DATASET
|  |__RUN_2406.tar.gz
|  |__RUN_4812.tar.gz
|__OUTPUT_DATASET
|  |__RUN_2406_nproc_16
|  |  |__benchmark.out
|  |__RUN_4812_nproc_512
|     |__benchmark.out  
|__README
|__SRC
   |__src_milc.tar.gz



INTRODUCTION
============
This code is employed to perform lattice QCD simulations. It is 
based on the publicly available MILC code, opportunely modified 
to address a specific scientific problem which is currently run 
on CINECA HPC systems.

The MILC Code is a body of high performance research software 
written in C for doing SU(3) lattice gauge theory on several 
different (MIMD) parallel computers in current use. In scalar 
mode, it runs on a variety of workstations making it extremely 
versatile for both production and exploratory applications. 

We provide two datasets, with lattice size of 24^3x06 and 48^3x12.  


COMPILING THE CODE
========================
To compile the code please follow these steps: 

1) untar the compressed file of the source code src_milc.tar.gz

   tar xzvf src_milc.tar.gz


2) Enter the source code directory 
 
   cd src_milc/ks_imp_rhmc/ks_imp_rhmc


3) obtaining the executable. You can use the Makefile 
"Makefile_GALILEO_wSciDAC" as a template. 

   make -f Makefile_GALILEO_wSciDAC clean su3_rhmc_hisq

'su3_rhmc_hisq' is the executable file to be used whitin this
benchmark.



RUNNING THE BENCHMARK
=====================
To run the benchmark, please follow these instructions:

1) untar the compressed file containing the dataset which can be found 
in the INPUT_DATASET folder. For example, issue the command:

   tar xzvf RUN_2406.tar.gz

2) enter the directory

   cd RUN_2406


3) run the benchmark by issuing a command like

  mpirun $BIN_DIR/su3_rhmc_hisq < benchmark.in > benchmark.out

where $BIN_DIR points to the path where the executable su3_rhmc_hisq
is located.

Please, for each dataset, provide us at least four results including
the reference configurations (16 cores and 512 cores, or the maximum 
configuration available).