A convolution layer in a network definition. More...

#include <NvInfer.h>

Inheritance diagram for nvinfer1::IConvolutionLayer:

Public Member Functions
TRT_DEPRECATED void	setKernelSize (DimsHW kernelSize) noexcept
	Set the HW kernel size of the convolution. More...

TRT_DEPRECATED DimsHW	getKernelSize () const noexcept
	Get the HW kernel size of the convolution. More...

void	setNbOutputMaps (int32_t nbOutputMaps) noexcept
	Set the number of output maps for the convolution. More...

int32_t	getNbOutputMaps () const noexcept
	Get the number of output maps for the convolution. More...

TRT_DEPRECATED void	setStride (DimsHW stride) noexcept
	Get the stride of the convolution. More...

TRT_DEPRECATED DimsHW	getStride () const noexcept
	Get the stride of the convolution. More...

TRT_DEPRECATED void	setPadding (DimsHW padding) noexcept
	Set the padding of the convolution. More...

TRT_DEPRECATED DimsHW	getPadding () const noexcept
	Get the padding of the convolution. If the padding is asymmetric, the pre-padding is returned. More...

void	setNbGroups (int32_t nbGroups) noexcept
	Set the number of groups for a convolution. More...

int32_t	getNbGroups () const noexcept
	Get the number of groups of the convolution. More...

void	setKernelWeights (Weights weights) noexcept
	Set the kernel weights for the convolution. More...

Weights	getKernelWeights () const noexcept
	Get the kernel weights of the convolution. More...

void	setBiasWeights (Weights weights) noexcept
	Set the bias weights for the convolution. More...

Weights	getBiasWeights () const noexcept
	Get the bias weights for the convolution. More...

TRT_DEPRECATED void	setDilation (DimsHW dilation) noexcept
	Set the dilation for a convolution. More...

TRT_DEPRECATED DimsHW	getDilation () const noexcept
	Get the dilation for a convolution. More...

void	setPrePadding (Dims padding) noexcept
	Set the multi-dimension pre-padding of the convolution. More...

Dims	getPrePadding () const noexcept
	Get the pre-padding. More...

void	setPostPadding (Dims padding) noexcept
	Set the multi-dimension post-padding of the convolution. More...

Dims	getPostPadding () const noexcept
	Get the post-padding. More...

void	setPaddingMode (PaddingMode paddingMode) noexcept
	Set the padding mode. More...

PaddingMode	getPaddingMode () const noexcept
	Get the padding mode. More...

void	setKernelSizeNd (Dims kernelSize) noexcept
	Set the multi-dimension kernel size of the convolution. More...

Dims	getKernelSizeNd () const noexcept
	Get the multi-dimension kernel size of the convolution. More...

void	setStrideNd (Dims stride) noexcept
	Set the multi-dimension stride of the convolution. More...

Dims	getStrideNd () const noexcept
	Get the multi-dimension stride of the convolution. More...

void	setPaddingNd (Dims padding) noexcept
	Set the multi-dimension padding of the convolution. More...

Dims	getPaddingNd () const noexcept
	Get the multi-dimension padding of the convolution. More...

void	setDilationNd (Dims dilation) noexcept
	Set the multi-dimension dilation of the convolution. More...

Dims	getDilationNd () const noexcept
	Get the multi-dimension dilation of the convolution. More...

void	setInput (int32_t index, ITensor &tensor) noexcept
	Append or replace an input of this layer with a specific tensor. More...

Public Member Functions inherited from nvinfer1::ILayer
LayerType	getType () const noexcept
	Return the type of a layer. More...

void	setName (const char *name) noexcept
	Set the name of a layer. More...

const char *	getName () const noexcept
	Return the name of a layer. More...

int32_t	getNbInputs () const noexcept
	Get the number of inputs of a layer.

ITensor *	getInput (int32_t index) const noexcept
	Get the layer input corresponding to the given index. More...

int32_t	getNbOutputs () const noexcept
	Get the number of outputs of a layer.

ITensor *	getOutput (int32_t index) const noexcept
	Get the layer output corresponding to the given index. More...

void	setInput (int32_t index, ITensor &tensor) noexcept
	Replace an input of this layer with a specific tensor. More...

void	setPrecision (DataType dataType) noexcept
	Set the computational precision of this layer. More...

DataType	getPrecision () const noexcept
	get the computational precision of this layer More...

bool	precisionIsSet () const noexcept
	whether the computational precision has been set for this layer More...

void	resetPrecision () noexcept
	reset the computational precision for this layer More...

void	setOutputType (int32_t index, DataType dataType) noexcept
	Set the output type of this layer. More...

DataType	getOutputType (int32_t index) const noexcept
	get the output type of this layer More...

bool	outputTypeIsSet (int32_t index) const noexcept
	whether the output type has been set for this layer More...

void	resetOutputType (int32_t index) noexcept
	reset the output type for this layer More...

Protected Attributes
apiv::VConvolutionLayer *	mImpl

Protected Attributes inherited from nvinfer1::ILayer
apiv::VLayer *	mLayer

Additional Inherited Members
Protected Member Functions inherited from nvinfer1::INoCopy
	INoCopy (const INoCopy &other)=delete

INoCopy &	operator= (const INoCopy &other)=delete

	INoCopy (INoCopy &&other)=delete

INoCopy &	operator= (INoCopy &&other)=delete

Detailed Description

A convolution layer in a network definition.

This layer performs a correlation operation between 3-dimensional filter with a 4-dimensional tensor to produce another 4-dimensional tensor.

An optional bias argument is supported, which adds a per-channel constant to each value in the output.

Warning: Do not inherit from this class, as doing so will break forward-compatibility of the API and ABI.

Member Function Documentation

◆ getBiasWeights()

Weights nvinfer1::IConvolutionLayer::getBiasWeights ( ) const

inlinenoexcept

Get the bias weights for the convolution.

See also: setBiasWeights()

◆ getDilation()

TRT_DEPRECATED DimsHW nvinfer1::IConvolutionLayer::getDilation ( ) const

inlinenoexcept

Get the dilation for a convolution.

See also: setDilation()

Deprecated:: Superseded by getDilationNd and will be removed in TensorRT 9.0.

◆ getDilationNd()

Dims nvinfer1::IConvolutionLayer::getDilationNd ( ) const

inlinenoexcept

Get the multi-dimension dilation of the convolution.

See also: setDilation()

◆ getKernelSize()

TRT_DEPRECATED DimsHW nvinfer1::IConvolutionLayer::getKernelSize ( ) const

inlinenoexcept

Get the HW kernel size of the convolution.

See also: setKernelSize()

Deprecated:: Superseded by getKernelSizeNd and will be removed in TensorRT 9.0.

◆ getKernelSizeNd()

Dims nvinfer1::IConvolutionLayer::getKernelSizeNd ( ) const

inlinenoexcept

Get the multi-dimension kernel size of the convolution.

See also: setKernelSizeNd()

◆ getKernelWeights()

Weights nvinfer1::IConvolutionLayer::getKernelWeights ( ) const

inlinenoexcept

Get the kernel weights of the convolution.

See also: setKernelWeights()

◆ getNbGroups()

int32_t nvinfer1::IConvolutionLayer::getNbGroups ( ) const

inlinenoexcept

Get the number of groups of the convolution.

See also: setNbGroups()

◆ getNbOutputMaps()

int32_t nvinfer1::IConvolutionLayer::getNbOutputMaps ( ) const

inlinenoexcept

Get the number of output maps for the convolution.

See also: setNbOutputMaps()

◆ getPadding()

TRT_DEPRECATED DimsHW nvinfer1::IConvolutionLayer::getPadding ( ) const

inlinenoexcept

Get the padding of the convolution. If the padding is asymmetric, the pre-padding is returned.

See also: setPadding()

Deprecated:: Superseded by getPaddingNd and will be removed in TensorRT 9.0.

◆ getPaddingMode()

PaddingMode nvinfer1::IConvolutionLayer::getPaddingMode ( ) const

inlinenoexcept

Get the padding mode.

Default: kEXPLICIT_ROUND_DOWN

See also: setPaddingMode()

◆ getPaddingNd()

Dims nvinfer1::IConvolutionLayer::getPaddingNd ( ) const

inlinenoexcept

Get the multi-dimension padding of the convolution.

If the padding is asymmetric, the pre-padding is returned.

See also: setPaddingNd()

◆ getPostPadding()

Dims nvinfer1::IConvolutionLayer::getPostPadding ( ) const

inlinenoexcept

Get the post-padding.

See also: setPostPadding()

◆ getPrePadding()

Dims nvinfer1::IConvolutionLayer::getPrePadding ( ) const

inlinenoexcept

Get the pre-padding.

See also: setPrePadding()

◆ getStride()

TRT_DEPRECATED DimsHW nvinfer1::IConvolutionLayer::getStride ( ) const

inlinenoexcept

Get the stride of the convolution.

Deprecated:: Superseded by getStrideNd and will be removed in TensorRT 9.0.

◆ getStrideNd()

Dims nvinfer1::IConvolutionLayer::getStrideNd ( ) const

inlinenoexcept

Get the multi-dimension stride of the convolution.

See also: setStrideNd()

◆ setBiasWeights()

void nvinfer1::IConvolutionLayer::setBiasWeights ( Weights weights )

inlinenoexcept

Set the bias weights for the convolution.

Bias is optional. To omit bias, set the count value of the weights structure to zero.

The bias is applied per-channel, so the number of weights (if non-zero) must be equal to the number of output feature maps.

See also: getBiasWeights()

◆ setDilation()

TRT_DEPRECATED void nvinfer1::IConvolutionLayer::setDilation ( DimsHW dilation )

inlinenoexcept

Set the dilation for a convolution.

Default: (1,1)

If executing this layer on DLA, both height and width must be in the range [1,32].

See also: getDilation()

Deprecated:: Superseded by setDilationNd and will be removed in TensorRT 9.0.

◆ setDilationNd()

void nvinfer1::IConvolutionLayer::setDilationNd ( Dims dilation )

inlinenoexcept

Set the multi-dimension dilation of the convolution.

Default: (1, 1, ..., 1)

If executing this layer on DLA, only support 2D padding, both height and width must be in the range [1,32].

See also: getDilation()

◆ setInput()

void nvinfer1::ILayer::setInput

inlinenoexcept

Append or replace an input of this layer with a specific tensor.

Parameters

index	the index of the input to modify.
tensor	the new input tensor

For a IConvolutionLayer, only index 0 is valid unless explicit precision mode is enabled. With explicit precision mode, values 0-1 are valid where value 1 overrides kernel weights. Kernel weights tensor (computed at build-time) must be an output of dequantize scale layer (i.e. a scale layer with int8 input and float output) in explicit precision network. Conversely, this input tensor can be overridden via appropriate set call.

The indices are as follows:

0: The input activation tensor.
1: The kernel weights tensor (a constant tensor).

If this function is called with a value greater than 0, then the function getNbInputs() changes

◆ setKernelSize()

TRT_DEPRECATED void nvinfer1::IConvolutionLayer::setKernelSize ( DimsHW kernelSize )

inlinenoexcept

Set the HW kernel size of the convolution.

If executing this layer on DLA, both height and width of kernel size must be in the range [1,32].

See also: getKernelSize()

Deprecated:: Superseded by setKernelSizeNd and will be removed in TensorRT 9.0.

◆ setKernelSizeNd()

void nvinfer1::IConvolutionLayer::setKernelSizeNd ( Dims kernelSize )

inlinenoexcept

Set the multi-dimension kernel size of the convolution.

If executing this layer on DLA, only support 2D kernel size, both height and width of kernel size must be in the range [1,32].

See also: getKernelSizeNd()

◆ setKernelWeights()

void nvinfer1::IConvolutionLayer::setKernelWeights ( Weights weights )

inlinenoexcept

Set the kernel weights for the convolution.

The weights are specified as a contiguous array in GKCRS order, where G is the number of groups, K the number of output feature maps, C the number of input channels, and R and S are the height and width of the filter.

See also: getKernelWeights()

◆ setNbGroups()

void nvinfer1::IConvolutionLayer::setNbGroups ( int32_t nbGroups )

inlinenoexcept

Set the number of groups for a convolution.

The input tensor channels are divided into nbGroups groups, and a convolution is executed for each group, using a filter per group. The results of the group convolutions are concatenated to form the output.

Note: When using groups in int8 mode, the size of the groups (i.e. the channel count divided by the group count) must be a multiple of 4 for both input and output.

Default: 1

If executing this layer on DLA, the max number of groups is 8192.

See also: getNbGroups()

◆ setNbOutputMaps()

void nvinfer1::IConvolutionLayer::setNbOutputMaps ( int32_t nbOutputMaps )

inlinenoexcept

Set the number of output maps for the convolution.

If executing this layer on DLA, the number of output maps must be in the range [1,8192].

See also: getNbOutputMaps()

◆ setPadding()

TRT_DEPRECATED void nvinfer1::IConvolutionLayer::setPadding ( DimsHW padding )

inlinenoexcept

Set the padding of the convolution.

The input will be zero-padded by this number of elements in the height and width directions. Padding is symmetric.

Default: (0,0)

If executing this layer on DLA, both height and width of padding must be in the range [0,31], and the padding size must be less than the kernel size.

See also: getPadding()

Deprecated:: Superseded by setPaddingNd and will be removed in TensorRT 9.0.

◆ setPaddingMode()

void nvinfer1::IConvolutionLayer::setPaddingMode ( PaddingMode paddingMode )

inlinenoexcept

Set the padding mode.

Padding mode takes precedence if both setPaddingMode and setPre/PostPadding are used.

Default: kEXPLICIT_ROUND_DOWN

See also: getPaddingMode()

◆ setPaddingNd()

void nvinfer1::IConvolutionLayer::setPaddingNd ( Dims padding )

inlinenoexcept

Set the multi-dimension padding of the convolution.

The input will be zero-padded by this number of elements in each dimension. Padding is symmetric.

Default: (0, 0, ..., 0)

If executing this layer on DLA, only support 2D padding, both height and width of padding must be in the range [0,31], and the padding must be less than the kernel size.

See also: getPaddingNd() setPadding() getPadding()

◆ setPostPadding()

void nvinfer1::IConvolutionLayer::setPostPadding ( Dims padding )

inlinenoexcept

Set the multi-dimension post-padding of the convolution.

The end of the input will be zero-padded by this number of elements in each dimension.

Default: (0, 0, ..., 0)

If executing this layer on DLA, only support 2D padding, both height and width of padding must be in the range [0,31], and the padding must be less than the kernel size.

See also: getPostPadding()

◆ setPrePadding()

void nvinfer1::IConvolutionLayer::setPrePadding ( Dims padding )

inlinenoexcept

Set the multi-dimension pre-padding of the convolution.

The start of the input will be zero-padded by this number of elements in each dimension.

Default: (0, 0, ..., 0)

If executing this layer on DLA, only support 2D padding, both height and width of padding must be in the range [0,31], and the padding must be less than the kernel size.

See also: getPrePadding()

◆ setStride()

TRT_DEPRECATED void nvinfer1::IConvolutionLayer::setStride ( DimsHW stride )

inlinenoexcept

Get the stride of the convolution.

Default: (1,1)

If executing this layer on DLA, both height and width of stride must be in the range [1,8].

See also: getStride()

Deprecated:: Superseded by setStrideNd and will be removed in TensorRT 9.0.

◆ setStrideNd()

void nvinfer1::IConvolutionLayer::setStrideNd ( Dims stride )

inlinenoexcept

Set the multi-dimension stride of the convolution.

Default: (1, 1, ..., 1)

If executing this layer on DLA, only support 2D stride, both height and width of stride must be in the range [1,8].

See also: getStrideNd() setStride() getStride()

The documentation for this class was generated from the following file:

NvInfer.h

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ getBiasWeights()

◆ getDilation()

◆ getDilationNd()

◆ getKernelSize()

◆ getKernelSizeNd()

◆ getKernelWeights()

◆ getNbGroups()

◆ getNbOutputMaps()

◆ getPadding()

◆ getPaddingMode()

◆ getPaddingNd()

◆ getPostPadding()

◆ getPrePadding()

◆ getStride()

◆ getStrideNd()

◆ setBiasWeights()

◆ setDilation()

◆ setDilationNd()

◆ setInput()

◆ setKernelSize()

◆ setKernelSizeNd()

◆ setKernelWeights()

◆ setNbGroups()

◆ setNbOutputMaps()

◆ setPadding()

◆ setPaddingMode()

◆ setPaddingNd()

◆ setPostPadding()

◆ setPrePadding()

◆ setStride()

◆ setStrideNd()