CP2K Open Source Molecular Dynamics

User Tools

Site Tools

Trace:
dev:regtesting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
dev:regtesting [2021/06/02 13:11] – tmuellerdev:regtesting [2023/10/19 13:59] – Update flags krack
Line 11: Line 11:
 ===== How does it work? ===== ===== How does it work? =====
  
-The regression test suite is run using the [[src>tools/regtesting/do_regtest | do_regtest]] script. +The regression test suite is run using the [[src>tests/do_regtest.py | do_regtest]] script. 
 It performs the following tasks: It performs the following tasks:
    * performs a realclean build of the source    * performs a realclean build of the source
Line 34: Line 34:
 ==== Step 2: Running ==== ==== Step 2: Running ====
 <code> <code>
-$ tools/regtesting/do_regtest --help +$ tests/do_regtest.py -h 
-Usage: do_regtest [OPTION] +usage: do_regtest.py [-h] [--mpiranks MPIRANKS] [--ompthreads OMPTHREADS] 
-Run the CP2K regression test suite +                     [--maxtasks MAXTASKS] [--num_gpus NUM_GPUS] 
-Example: do_regtest -c my_regtest.conf+                     [--timeout TIMEOUT] [--maxerrors MAXERRORS] 
 +                     [--mpiexec MPIEXEC] [--smoketest] [--valgrind] 
 +                     [--keepalive] [--flagslow] [--debug] 
 +                     [--restrictdir RESTRICTDIR] [--skipdir SKIPDIR] 
 +                     [--workbasedir WORKBASEDIR] arch version
  
-General: +Runs CP2K regression test suite.
-  -h, -help, --help         print this help screen. +
-  -c, -config FILE          read any of the following configuration switches from FILE. +
-  -cp2kdir PATH             location of cp2k source tree relative to current working directory. +
-  -dirout PATH              root path of output folder (default: current working directory). +
-  -mpiexec EXE              name of the executable to run mpi-ranks. Default: mpiexec.+
  
-Build: +positional arguments: 
-  -version VERSION          VERSION passed to make. Default: sopt. +  arch 
-  -arch ARCH                ARCH passed to make. Default: Linux-x86-64-gfortran. +  version
-  -quick                    rebuild if needed, but without realclean. Default: off. +
-  -nobuild                  do not build cp2k, rely on user's build. Default: off.+
  
-Runtime: +options: 
-  -mpiranks NRANKS          number of mpi-ranks. Default: 2 for parallel versions, 1 for serial. +  -h, --help            show this help message and exit 
-  -ompthreads NTHREADS      number of OpenMP threads. Default: 2 for smp versions otherwise 1. +  --mpiranks MPIRANKS 
-  -maxtasks NPROCS          total number of processor to use. Default: `nproc`. +  --ompthreads OMPTHREADS 
-  -maxbuildtasks NPROCS     total number of processor to use for compilation. Default taken from -maxtasks. +  --maxtasks MAXTASKS 
-  -jobmaxtime SECONDS       maximum execution time of a single test. Default 600. +  --num_gpus NUM_GPUS 
-  -farming                  test via a single farming run (only for parallel cp2k). +  --timeout TIMEOUT 
- +  --maxerrors MAXERRORS 
-Testing: +  --mpiexec MPIEXEC 
-  -noreset                  do not reset the reference outputs. Default: off. +  --smoketest           Runs only the first test of each directory. 
-  -shard ISHARD NSHARDS     do sharding: Divide the test dirs into NSHARD subsets and only run the ISHARD-th set. +  --valgrind            Runs tests under Valgrind memcheck. Best used together with --keepalive. 
-  -skiptest                 do not run test, only build. Default: off. +  --keepalive           Use a persistent cp2k-shell process to reduce startup time. 
-  -skipunittest             do not run unit tests. Default: off. +  --flagslow            Flag slow tests in the final summary and status report. 
-  -skipdir TESTDIR          do not run tests in TESTDIR. This switch can repeated. +  --debug 
-  -restrictdir TESTDIR      run only tests in TESTDIR. This switch can repeated. +  --restrictdir RESTRICTDIR 
-  -retest                   run only tests in directories, which had failing tests in previous run. +  --skipdir SKIPDIR 
- +  --workbasedir WORKBASEDIR
-Exit codes: +
-    0   clean exit with testing +
-    3   problem with realclean +
-    4   build errors +
-    5   problem with retest option - no TEST directory with latest test results found +
-    6   problem with retest option - no error summary exists in the last TEST directory +
-    7   reference directory is locked +
-    8   ctrl-C (SIGINT) and various other signals trapped +
- +
-For more information visit: <http://cp2k.org/dev:regtesting>+
 </code> </code>
  
Line 207: Line 194:
 NNODES_SINGLE_TEST=1 NNODES_SINGLE_TEST=1
 SRUN_CMD="srun --cpu-bind=verbose,cores" SRUN_CMD="srun --cpu-bind=verbose,cores"
 +
 +# to run tests across nodes (to check for communication effects), use:
 +# NNODES_SINGLE_TEST=4
 +# SRUN_CMD="srun --cpu-bind=verbose,cores --ntasks-per-node 2"
  
 # the following should be sufficiently generic: # the following should be sufficiently generic:
Line 262: Line 253:
 CP2K_VERSION="psmp" CP2K_VERSION="psmp"
 </code> </code>
 +
 +**Note**: if the ''%%tools/regtesting%%'' is not in that minimal directory tree as shown above you may get an error about the ''%%timings.py%%'' not found and there will be no timings. If you need those you should link/copy the regtesting scripts into ''%%tools/regtest%%'' of that minimal directory tree, at which you point you can leave the ''%%CP2K_REGTEST_SCRIPT_DIR%%'' variable undefined again.
dev/regtesting.txt · Last modified: 2023/10/19 14:03 by krack