Home

Awesome

Event-aided Direct Sparse Odometry (EDS)

Direct visual odometry approach using events and frames (CVPR 2022)

License

See LICENSE file

Installation

The easiest way to build and install this package is to use Rock's build system. See this page on how to install Rock. You can use the EDS builconf which tells you how to install and use this library from scratch. There is also the option to build and use this library in a Docker container.

However, if you feel that it's too heavy for your needs, Rock aims at having most of its "library" packages (such as this one) to follow best practices. See this page for installation instructions outside of Rock. It means this library and its dependencies are standard C++ libraries. Therefore you can build your own EDS system based on this code which is out of the Rock ecosystem.

Dependencies

This is an standard C++ library which generates a shared library by default. Dependencies are listed in the manifest file, those are:

Rock CMake Macros

This package uses a set of CMake helper shipped as the Rock CMake macros. Documentations is available on this page. These macros are pure CMake functions, so they are totally independent of the Rock ecosystem.

Library Standard Layout

This directory structure follows some simple rules, to allow for generic build processes and simplify reuse of this project. Following these rules ensures that the Rock CMake macros automatically handle the project's build process and install setup properly.

EDS Folder Structure

directorypurpose
src/Contains all header (.h/.hpp) and source files
src/bundlesThis is the backend optimation from DSO
src/initThis is the DSO initializer class
src/ioI/O wrapper from images and maps different types
src/mappingThis is the pixel selector based on DSO
src/sophusThe Sophus template header-only library based on Eigen
src/trackingThis is the EDS tracker to perform Events to Model alignment
src/utilsSome utils functions
build/ *The target directory for the build process, temporary content
test/Boost Unit test to check basic class functionalities