Evaluating the Object Redactor
| AI Based Object Redaction |
|---|
|
| Overview |
| Getting Started |
| GStreamer Plugin |
| Examples |
| Performance |
| Troubleshooting |
| FAQ |
| Contact Us |
Requesting the Evaluation Binary
RidgeRun can provide you with an evaluation binary of the Object Redactor to help you test it, in order to request an evaluation binary for a specific architecture, please contact us providing the following information:
- Platform (i.e.: NVIDIA Jetson Orin, Xavier, or x86)
- Jetpack version or Linux distribution version
- Input resolutions and frame rates
- Expected output resolution and frame rate
Features of the Evaluation
To help you test our Object Redactor, RidgeRun can provide an evaluation version.
The following table summarizes the features available in both the professional and evaluation version.
| Feature | Professional | Evaluation |
|---|---|---|
| GstFaceDetector Element | Y | Y |
| GstObjectRedactor Element | Y | Y |
| Object Redactor Library | Y | Y |
| Unlimited Processing Time | Y | N (1) |
| Source Code | Y | N |
(1) The evaluation version will limit the processing to a maximum of 3000 frames.
Evaluation Dependencies
Install the following dependencies:
CUDA L4T pacakge (NPPI library)
1. You will need to know which distribution version you are using:
lsb_release -a
2. Depending on your platform follow the next instructions:
Jetson platforms
The Jetpack default installation will flash and install all the necessary CUDA packages, including NPPI library. This section describes how to perform a manual installation, which is typically __NOT__ needed
- Depending on what Jetpack release you have installed on your Jetson, you might want to download the corresponding CUDA Toolkit version, including NPPI library. In the following table you can see which one you need. Click on the link and follow the selection menu.
| Jetpack Release | CUDA Toolkit version |
|---|---|
| JetPack 4.x | Get CUDA 10.2 Toolkit |
| JetPack 5.x | Get CUDA 11.4 Toolkit |
x86 platforms
- For x86 platforms, go to this link: CUDA Toolkit 12.1 download archive and follow the selection menu.
3. Select the version depending on the lsb_release command executed above. We recommend using the deb (local) option for the installation.
4. Once you have selected your system setup, NVIDIA will show you the installation instructions for those requirements.
OpenCV
sudo apt install libopencv-dev
ONNX
Follow the instructions to install ONNX in the following ONNX Runtime install section.
Evaluation
Once the requirements above are fulfilled, proceed with the installation of the tarball. RidgeRun should've provided you with the following compressed tar package/s: object-redactor-X.Y.Z-P-J-eval.tar.gz Extract the contents of the file with the following command:
tar -xvzf <path-to-evaluation-tar-file>
The provided cuda-stitcher evaluation version should have the following structure:
object-redactor-X.Y.Z-P-J-eval/
Execute the test environment configuration script:
cd gst-rr-projector-vX.Y.Z-gst-GV-P-T-eval ./configuration.sh
Testing the Object Redactor
You can test the library by running the CPU and GPU examples given.
The CPU examples output 50 redacted frames from a USB webcam. To execute the example run the following commands:
cd <PATH_TO_EVALUATION_BINARY>/lib/examples ./cpu_example
The GPU example performs a redaction in an image with 7 faces.
cd <PATH_TO_EVALUATION_BINARY>/lib/examples ./gpu_example
The result should look like:
How to use the Object Redactor
Please refer to the Library Examples section to explore the steps to run a library example. Refer to the Gstreamer Pipelines section page for references pipelines.