Content¶
Headers¶
This is an overview of how the headers are organised in the installation directory for the CV module.
Below, <install-prefix> refers to the path where the SDK is installed. The default values are:
/usr for Ubuntu
C:\Program Files\Prophesee for Windows
The headers of the SDK CV module are grouped semantically under high-level folders:
<install-prefix>/include/metavision/sdk
├── cv
│ ├── algorithms
│ ├── configs
│ ├── events
│ │ ├── detail
│ │ └── ...
│ ├── pipeline
│ └── utils
│ ├── detail
│ └── ...
└── other modules...
In addition to the headers, some folders optionally have a detail folder. The detail folders contain the code that has been removed from the main headers in order to make them more readable. Detail folders include method implementations, helpers, macros, etc. which are not meant to be included directly to your application.
Algorithms¶
The algorithms folder contains a collection of common algorithms used to process or filter events. These algorithms are, most of the time, implemented as classes with a process method working on ranges of events. Similarly to what is used in the C++ STL algorithms (http://www.cplusplus.com/reference/algorithm), we represent the ranges of events by a pair of iterators or pointers for the input and a starting iterator or a pointer for the output.
For example, ActivityFilterAlgorithm
implements an algorithm
that filters events based on their activity. It exposes this function template, which takes a pair of iterators
as input (first and last) and outputs filtered events to the d_first iterator:
template<class InputIt, class OutputIt>
inline OutputIt process(InputIt first, InputIt last, OutputIt d_first)
Configs¶
The configs folder contains headers defining the configurations for some of algorithms.
Events¶
The events folder contains class definitions for events output by processing algorithms, like
Metavision::Event2dFrequency
, Metavision::EventOpticalFlow
, etc.
Pipeline¶
The pipeline folder contains a header that defines the
FlowFrameGenerationStage
class implementing a
pipeline stage for
FlowFrameGeneratorAlgorithm
.
Utils¶
The utils folder contains assorted utilities that are deemed generally useful but don’t belong to any other category.
Additional content¶
Additional content is located under the <install-prefix>/share/metavision/sdk folder. This share folder includes code samples.
<install-prefix>/share/metavision/sdk
├── cv
│ └── samples
└── other modules...