Source

enzo-3.0 / run /

The active_particles branch has multiple heads

Filename Size Date modified Message
..
Cooling
Cosmology
DrivenTurbulence3D
FLD
GravitySolver
Hydro
MHD
RadiationTransport
RadiationTransportFLD
run_templates
3.2 KB
4.2 KB
1.6 KB
23.3 KB
The test_runner suite will run a series of tests with the current version of 
enzo.  It compares these new outputs against a set of existing "good" outputs 
(either from analytical solutions or from previous versions of enzo).  It 
returns how the current version of enzo performed on these tests.

You must specify a test destination directory outside of the enzo file 
structure where the tests will executed and tested.  You can also specify 
invididual test tags for choosing the tests to run.  By default, all the tests 
will be run.

In order to run the test_runner suite, go to the enzo/run subdirectory and 
execute:

Usage: ./test_runner.py -o <TEST_DEST_DIR> --<TEST_TAG>=<TEST_TAG_VAL> 

Example: ./test_runner.py -o ~/temp --AMR=True --author="John Wise"

The test tags are (with defaults first followed by alternatives):

name = ''
answer_testing_script = None  'my_test_file.py'
nprocs = 1
runtime = 'short', 'medium', 'long'
hydro = False, True
mhd = False, True
gravity = False, True
cosmology = False, True
chemistry = False, True
cooling = False, True
AMR = False, True
dimensionality = 1, 2, 3
author = 'John Wise'
radiation = None, 'fld', 'ray'
max_time_minutes = 1  

Additional flags are:
  -h, --help            show this help message and exit
  -c COMPARE_DIR, --compare-dir=COMPARE_DIR
                        The directory structure to compare against
  --clobber             Recopies tests and tests from scratch.
  -g GATHER_DIR, --gather=GATHER_DIR
                        Gather test results from this directory into a tar
                        file.
  --interleave          Option to interleave preparation, running, and
                        testing.
  -m MACHINE, --machine=MACHINE
                        Machine to run tests on.
  -o OUTPUT_DIR, --output-dir=OUTPUT_DIR
                        Where to place the run directory
  --repo=REPOSITORY     Path to repository being tested.
  --sim-only            Only run simulations.
  --test-only           Only perform tests.
  --time-multiplier=TIME_MULTIPLIER
                        Multiply simulation time limit by this factor.
  -v, --verbose         Slightly more verbose output.

TEST SUITES:
Three test suites exist: quick (37 tests), push (48 tests), and full (95 tests).  
The larger test suites encompass all tests of the smaller test suites.

QUICK
The quick suite is designed to be run periodically as one works on the code.  The 
estimated run time is 25 minutes.
Run with --quicksuite=True
Gold standard available at: http://enzo-project.org/tests/gold_standard_quick.tar.bz2

PUSH
The push suite should be run immediately prior to pushing changes or issuing a pull 
request.  The estimated run time is 90 minutes.
Run with --pullsuite=True
Gold standard available at: http://enzo-project.org/tests/gold_standard_push.tar.bz2

FULL
The full suite is designed to be run monthly or whenever major changes have been pushed.  
The full suite contains tests that may take up to 10 hours to complete and also 
includes all the FLD tests which require the hypre-yes compile option and HYPRE libraries 
to be installed.  The estimated run time is about 36 hours.
Run with --fullsuite=True
Gold standard available at: http://enzo-project.org/tests/gold_standard_full.tar.bz2