Installation and Setup

From RidgeRun Developer Wiki




Preferred Partner Logo 3






RDS Content

RDS is delivered as a tarball with the following content:


Following, you can find more information related to each product:

  • Video processing: This is a set of tools that will help you process your video for different applications.
    • GstCUDA: Includes several GStreamer elements for filtering and can be used as the base for any custom CUDA-based algorithm. It abstracts all the CUDA complexity, allowing you to focus in the algorithm.
    • CUDA Undistort: Remove distortion from video cameras using our cuda accelerated CudaUndistort.
    • CUDA Stitcher: Stitch several camera feeds together to generate a single panoramic view.
    • GstProjector: Use it to generate immersive 360 videos.
    • Spherical Panorama PTZ: Use it to generate an immersive experience by allowing you to navigate through a 360 video.
    • Birds Eye View: Combine your cameras to generate an aerial (Birds Eye) view.
  • Video Streaming
  • Metadata Injection: Various elements and libraries that allow you to insert metadata in various formats and containers.
    • GstSEIMetadata: Insert any metadata directly into an H264/H265 encoded video.
    • In-band metadata: Insert any metadata into Transport Stream.
    • GstObuMetadata: Insert any metadata into an AV1 encoded video.
    • LibMISB: C/C++/Python library that allows you to encode/decode metata into a MISB standard.
  • Debugging and performance monitoring: A set of tools that helps you debug and allow you to monitor your GStreamer pipelines.
    • GstShark: A set of GStreamer tracers to monitor your GStreamer pipelines.
    • GstPerf: Check your pipeline framerate and CPU consumption.
  • Reference Designs and Demo Applications
    • RR-Media: A set of demo applications and python API containing most of our products for easy testing and prototyping.
  • Other
  • GStreamer Daemon: "gst-launch with steroids". Build your own media server in no time with GStreamer Daemon.
  • GstInterpipe: Dynamically interconnect different pipelines with GstInterpipes.



Installation and setup

RDS is installed in 3 easy steps:

  1. Install dependencies
  2. Extract RDS
  3. Configure RDS

1. Install Dependencies

Make sure you install the following dependencies:

  • Python dependencies:
sudo apt install python3-pip 
pip3 install rich
pip3 install pynput
pip3 install gdown
  • Other Dependencies
sudo apt-get install libgstrtspserver-1.0-0 graphviz libgvc6 octave babeltrace

2. Extract RDS

RDS is delivered as a tarball, put that tarball in any location in your Jetson board and extract it with the following command:

tar -xvf toolkit-jetson-<module>-<JP_VERSION>.tar


3. Configure RDS

Once you extracted the content of RDS, you just need to perform 2 additional steps. From now one we'll call $RDS to the folder containing RidgeRun Development Suite:

a. Download sample videos


Info
This is a ont-time step, do it just the first time you configure RDS


Some of the included demos make use of videos to demonstrate the functionality and they have to be downloaded before running any sample application.

cd $RDS/videos
./download_samples.sh

This will take a while so be patient.

b. Configure your environment

Before using RDS, your environment must be properly configured to ensure all included software is available on your system. This is done by running a convenient script included in the package:

cd $RDS
./configuration.sh

After this, your prompt should change to something like (your RDS name) regular-prompt:.

Congratulations, you have completed the setup process, and you are now ready to use RDS!!


Info

The configuration script will create a new bash with the environment setup for RDS, no files are copied to your system. If you want to exit this environment, just run exit:

exit