Color Detect

Color Detect example resides in L3/examples/colordetect directory.

This benchmark tests the performance of colordetect function. The Color Detection algorithm is basically used for color object tracking and object detection, based on the color of the object.

The tutorial provides a step-by-step guide that covers commands for building and running kernel.

Executable Usage

  • Work Directory(Step 1)

The steps for library download and environment setup can be found in README file of L3 folder. For getting the design,

cd L3/example/colordetect
  • Build kernel(Step 2)

Run the following make command to build your XCLBIN and host binary targeting a specific device. Please be noticed that this process will take a long time, maybe couple of hours.

export OPENCV_INCLUDE=< path-to-opencv-include-folder >
export OPENCV_LIB=< path-to-opencv-lib-folder >
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:< path-to-opencv-lib-folder >
export DEVICE=< path-to-platform-directory >/< platform >.xpfm
make host xclbin TARGET=hw
  • Run kernel(Step 3)

To get the benchmark results, please run the following command.

make run TARGET=hw
  • Example output(Step 4)
-----------Color Detect Design---------------
INFO: Running OpenCL section.
Found Platform
Platform Name: Xilinx
INFO: Device found - xilinx_u200_xdma_201830_2
XCLBIN File Name: krnl_colordetect
INFO: Importing Vitis_Libraries/vision/L3/examples/colordetect/Xilinx_Colordetect_L3_Test_vitis_hw_u200/build_dir.hw.xilinx_u200_xdma_201830_2/krnl_colordetect.xclbin
Loading: 'Vitis_Libraries/vision/L3/examples/colordetect/Xilinx_Colordetect_L3_Test_vitis_hw_u200/build_dir.hw.xilinx_u200_xdma_201830_2/krnl_colordetect.xclbin'
INFO: Verification results:
     Percentage of pixels above error threshold = 0
------------------------------------------------------------

Profiling

The Color Detect design is validated on Alveo U200 board at 300 MHz frequency. The hardware resource utilizations are listed in the following table.

Table 1 Hardware resources for Colour Detection
Dataset LUT BRAM FF DSP
Resolution NPPC other params
4K 1 Filter - 3x3 16523 176 9145 3
FHD 1 Filter - 3x3 9961 91 5432 1

The performance is shown below

Table 2 Performance numbers in terms of FPS (Frames Per Second) for Colour Detection
Dataset FPS(CPU) FPS(FPGA)
4k (3840x2160) 15 289
Full HD(1920x1080) 28 1100