Kitware Analytics Toolkit
KWANT is an open source C++ toolkit for computing scores and other metrics for object tracking systems.
Pending support for e.g. GeographicLib in kwiver, this release only supports pixel-coordinate AOIs.
For more information on how KWANT achieves this goal, and how to use KWANT visit our documentation site
Directory Structure and Provided Functionality
|CMake||CMake helper scripts|
|doc||Documentation, manuals, release notes|
|scoring_framework||The scoring algorithms|
|utilities||Various utility filters|
KWANT requires, at a minimum, Git, CMake, and a C++ compiler.
KWANT is built on top of the KWIVER toolkit. which is in turn built on the Fletch super build system.
You will need to have KWIVER already built for KWANT to use when building.
You may run cmake directly from a shell or cmd window. On unix systems, the ccmake tool allows for interactive selection of CMake options. Available for all platforms, the CMake GUI can set the source and build directories, options, "Configure" and "Generate" the build files all with the click of a few button.
We recommend building KWANT out of its source directory to prevent mixing source files with compiled products. Create a build directory in parallel with the KWANT source directory for each desired configuration. For example :
||contains the code from the git repository|
||contains the built files for the release configuration|
||contains the built files for the debug configuration|
Basic CMake generation via command line
The following example will pull and build Fletch and KWIVER along with the DIVA code base.
It assumes your terminal/command is working in the
# cmake usage : $ cmake </path/to/kwiver/source> -D<flags> $ cmake ../../src -DCMAKE_BUILD_TYPE=Release
Using a prebuilt Fletch
If you would like to point DIVA to a prebuilt version of Fletch, specify the fletch_DIR flag to cmake. The fletch_DIR is the fletch build directory root, which contains the fletchConfig.cmake file.
$ cmake ../../src -DCMAKE_BUILD_TYPE=Release -Dfletch_DIR:PATH=<path/to/fletch/build/dir>
You must ensure that the specified build of Fletch has enabled all the appropriate flags for use by KWIVER and DIVA. The required flags can be found in this file : CMake/add_project_fletch.cmake
Using a prebuilt KWIVER
If you would like to point DIVA to a prebuilt version of KWIVER, specify the kwiver_DIR flag to cmake. The kwiver_DIR is the KWIVER build directory root, which contains the kwiver-config.cmake file. NOTE As KWIVER requires a Fletch directory, the build will ignore the fletch_DIR variable and use the Fletch that was used to build KWIVER.
$ cmake ../../src -DCMAKE_BUILD_TYPE=Release -Dkwiver_DIR:PATH=<path/to/kwiver/build/dir>
You must ensure that the specified build of KWIVER was build with a fletch that was built with all necessary options. KWIVER must have also been built with all the appropriate flags for use by DIVA. The required flags can be found in this file : CMake/add_project_kwiver.cmake
This framework requires track_oracle to be turned on in [kwiver](https://github.com/Kitware/kwiver).
Once your CMake generation has completed and created the build files,
compile in the standard way for your build environment. On Linux
this is typically running
make. Visual Studio users, open the <path/to/KWANT/build/dir>/KWANT.sln
Please join the kwiver-users mailing list to discuss DIVA/KWIVER or to ask for help with using DIVA/KWIVER. For announcements about DIVA and other projects built on KWIVER, please join the kwiver-announce mailing list.