blob: 63d110b79a2a652f7e93afcace7513db6de97848 [file] [log] [blame]
The OpenVX conformance tests README
Building the conformance tests
The included CMake script provides support for linking the tests with your
pre-built OpenVX library binaries.
The following CMake variables are supported:
* OPENVX_USE_IX - Compile export/import test case or not.
* OPENVX_USE_NN - Compile neural network test case or not.
* OPENVX_LIBRARIES - semicolon separated list of shared/static libraries to link
with. If there are link order dependencies between your
libraries, then the libraries have to be specified in
correct order. Use absolute paths if your librarieas are
not in system path.
* OPENVX_INCLUDES - absolute path to the OpenVX headers (excluding the "VX"
* OPENVX_DEFINITIONS - semicolon separated list of preprocessor definitions
required to compile the suite for target platform.
* OPENVX_CFLAGS - semicolon separated list of extra compiler flags
required to compile/link the suite for target platform.
Examples for Linux:
Use the following commands to build the test suite for the OpenVX baseline only:
export OPENVX_DIR=<path to prebuilt OpenVX>
cd <build dir>
cmake \
-DOPENVX_LIBRARIES=$OPENVX_DIR/lib/\;$OPENVX_DIR/lib/\;pthread\;dl\;m\;rt \
cmake --build .
Use the following commands to build the test suite with import-export and
neural network KHR extensions activated:
export OPENVX_DIR=<path to prebuilt OpenVX>
cd <build dir>
cmake \
-DOPENVX_LIBRARIES=$OPENVX_DIR/lib/\;$OPENVX_DIR/lib/\;pthread\;dl\;m\;rt \
cmake --build .
Running the tests
1. Set your VX_TEST_DATA_PATH environment variable to point to the
"<conformance_tests>/test_data" directory.
2. For Linux/Mac OS X you might need to set the LD_LIBRARY_PATH
3. To run the tests:
<build binary path>/vx_test_conformance [--filter=<filter>]
[--run_disabled] [--global_context=0|1] [--check_any_size=0|1]
[--show_test_duration=0|1] [--verbose] [--testid=<testid>]
[--list_tests] [--quiet]
--filter=<filter> - selects only matching tests for execution
<filter> - specifies a filter as in Google Test: "a
':'-separated list of wildcard patterns (called the
positive patterns) optionally followed by a '-' and
another ':'-separated pattern list (called the
negative patterns). A test matches the filter if and
only if it matches any of the positive patterns but
does not match any of the negative patterns."
--run_disabled - include a set of tests that are disabled by default,
which are not part of the conformance suite
--global_context - create new a vx_context for every test (default, "=0")
or execute all the tests inside single vx_context ("=1")
--check_any_size - use a restricted set of image sizes (usually VGA) for
testing nodes and immediate mode functions (default,
"=0") or include other sizes as well ("=1").
Conformance only requires the default, restricted set.
--show_test_duration - enable/disable test time in the test log. If
this option is not selected (default) no timing
information will be printed.
--list_tests - list the tests without running them
--testid=<testid> - specifies report custom identifier for tests run
--verbose - enable extra output
--quiet - minimize extra/headers output
In order to pass the conformance test, the tests should be run with all the
options set to their default values, so you can run without specifying any
options, i.e., just:
<build binary path>/vx_test_conformance
with no options. The options are for information and debug purposes only.
Test data
The test data directory contains:
- several natural images (VGA resolution) used as inputs for tested algorithms;
- generated reference output data provided by OpenCV 2.4.7 algorithms.
All the required test data is included in the conformance tests package.
You do NOT need to regenerate this data in most cases.
Refer to the README from the "test_data_generator" directory for more