===========
data/README
===========

This directory contains input files 'bqcd.XXX.input' for testing BQCD
(XXX = run number), along with auxillary input files and expected
output files 'bqcd.XXX.output'.

All of these runs write configurations in ILDG format, and hence
depend on the two ILDG metadata template files
'qcdsf-configuration-05.xml' and 'qcdsf-ensemble-05.xml'.

- Runs -

200
  Test input for Nf = 2

202
  Test for SIMD: 200 on a larger lattice: 32*4*4*4

210
  Same as 200, but with generalized integrators
  Output should be near identical to 200

300
  Test input for Nf = 2 + 1

310
  Test input for Nf = 2 + 1 with replay trick

320
  Test input for Nf = 2 + 1 with RHMC tuning
  also requires input: 'rangelist', 'fractiontolerance'

330
  Test input for Nf = 2 + 1 with QED

331
  Same as 330, but with hspec measurement
  Also requires input: 'myhpara'
  Also produces output: 'myhout.000001'

340
  Test input for Nf = 2 with RHMC

350
  Test input for Nf = 3 with RHMC

360
  Test input for Nf = 2+1 with the axion
  Also requires input: 'pseudoscalar'

410
  Test input for Nf = 2+1 with polynomial filtering on both
  psuedofermions

411
  Same as 410, but with the polynomials being read from file
  Also requires input: 'testpoly_nf1_p4.txt', 'testpoly_nf2_p4.txt'

500
  test input for NF = 3 SLOC with SF boundary condition
  Also produces output: 'fafPhist.000001'


- Auxillary input files -
cool.list
  a cooling list (see manual)

qcdsf-configuration-05.xml
  an example ILDG metadata template for configurations

qcdsf-ensemble-05.xml
  an example ILDG metadata template for ensembles

myhpara
  an example hadron spectrum measurement parameter file

rangelist
  a list of ration approximation

fractiontolerance
  a list of relaxation parameter for each fraction in multishift CG

pseudoscalar
  gamma_5 matrix in format of CPT breaking term
  is used in simulaions with axion or theta term

testpoly_nf2_p4.txt
  Data file for a 4th order polynomial filter that approximates
  (MtM)^-1, suitable for double-flavour pseudofermions.

testpoly_nf1_p4.txt
  Data file for a 4th order polynomial filter that approximates
  (MtM)^{-1/2}, suitable for single-flavour pseudofermions.


- Auxillary output files -
fafPhist.00001
  SF output to determine non-perturvative cSW

myhout.000001
  hadron spectrum measurement output by 'myhpara'

bqcd.XXX.trace (trace.log in default case)
  detail log file for trace measurements
