TensorRT  7.2.1.6
NVIDIA TensorRT
Looking for a C++ dev who knows TensorRT?
I'm looking for work. Hire me!
nvinfer1::ISliceLayer Class Referenceabstract

Slices an input tensor into an output tensor based on the offset and strides. More...

Inheritance diagram for nvinfer1::ISliceLayer:
Collaboration diagram for nvinfer1::ISliceLayer:

Public Member Functions

virtual void setStart (Dims start)=0
 Set the start offset that the slice layer uses to create the output slice. More...
 
virtual Dims getStart () const =0
 Get the start offset for the slice layer. More...
 
virtual void setSize (Dims size)=0
 Set the dimensions of the output slice. More...
 
virtual Dims getSize () const =0
 Get dimensions of the output slice. More...
 
virtual void setStride (Dims stride)=0
 Set the stride for computing the output slice data. More...
 
virtual Dims getStride () const =0
 Get the stride for the output slice. More...
 
virtual void setMode (SliceMode mode)=0
 Set the slice mode. More...
 
virtual SliceMode getMode () const =0
 Get the slice mode. More...
 
void setInput (int32_t index, ITensor &tensor)=0
 Append or replace an input of this layer with a specific tensor. More...
 
virtual LayerType getType () const =0
 Return the type of a layer. More...
 
virtual void setName (const char *name)=0
 Set the name of a layer. More...
 
virtual const char * getName () const =0
 Return the name of a layer. More...
 
virtual int32_t getNbInputs () const =0
 Get the number of inputs of a layer. More...
 
virtual ITensorgetInput (int32_t index) const =0
 Get the layer input corresponding to the given index. More...
 
virtual int32_t getNbOutputs () const =0
 Get the number of outputs of a layer. More...
 
virtual ITensorgetOutput (int32_t index) const =0
 Get the layer output corresponding to the given index. More...
 
virtual void setPrecision (DataType dataType)=0
 Set the computational precision of this layer. More...
 
virtual DataType getPrecision () const =0
 get the computational precision of this layer More...
 
virtual bool precisionIsSet () const =0
 whether the computational precision has been set for this layer More...
 
virtual void resetPrecision ()=0
 reset the computational precision for this layer More...
 
virtual void setOutputType (int32_t index, DataType dataType)=0
 Set the output type of this layer. More...
 
virtual DataType getOutputType (int32_t index) const =0
 get the output type of this layer More...
 
virtual bool outputTypeIsSet (int32_t index) const =0
 whether the output type has been set for this layer More...
 
virtual void resetOutputType (int32_t index)=0
 reset the output type for this layer More...
 

Protected Member Functions

virtual ~ISliceLayer ()
 

Detailed Description

Slices an input tensor into an output tensor based on the offset and strides.

The slice layer has two variants, static and dynamic. Static slice specifies the start, size, and stride dimensions at layer creation time via Dims and can use the get/set accessor functions of the ISliceLayer. Dynamic slice specifies one or more of start, size or stride as ITensors, by using ILayer::setTensor to add a second, third, or fourth input respectively. The corresponding Dims are used if an input is missing or null.

An application can determine if the ISliceLayer has a dynamic output shape based on whether the size input (third input) is present and non-null.

The slice layer selects for each dimension a start location from within the input tensor, and copies elements to the output tensor using the specified stride across the input tensor. Start, size, and stride tensors must be 1D Int32 shape tensors if not specified via Dims.

Furthermore, if the slice layer must produce a shape tensor, then start, size, and stride must be build time constants, i.e. as static Dims, or be computable by constant folding.

For example using slice on a tensor: input = {{0, 2, 4}, {1, 3, 5}} start = {1, 0} size = {1, 2} stride = {1, 2} output = {{1, 5}}

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

Constructor & Destructor Documentation

◆ ~ISliceLayer()

virtual nvinfer1::ISliceLayer::~ISliceLayer ( )
inlineprotectedvirtual

Member Function Documentation

◆ setStart()

virtual void nvinfer1::ISliceLayer::setStart ( Dims  start)
pure virtual

Set the start offset that the slice layer uses to create the output slice.

Parameters
startThe start offset to read data from the input tensor.

If the second input is set, it is reset to null.

See also
getStart

◆ getStart()

virtual Dims nvinfer1::ISliceLayer::getStart ( ) const
pure virtual

Get the start offset for the slice layer.

Returns
The start offset, or an invalid Dims structure.

If the second input is present and non-null, this function returns a Dims with nbDims = -1.

See also
setStart

◆ setSize()

virtual void nvinfer1::ISliceLayer::setSize ( Dims  size)
pure virtual

Set the dimensions of the output slice.

Parameters
sizeThe dimensions of the output slice.

If the third input is set, it is reset to null.

See also
getSize

◆ getSize()

virtual Dims nvinfer1::ISliceLayer::getSize ( ) const
pure virtual

Get dimensions of the output slice.

Returns
The output dimension, or an invalid Dims structure.

If the third input is present and non-null, this function returns a Dims with nbDims = -1.

See also
setSize

◆ setStride()

virtual void nvinfer1::ISliceLayer::setStride ( Dims  stride)
pure virtual

Set the stride for computing the output slice data.

Parameters
strideThe dimensions of the stride to compute the values to store in the output slice.

If the fourth input is set, it is reset to null.

See also
getStride

◆ getStride()

virtual Dims nvinfer1::ISliceLayer::getStride ( ) const
pure virtual

Get the stride for the output slice.

Returns
The slicing stride, or an invalid Dims structure.

If the fourth input is present and non-null, this function returns a Dims with nbDims = -1.

See also
setStride

◆ setMode()

virtual void nvinfer1::ISliceLayer::setMode ( SliceMode  mode)
pure virtual

Set the slice mode.

See also
getMode()

◆ getMode()

virtual SliceMode nvinfer1::ISliceLayer::getMode ( ) const
pure virtual

Get the slice mode.

See also
setMode()

◆ setInput()

void nvinfer1::ISliceLayer::setInput ( int32_t  index,
ITensor tensor 
)
pure virtual

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

Parameters
indexthe index of the input to modify.
tensorthe new input tensor

For a slice layer, the values 0-3 are valid. The values 1-3 override start, size or stride dimensions, respectively. Conversely, this input tensor can be overridden via appropriate set call. The indices are as follows:

  • 0: Data or Shape tensor to be sliced.
  • 1: The start tensor to begin slicing, as a 1D Int32 shape tensor.
  • 2: The size tensor of the resulting slice, as a 1D Int32 shape tensor.
  • 3: The stride of the slicing operation, as a 1D Int32 shape tensor.

If this function is called with a value greater than 0, then the function getNbInputs() changes from returning 1 to index + 1.

Implements nvinfer1::ILayer.

◆ getType()

virtual LayerType nvinfer1::ILayer::getType ( ) const
pure virtualinherited

Return the type of a layer.

See also
LayerType

◆ setName()

virtual void nvinfer1::ILayer::setName ( const char *  name)
pure virtualinherited

Set the name of a layer.

This method copies the name string.

See also
getName()
Here is the caller graph for this function:

◆ getName()

virtual const char* nvinfer1::ILayer::getName ( ) const
pure virtualinherited

Return the name of a layer.

See also
setName()
Here is the caller graph for this function:

◆ getNbInputs()

virtual int32_t nvinfer1::ILayer::getNbInputs ( ) const
pure virtualinherited

Get the number of inputs of a layer.

◆ getInput()

virtual ITensor* nvinfer1::ILayer::getInput ( int32_t  index) const
pure virtualinherited

Get the layer input corresponding to the given index.

Parameters
indexThe index of the input tensor.
Returns
The input tensor, or nullptr if the index is out of range or the tensor is optional (ISliceLayer, IRNNLayer and IRNNv2Layer).

◆ getNbOutputs()

virtual int32_t nvinfer1::ILayer::getNbOutputs ( ) const
pure virtualinherited

Get the number of outputs of a layer.

Here is the caller graph for this function:

◆ getOutput()

virtual ITensor* nvinfer1::ILayer::getOutput ( int32_t  index) const
pure virtualinherited

Get the layer output corresponding to the given index.

Returns
The indexed output tensor, or nullptr if the index is out of range or the tensor is optional (IRNNLayer and IRNNv2Layer).
Here is the caller graph for this function:

◆ setPrecision()

virtual void nvinfer1::ILayer::setPrecision ( DataType  dataType)
pure virtualinherited

Set the computational precision of this layer.

Setting the precision allows TensorRT to choose implementation which run at this computational precision. Layer input type would also get inferred from layer computational precision. TensorRT could still choose a non-conforming fastest implementation ignoring set layer precision. Use BuilderFlag::kSTRICT_TYPES to force choose implementations with requested precision. In case no implementation is found with requested precision, TensorRT would choose available fastest implementation. If precision is not set, TensorRT will select the layer computational precision and layer input type based on performance considerations and the flags specified to the builder.

Parameters
precisionthe computational precision.
See also
getPrecision() precisionIsSet() resetPrecision()

◆ getPrecision()

virtual DataType nvinfer1::ILayer::getPrecision ( ) const
pure virtualinherited

get the computational precision of this layer

Returns
the computational precision
See also
setPrecision() precisionIsSet() resetPrecision()

◆ precisionIsSet()

virtual bool nvinfer1::ILayer::precisionIsSet ( ) const
pure virtualinherited

whether the computational precision has been set for this layer

Returns
whether the computational precision has been explicitly set
See also
setPrecision() getPrecision() resetPrecision()

◆ resetPrecision()

virtual void nvinfer1::ILayer::resetPrecision ( )
pure virtualinherited

reset the computational precision for this layer

See also
setPrecision() getPrecision() precisionIsSet()

◆ setOutputType()

virtual void nvinfer1::ILayer::setOutputType ( int32_t  index,
DataType  dataType 
)
pure virtualinherited

Set the output type of this layer.

Setting the output type constrains TensorRT to choose implementations which generate output data with the given type. If it is not set, TensorRT will select output type based on layer computational precision. TensorRT could still choose non-conforming output type based on fastest implementation. Use BuilderFlag::kSTRICT_TYPES to force choose requested output type. In case layer precision is not specified, output type would depend on chosen implementation based on performance considerations and the flags specified to the builder.

This method cannot be used to set the data type of the second output tensor of the TopK layer. The data type of the second output tensor of the topK layer is always Int32. Also the output type of all layers that are shape operations must be DataType::kINT32, and all attempts to set the output type to some other data type will be ignored except for issuing an error message.

Note that the layer output type is generally not identical to the data type of the output tensor, as TensorRT may insert implicit reformatting operations to convert the former to the latter. Calling layer->setOutputType(i, type) has no effect on the data type of the i-th output tensor of layer, and users need to call layer->getOutput(i)->setType(type) to change the tensor data type. This is particularly relevant if the tensor is marked as a network output, since only setType() [but not setOutputType()] will affect the data representation in the corresponding output binding.

Parameters
indexthe index of the output to set
dataTypethe type of the output
See also
getOutputType() outputTypeIsSet() resetOutputType()

◆ getOutputType()

virtual DataType nvinfer1::ILayer::getOutputType ( int32_t  index) const
pure virtualinherited

get the output type of this layer

Parameters
indexthe index of the output
Returns
the output precision. If no precision has been set, DataType::kFLOAT will be returned, unless the output type is inherently DataType::kINT32.
See also
getOutputType() outputTypeIsSet() resetOutputType()

◆ outputTypeIsSet()

virtual bool nvinfer1::ILayer::outputTypeIsSet ( int32_t  index) const
pure virtualinherited

whether the output type has been set for this layer

Parameters
indexthe index of the output
Returns
whether the output type has been explicitly set
See also
setOutputType() getOutputType() resetOutputType()

◆ resetOutputType()

virtual void nvinfer1::ILayer::resetOutputType ( int32_t  index)
pure virtualinherited

reset the output type for this layer

Parameters
indexthe index of the output
See also
setOutputType() getOutputType() outputTypeIsSet()

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