New in version v23.04.00.
States how many GPUs and what percent of each a test requires.
rapids_test_add(NAME <name> COMMAND <target|command> [<args>...] [GPUS <N> [PERCENT <value>]] [INSTALL_COMPONENT_SET <set>] [WORKING_DIRECTORY <dir>])
Add a test called <name> which will be executed with a given GPU resource allocation.
When combined with
rapids_test_init() informs CTest what
resources should be allocated to a test so that when testing in parallel
oversubscription doesn’t occur. Without this information user execution of
CTest with high parallel levels will cause multiple tests to run on the
same GPU and quickly exhaust all memory.
Specify the test command-line including any arguments. If the first argument provided is an executable target (created by add_executable()) it will automatically be replaced by the location of the executable created at build time.
State how many GPUs this test requires. Allows CTest to not over-subscribe a machine’s hardware.
If no value is provided, the test is considered to not use any GPUs
By default if no percent is provided, 100 is used. State how much of each GPU this test requires.
Record which component that the underlying executable for the test will be installed by. This is used by
rapids_test_install_relocatable()to allow for execution of the installed tests by ctest
Specify the working directory in which to execute the test. If not specified the test will be run with the current working directory set to the value of