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