Birds Eye View - Evaluation Version

RidgeRun provides a free evaluation package that you can use to test RidgeRun Bird's Eye View on your own hardware before a full licensing or integration decision. This guide explains what information RidgeRun needs, how to install dependencies, how to run the sample package, and how to troubleshoot issues with enough detail for technical review.

What the evaluation includes?

The evaluation version of Bird's Eye View is fully featured including the GStreamer plugin and the examples, but it has the following limitations:

No source code is provided.
Limited evaluation period (the binary works for a period of 1 month).
The evaluation is licensed under the RidgeRun's Eval License Agreement.

How to request the evaluation version?

Please send us an email to support@ridgerun.com with your request and specifying the following information:

General description of the use case
Target platform (NXP i.MX8, Qualcomm RB5, NVIDIA Jetson Orin, Xavier, etc.)
OS Version (Jetpack version, Ubuntu version, Yocto version, etc.)
Hardware Acceleration (only CUDA and CPU are supported at the time)
Project constraints:
- Number of inputs
- Input size
- Framerate
- Output size
- Lens type

We will use this information to build an evaluation version that runs on your target system within a business week.

Evaluation quickstart

Once you have received the evaluation package, you're ready to proceed with the next steps.

First, run the following command to make sure all the runtime dependencies are installed:

sudo apt update
sudo apt install -y \
  libjsoncpp-dev \
  libopencv-core-dev libopencv-video-dev libopencv-highgui-dev libopencv-videoio-dev \
  gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-base \
  gstreamer1.0-libav gstreamer1.0-plugins-ugly \
  wget unzip

If your system has CUDA support, make sure you follow the vendor instructions to install the required drivers.

At this point, you can proceed to test the Birds Eye View evaluation binary.

Unpack the provided tarball:

tar xf $EVAL_TARBALL

Along with the executable, you have been provided with some sample images and a calibration file. Run the following command to test the sample calibration:

./birds_eye_view -p birds_eye_view.json

You should see the resulting image as below. Press ESC to stop the execution.

Quick start result — Resulting image after running the evaluation binary with the sample images.

Calibrating your own system

The evaluation process was designed so that you can test the software with your own images.

Follow the instructions in the Calibration Guide, step by step, to generate a calibration file.

CALIBRATION GUIDE

Once you have generated the calibration file for your custom images and system, you can test the custom calibration:

./birds_eye_view -p custom_calibration.json

Sample Capture Pipelines

Once you've verified the system functionality with your own calibration, you can modify the calibration file to capture from a different source, such as videos or cameras. This section provides example pipelines to customize the capture source.

Generic Video File Capture

For NXP and x86 platforms when you want to test with pre-recorded videos:

filesrc location=$VIDEO_FILE ! decodebin ! queue ! videoconvert ! video/x-raw,format=RGBx ! appsink name=appsink drop=false sync=true qos=false max-buffers=1 max-lateness=-1

Generic V4L2 Camera Capture

For NXP and x86 platforms when you want to test with cameras:

v4l2src device=$DEVICE ! queue ! videoconvert ! video/x-raw,format=RGBx ! appsink name=appsink drop=false sync=true qos=false max-buffers=1 max-lateness=-1

Jetson Video File Capture

For NVIDIA platforms when you want to test with pre-recorded videos:

filesrc location=$VIDEO_FILE ! decodebin ! queue ! nvvidconv ! video/x-raw,format=RGBA ! appsink name=appsink drop=false sync=true qos=false max-buffers=1 max-lateness=-1

Jetson Argus Camera Capture

For NVIDIA platforms when you want to capture from cameras using the Argus capture path:

nvarguscamerasrc device-id=$DEVICE ! queue ! nvvidconv ! video/x-raw,format=RGBA ! appsink name=appsink drop=false sync=true qos=false max-buffers=1 max-lateness=-1

Jetson V4L2 Camera Capture

For NVIDIA platforms when you want to capture from cameras skipping the Argus capture path:

nvv4l2camerasrc device=$DEVICE ! queue ! nvvidconv ! video/x-raw,format=RGBA ! appsink name=appsink drop=false sync=true qos=false max-buffers=1 max-lateness=-1

Troubleshooting

If, for any reason, you can't get the evaluation to run, start by inspecting the output of the GStreamer debug:

GST_DEBUG=2 ./birds_eye_view -p birds_eye_view.json

If that doesn't reveal the cause, please send us an email to support@ridgerun.com describing the problem, include:

Environment information (Platform, OS version, accelerator, etc...).
GStreamer version (gst-launch-1.0 --gst-version).
Output of GStreamer debug (GST_DEBUG=2 ./birds_eye_view -p birds_eye_view.json).
Calibration images.
Calibration file.
Any output printed by the binary.

FAQ

What should I send RidgeRun to request an evaluation?: Send the platform, operating system version, camera count, resolution, framerate, lens type, accelerator information, and target output requirements.
Can I test the evaluation with my own images?: Yes. First verify the sample package, then create a custom calibration file with the Birds Eye View/Calibration Guide.
What is the fastest way to debug a failed run?: Capture the command line, GStreamer debug output, software versions, and your calibration files so RidgeRun can reproduce the issue.

Contact Us

Request an evaluation from RidgeRun

⇦ Getting Started/Quickstart Guide

Home

Getting Started/How to Get the Code ⇨

❯

Share This Page

Send Email Using