Birds Eye View - Quick Start Guide
| ⇦ Getting Started | Home | Getting Started/Evaluating the Product ⇨ |
 |
| Getting Started |
|---|
| How BEV Works |
| User Guide |
| Calibration Guide |
| Calibration Guide Legacy |
| GStreamer |
| Performance |
| Performance Measurements |
| Contact Us |
This wiki will show you how to quickly get started with Birds Eye View. It will use the provided samples and calibration file to show a default scene.
This guide shows how to build and run the RidgeRun Bird’s Eye View (BEV) sample using provided calibration and sample images. It’s designed to help you validate that BEV runs correctly on your NVIDIA Jetson, NXP i.MX8 or Linux workstation before deeper development or integration.
Prerequisites
To follow this guide you will need:
- An NVIDIA Jetson, NXP i.MX8 or x86 Linux machine.
- Birds Eye View source code (included with the purchase).
- The following dependencies installed:
- Git: To clone the repository.
- Meson: To configure the project.
- Ninja: To build the project.
- JsonCPP dev files: For the parameter loading.
- OpenCV dev files: For image loading, processing and displaying.
- GStreamer dev files and plugins: (optional) for image loading.
- QT5 dev files: (optional) for image displaying.
- CppUTest dev files: (optional) for unit testing.
- Doxygen, Graphviz: (optional) for documentation generation.
- Wget, Unzip: (optional) to download and unpack the sample images.
In Debian-based systems (like Ubuntu), you can run the following commands to install the dependencies:
# Update package sources sudo apt update # Install required dependencies with apt sudo apt install -y \ libjsoncpp-dev \ libopencv-dev libopencv-core-dev \ libopencv-video-dev libopencv-highgui-dev libopencv-videoio-dev \ libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ gstreamer1.0-plugins-bad \ gstreamer1.0-plugins-good gstreamer1.0-plugins-base \ gstreamer1.0-libav gstreamer1.0-plugins-ugly \ qtbase5-dev qtmultimedia5-dev libqt5multimedia5-plugins \ git wget unzip libcpputest-dev doxygen graphviz \ python3-pip ninja-build # Install latest version of meson with pip sudo -H pip3 install meson
Installation
Once you have dependencies installed, you can proceed to configure and build the project:
With CUDA acceleration
Recommended for NVIDIA Jetson and x86 systems with NVIDIA GPU:
meson builddir ninja -C builddir
Plain CPU
meson builddir -Dnpp=disabled ninja -C builddir
Running the Sample
Once you've built the project, you can run the example with the provided sample images and calibration file.
cd samples && ./download_samples.sh && cd - ./builddir/examples/birds_eye_view -p examples/birds_eye_view.json
You should see the resulting image as below. Press ESC to stop the execution.
