openvino/inference-engine/tests

Inference Engine Test Infrastructure

This is OpenVINO Inference Engine testing framework. OpenVINO Inference Engine test system contains:

• Unit tests
  This test type is used for detailed testing of each software instance (including internal classes with their methods) within the tested modules (Inference Engine and Plugins). There are following rules which are required for Unit Tests development:

  • All unit tests are separated into different executables per each tested module.

  • Unit test folder for a particular module should replicate SRC folder layout of the corresponding tested module to allow further developers get better understanding which part of software is already covered by unit tests and where to add new tests if needed.

    Example: We have network_serializer.h and network_serializer.cpp files within the src folder of the tested Inference Engine module. Then, new network_serializer_test.cpp file should be created within the root of the Unit Test folder for this module. This test file should cover all the classes and methods from the original files.

    Example: We have ie_reshaper.cpp within the src/shape_infer subfolder of the tested module. In this case new shape_infer subfolder should be created within the the root of the Unit Test folder for this module. And new ie_reshaper_test.cpp file should be created within this newly created subfolder. This test file should cover all the classes and methods from the original file.

  • Each Unit Test should cover the only target classes and methods. If needed, all external interface components should be mocked. There are common mock objects provided within the common Unit Test Utilities to stub the general Inference Engine API classes.

    Example: We have cnn_network_impl.hpp and cnn_network_impl.cpp files within the src folder of the tested module. In this case, new cnn_network_impl_test.cpp file should be created and it should contain tests on CNNNetworkImpl class only.

  • It's not prohibited to have several test files for the same file from the tested module.

  • It's not prohibited to create a separate test file for a specific classes or functions (not for the whole file).

• Functional tests
  This test type is used to verify public Inference Engine API. There are following types of functional tests:

  • inference_engine_tests are plugin-independent tests. Used to verify Inference Engine API methods which don't involve any plugin runtime. E.g. network_reader, network_serializer, precision tests.
  • plugin_tests are plugin-dependent tests. These tests require plugin runtime to be executed during testing. E.g. any tests using ExecutableNetwork, InferRequest API can only be implemented within this test group.

  Example: Any new test on creating of a CNNNetwork object and checking of its output info should be included to to the Inference Engine Functional tests suite. But any new test containing reading of a network and loading it to a specified plugin is always the plugin test.

  There are following rules which are required for Functional Tests development:

  • All Functional tests are separated into different executables for the Inference Engine and each plugin.

  • Pre-converted IR files must not be used within the new Functional Tests. Tested models should be generated during the tests execution. The main method to generate a required model is building of the required NGraph function and creating of a CNNNetwork using it. If a required layer is not covered by Ngraph it's allowed to build IR file using xml_net_builder utility (please refer to the ir_net.hpp file). IR XML files hardcoded as strings within the test code should not be used.

  • All the plugin test cases are parametrized with (at least) the device name and included to the common funcSharedTests static library. This library is linked to the Plugin Test binaries. And all the plugin developers just add required test instantiations based on the linked test definitions to own test binary. It should be done to make all the shared test cases always visible and available to instantiate by other plugins.

    Note

    : Any new plugin test case should be added to the common test definitions library (funcSharedTests) within the DLDT repository first. And then this test case can be instantiated with the required parameters inside own plugin's test binary which links this shared tests library.

    Note

    : funcSharedTests library is added to the developer package and available for closed source development.

  • All the inference engine functional test cases are defined and instantiated within the single test binary. These test cases are not implemented as a separate library and not available for instantiations outside this binary.

• Inference Engine tests utilities
  The set of utilities which are used by the Inference Engine Functional and Unit tests. Different helper functions, blob comparators, OS specific constants, etc are implemented within the utilities.
  Internal namespaces (for example, CommonTestUtils::, FuncTestUtils:: or UnitTestUtils::) must be used to separate utilities by domains.

  Note

  : All the utilities libraries are added to the developer package and available for closed source development.