TensorRT/CommonFAQ

How to check TensorRT version?
There are two methods to check TensorRT version, $ nm -D /usr/lib/aarch64-linux-gnu/libnvinfer.so | grep "tensorrt" 0000000007849eb0 B tensorrt_build_svc_tensorrt_20181028_25152976 0000000007849eb4 B tensorrt_version_5_0_3_2
 * Symbols from library
 * NOTE: 20181028 is the build date and 25152976 is the top changelist and 5_0_3_2 is the version information.

$ cat /usr/include/aarch64-linux-gnu/NvInfer.h | grep "define NV_TENSORRT"
 * Macros from header file
 * 1) define NV_TENSORRT_MAJOR 5 //!< TensorRT major version.
 * 2) define NV_TENSORRT_MINOR 0 //!< TensorRT minor version.
 * 3) define NV_TENSORRT_PATCH 3 //!< TensorRT patch version.
 * 4) define NV_TENSORRT_BUILD 2 //!< TensorRT build number.
 * 5) define NV_TENSORRT_SONAME_MAJOR 5 //!< Shared object library major version number.
 * 6) define NV_TENSORRT_SONAME_MINOR 0 //!< Shared object library minor version number.
 * 7) define NV_TENSORRT_SONAME_PATCH 3 //!< Shared object library patch version number.

Whether TRT support thread-safe?
TensorRT runtime is thread-safe in the sense that parallel threads using different TRT Execution Contexts can execute in parallel without interference.

How to check GPU utilization?
On Tegra platform, we can use tegrastats to achieve that, $ sudo /home/nvidia/tegrastats On Desktop platform, like Tesla, we can use nvidia-smi to achieve that, $ nvidia-smi --format=csv -lms 500 --query-gpu=index,timestamp,utilization.gpu,clocks.current.graphics,clocks.current.sm,clocks.current.video,clocks.current.memory,utilization.memory,memory.total,memory.free,memory.used,power.limit,power.draw,temperature.gpu,fan.speed,compute_mode,gpu_operation_mode.current,clocks_throttle_reasons.active,pstate,clocks_throttle_reasons.hw_slowdown,clocks_throttle_reasons.gpu_idle,clocks_throttle_reasons.applications_clocks_setting,clocks_throttle_reasons.sw_power_cap,clocks_throttle_reasons.sync_boost -i 0 | tee log.csv

What is kernel auto-tuning?
TensorRT contains various kernel implementations, including those existing in CUDNN and CUBLAS, to accommodate diverse neural network configurations (batch, input/output dims, filters, strides, pads, dilation rate and etc). During network building, TensorRT will profile all suitable kernels and find out the best one with the smallest latency, and then mark it as the final tactic to run the certain layer. We call this process as kernel auto-tuning. Additionally, it’s not always true that INT8 kernel faster than FP16’s than FP32’s, so If current layer chooses different mode as its bottom layer or top layer, TensorRT will insert a reformatting layer between them to do the tensor format conversion, and the time for this reformatting layer will be taken into account as the cost of current layer during auto-tuning.
 * if you run FP16 precision mode, it profiles all candidates in FP16 kernel pool and FP32 kernel pool.
 * if you run INT8 precision mode, it profiles all candidates in INT8 kernel pool and FP32 kernel pool.
 * if both FP16 and INT8 are enabled (we call it hybrid mode), it profiles all candidate in INT8 kernel pool, FP16 kernel pool and FP32 kernel pool.

How TensorRT behave when different batch size is being used?
For relatively deep network, if GPU is fully occupied, we couldn't obtain much performance gain from batching. For relatively simper network, generally, GPU is not fully loaded, then we could obtain performance gain from batching. In other words, inference time per frame can be improved with the bigger batch size only if GPU loading is not full.

What is maxWorkspaceSize?
maxWorkspaceSize indicates a threshold to filter the kernels/tactics of which desired workspace size is less than maxWorkspaceSize. In other words, if the workspace size a tactic requires(such as for convolution, we can use cudnnGetConvolutionForwardWorkspaceSize to get the needed workspace size) is larger than what we specify to maxWorkspaceSize, then this tactic will be ignored during kernel auto-tuning. NOTE: the final device memory TRT consumes has nothing to do with maxWorkspacesize.

What is the difference between enqueue and execute?

 * enqueue will need user to create and synchronize cudaStream. When it's being invoked, it will submit task into GPU and return immediately on CPU basis. While with execute, TensorRT will create and synchronize cudaStream internally, so execute will return until everything is completed on GPU.
 * enqueue and execute are the APIs associated with network/execution Context, other than on layer basis (all layer implementations are in async manner, including IPlugin layer).
 * Both enqueue and execute support layer profiling. The time consumption of each layer will be recorded during network execution and printed out after all done, other than real-time profiling.
 * setDebugSync is only supported along with execute. If this flag is true, the builder or execution context will invoke cudaDeviceSynchronize and report the status to user after each layer execution done.

How to enable VERBOSE log?
You can enable VERBOSE log for your sample through the following API provided by YOUR_TRT_PATH/sample/common/logging.h, gLogger.setReportableSeverity(Severity::kVERBOSE) It’s always recommended to provide VERBOSE log to NVIDIA for further assistance or help.

Can TensorRT model be compatible among different GPU platforms or TensorRT versions?
The answer is definitely NO. The reasons are as below,
 * Different GPU platforms have different SM counts, CUDA Cores or Tensor Core, or Memory efficiency, so same kernel may have different performance on these GPU platforms. That means TensorRT builder may choose different kernel/tactic implementation during network optimization even for the same input configuration.
 * Network fusion and layer kernels are evolving all the time,  so when different TensorRT versions to be used, the optimized network graph or chosen best tactic might be different. It’s possible that some chosen kernel for current TensorRT engine is not existing in the other TensorRT version.

What is maximum model size TensorRT can support?
TensorRT can support 2G(INT_MAX) model at most, which is also the hard limit of Google protobuf.

Why TRT has different definition for axis parameters as compared with the other frameworks, like Caffe or TensorFlow?
For version prior to TensorRT 6.0, it treats batch as immutable and implicit dim over the whole network, so it mostly starts indexing from channel (as axis 0). When you specify axis 1 and hope for the processing from channel, while TensorRT might consider you mean starting from H. In a word, TensorRT layer deals with CHW other than NCHW. TensorRT parser code are open on GitHub, so you could check the parsing function there and understand how it handles your layer parameter exactly and fix the discrepancy accordingly (general solution is to subtract 1 from the axis to strip out batch dimension)

How to build TF1.4 on Xavier?
As we known, TF-TRT is part of the TensorFlow binary, which means when you install tensorflow-gpu, you will be able to use TF-TRT too. For now there is no block issue to use TF-TRT in Python, since we have NVIDIA containers or we can install it using pip following Guide to install TensorFlow for Jetson Platform But for the users who want to use TF in C++, here is the summary for Building TF form source on Xavier.

How to setup danamic shape for multiple inputs?
For dynamic shape with multiple inputs, you need to: 1. setup profile for each input through nvinfer1::IOptimizationProfile::setDimensions and add it to builder config via nvinfer1::IBuilderConfig::addOptimizationProfile, then build engine as usual. 2. before call nvinfer1::IExecutionContext::executeV2(or enqueue), you need to call nvinfer1::IExecutionContext::setBindingDimensions to setup every input for inference.

How to read images and feed them to TensorRT? (Python)
Images have to be resized, reshaped or even transposed before they are fed to TensorRT as contiguous numpy arrays. There are many ways to load image files via python but openCV and PIL may be the most popular ones. Two examples using openCV and PIL respectively are introduced here.
 * OpenCV


 * PIL