Bilateral Filter¶

Bilateral Filter example resides in L2/examples/bilateralfilter directory.

This benchmark tests the performance of bilateralfilter function. To preserve the edges while smoothing, a bilateral filter can be used. In an analogous way as the Gaussian filter, the bilateral filter also considers the neighboring pixels with weights assigned to each of them.

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 of L2 folder. For getting the design,

cd L2/examples/bilateralfilter

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)

-----------bilateral filter Design---------------
INFO: Running OpenCL section.
Found Platform
Platform Name: Xilinx
INFO: Device found - xilinx_u200_xdma_201830_2
XCLBIN File Name: krnl_bilateralfilter
INFO: Importing Vitis_Libraries/vision/L2/examples/bilateralfilter/Xilinx_Bilateralfilter_L2_Test_vitis_hw_u200/build_dir.hw.xilinx_u200_xdma_201830_2/krnl_bilateralfilter.xclbin
Loading: 'Vitis_Libraries/vision/L2/examples/bilateralfilter/Xilinx_Bilateralfilter_L2_Test_vitis_hw_u200/build_dir.hw.xilinx_u200_xdma_201830_2/krnl_bilateralfilter.xclbin'
     Minimum error in intensity = 0
     Maximum error in intensity = 0
     Percentage of pixels above error threshold = 0
------------------------------------------------------------

Profiling¶

The Bilateral Filter 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 Bilateral Filter¶
Name	Dataset	LUT	BRAM	FF	DSP
bilateralfilter	Full HD(1920x1080)	12513	18	13451	44
bilateralfilter	4k (3840x2160)	22523	35	22862	65

The performance is shown below

Table 2 Performance numbers for Bilateral Filter¶
Dataset	FPS(CPU)	FPS(FPGA)
Full HD(1920x1080)	200	1100
4k (3840x2160)	72	289