ComIn provides cmake functions to setup tests with CTest. An example how to use this functions can be found in the User Guide.

comin_add_replay_data

This command registers input data for replay tests. The data must be provided as a download-link in a .tar.gz package. The test_data is downloaded in the target download_test_data which is automatically added as a FIXTURES_SETUP test in the test suite.

comin_add_replay_data(NAME <name>
                      URL <url>
                      MD5HASH <md5hash>
  )

NAME: name of the data. This name must be passed as REPLAY_DATA argument to comin_add_replay_test
URL: download url of the data. Must be a compressed tarball (tar.gz).
MD5HASH: MD5 hashsum to verify the download

ComIn provides predefined datasets:

test_nwp_R02B04 (1 processes, 1 domain)
test_nwp_R02B04_R02B05_nest (3 processes, 2 domains)

comin_add_replay_test

This is a wrapper around add_test that adds a test to the project and takes care of the configuration of the comin_replay.

comin_add_replay_test(NAME <name>
                     [NUM_PROCS <num_procs>]
                     [REFERENCE_OUTPUT <dir>])

NAME: name of the test (forwarded to add_test)
REPLAY_DATA: NAME of the data created with comin_add_replay_data (alternative to REPLAY_DATA_PATH)
REPLAY_DATA_PATH: Path of replay data (alternative to REPLAY_DATA)
NUM_PROCS: Number of processes
REFERENCE_OUTPUT: Path of reference output (optional)

comin_test_add_plugin

Adds a plugin in the comin_nml of a given test. The arguments are forwarded to the comin_nml

comin_test_add_plugin(TEST <test>
                      NAME <name>
                      [PLUGIN_LIBRARY <filename>]
                      [PRIMARY_CONSTRUCTOR <functionname>]
                      [OPTION <string>]
                      [COMM <string>]
                    )

TEST: name of the test the plugin should be added to
NAME: name of the plugin
PLUGIN_LIBRARY: filename of the shared object of the plugin (if any)
PRIMARY_CONSTRUCTOR: name of the primary constructor (default: comin_main)
OPTIONS: a options string passed to the plugin (default: "")
COMM: name of the plugin communicator (defualt: "", meaning no communicator is created for the plugin)

comin_test_add_external_process

Add external process to the test. The processes are appended the mpirun command.

comin_test_add_external_process(TEST <test>
  [NUM_PROCS <n>]
  COMMAND <command>
)

TEST: name of the test the plugin should be added to
NUM_PROCS: Number of external processes
COMMAND: command to be executed on the additional processes