This folder contains necessary scripts to do a MUSUBI performance test on Kabuki - the
SX-ACE vector machine at HLRS. For other SX-ACE machine, these scripts should
also be useable.

last update: 2015.4.6
Jiaxing Qi

The MUSUBI performance test is indeed a parameter study that let MUSUBI run on
different number of nodes with meshes that have various number of elements.
With performance data from all these runs, we then are able to analyse the
scaling behaviour of MUSUBI on this machine.

The performance test has to be done with help of SHEPERD - a tool part of APES
simulation toolkit. To get the latest version of SHEPERD, one can do:
  cd apes/sheperd/
  hg pull
  hg update
SHEPERD is based on python scripts, thus no need to compile it.

This folder contains three files:
  * musubi.template is the template file for musubi configuration. Inside it,
    the options: level(determines the number of elements inside a mesh) and
    relaxation(determines the compute kernel that MUSUBI uses) are set as variables
    that will replaced by actual values in param.py.
  * sx-ace.template is the template file for SX-ACE machine job script. Inside
    it, the options nNodes is variable which will replaced by actual values in
    param.py
  * params.py is the parameter study config file in which one specify the actual
    values for a certain parameter in musubi.tempalte and sx-ace.template.
    Here it contains the actual values for level and nNodes which are used by
    musubi.template and sx-ace.template respectively.

After setting the params.py, one can call SHEPERD which can generate the actual
lua files, folders and job scripts for each combination of those parameters
in params.py and submit those jobs.
One can find all those config and job files inside performance folder and its subfolders.
All the performance data of those runs can be found in performance/timing.res
