Skip to main content

The DIVA Framework is a software framework designedto provide an architecture and a set of software modules whichwill facilitate the development of DIVA analytics

Project description

DIVA

Deep Intermodal Video Analytics (DIVA) Framework

The DIVA Framework is a software framework designed to provide an architecutre and a set of software modules which will facilitate the development of DIVA analytics. From the DIVA Website:

The DIVA program seeks to develop robust automatic activity detection for a multi-camera streaming video environment. Activities will be enriched by person and object detection. DIVA will address activity detection for both forensic applications and for real-time alerting.

Resources

DIVA Docker Image

Kitware maintains a Docker image with DIVA prebuilt. The Dockerfile used to build the image can be found here.

Pull the image from Dockerhub:

docker pull kitware/diva:latest

(https://hub.docker.com/r/kitware/diva)

or build the DIVA image using the dockerfile:

docker build -t diva:tagname .

DIVA Python wheel

Kitware also provides a pared down DIVA build as a Python 3 wheel. The DIVA wheel depends on the Kwiver wheel, and the following system dependencies (installed via apt-get in this example):

# The following example uses the Ubuntu apt-get package manager
# These command may differ depending on your Linux flavor and package manager
sudo apt-get install libgl1-mesa-dev libexpat1-dev libgtk2.0-dev liblapack-dev python3.6 python3-pip

Upgrade PIP if older than version 19.3.1:

pip3 install -U pip

Install the wheels:

pip install kwiver diva-framework

Verify the installation:

plugin_explorer --proc diva

The plugin diva_experiment should be listed in the output.

Building DIVA

Dependencies

DIVA requires, at a minimum, Git, CMake, a C++ compiler, and a Python 2.7 environment.

The DIVA Framework repository is structured as a CMake “super-build” which fetches, configures and builds both KWIVER and Fletch along with the DIVA Framework specific code. While most of the framework’s dependencies are carried by Fletch, there may be some preparation of your development system required before you can successfully build the framework.

On Ubuntu systems, for example you’ll want to make sure the following packages are installed on your system:

# The following example uses the Ubuntu apt-get package manager
# These command may differ depending on your Linux flavor and package manager
sudo apt-get install build-essential libgl1-mesa-dev
sudo apt-get install libexpat1-dev
sudo apt-get install libgtk2.0-dev
sudo apt-get install liblapack-dev
sudo apt-get install python2.7-dev

Running CMake

We recommend building DIVA out of its source directory to prevent mixing source files with compiled products. Create a build directory in parallel with the DIVA source directory for each desired configuration. For example :

\DIVA\src

contains the code from the git repository

\DIVA\build\release

contains the built files for the release configuration

\DIVA\build\debug

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 that you are \DIVA\build\release directory. What follows are the commands to configure and build the DIVA framework in several common configurations:

To build a “release” version of DIVA:

$ cmake ../../src -DCMAKE_BUILD_TYPE=Release
$ make -j 4

To build with CUDA enabled:

$ cmake ../../src -DCMAKE_BUILD_TYPE=Release -DDIVA_BUILD_WITH_CUDA=ON
$ make -j 4

To build with CUDNN enabled:

$ cmake ../../src -DCMAKE_BUILD_TYPE=Release -DDIVA_BUILD_WITH_CUDA=ON -DDIVA_BUILD_WITH_CUDNN=ON
$ make -j 4

Next Steps

For more details on building and using the DIVA framework, please see the DIVA Framework Documentation

For general build or code issues, please join the kwiver-users mailing list. For discussions of the DIVA API, please contact diva-te <at> kitware.com to join the diva-API mailing list.

For announcements about KWIVER in general, please join the kwiver-announce mailing list.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

diva_framework-0.0.6-cp37-cp37m-manylinux2014_x86_64.whl (30.9 MB view hashes)

Uploaded CPython 3.7m

diva_framework-0.0.6-cp36-cp36m-manylinux2014_x86_64.whl (30.9 MB view hashes)

Uploaded CPython 3.6m

diva_framework-0.0.6-cp35-cp35m-manylinux2014_x86_64.whl (30.9 MB view hashes)

Uploaded CPython 3.5m

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page