A layer that represents the identity function. More...
#include <NvInfer.h>
Protected Member Functions | |
| virtual | ~IIdentityLayer () noexcept=default |
 Protected Member Functions inherited from nvinfer1::ILayer | |
| virtual | ~ILayer () noexcept=default |
| Protected Member Functions inherited from nvinfer1::INoCopy | |
| INoCopy ()=default | |
| virtual | ~INoCopy ()=default |
| INoCopy (INoCopy const &other)=delete | |
| INoCopy & | operator= (INoCopy const &other)=delete |
| INoCopy (INoCopy &&other)=delete | |
| INoCopy & | operator= (INoCopy &&other)=delete |
Protected Attributes | |
| apiv::VIdentityLayer * | mImpl |
| Protected Attributes inherited from nvinfer1::ILayer | |
| apiv::VLayer * | mLayer |
Additional Inherited Members | |
| Public Member Functions inherited from nvinfer1::ILayer | |
| LayerType | getType () const noexcept |
| Return the type of a layer. More... | |
| void | setName (char const *name) noexcept |
| Set the name of a layer. More... | |
| char const * | getName () const noexcept |
| Return the name of a layer. More... | |
| int32_t | getNbInputs () const noexcept |
| Get the number of inputs of a layer. More... | |
| 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. More... | |
| 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... | |
| TRT_DEPRECATED void | setPrecision (DataType dataType) noexcept |
| Set the preferred or required computational precision of this layer in a weakly-typed network. More... | |
| DataType | getPrecision () const noexcept |
| get the computational precision of this layer More... | |
| TRT_DEPRECATED bool | precisionIsSet () const noexcept |
| whether the computational precision has been set for this layer More... | |
| TRT_DEPRECATED void | resetPrecision () noexcept |
| reset the computational precision for this layer More... | |
| TRT_DEPRECATED void | setOutputType (int32_t index, DataType dataType) noexcept |
| Set the output type of this layer in a weakly-typed network. More... | |
| DataType | getOutputType (int32_t index) const noexcept |
| get the output type of this layer More... | |
| TRT_DEPRECATED bool | outputTypeIsSet (int32_t index) const noexcept |
| whether the output type has been set for this layer More... | |
| TRT_DEPRECATED void | resetOutputType (int32_t index) noexcept |
| reset the output type for this layer More... | |
| void | setMetadata (char const *metadata) noexcept |
| Set the metadata for this layer. More... | |
| char const * | getMetadata () const noexcept |
| Get the metadata of the layer. More... | |
Detailed Description
A layer that represents the identity function.
For a strongly typed network, the layer is an identity function, i.e. the output tensor elements are identical to the input tensor elements, possibly with a change in layout. For example, if a network consists of a single IIdentityLayer, the network input and output must have the same type, but the input can have NCHW layout and the output can have NHWC layout.
If the network is weakly typed, the layer is additionally permitted some type conversions as described below.
If the output type is explicitly specified via setOutputType, IIdentityLayer can be used to convert from one type to another. Other than conversions between the same type (kFLOAT -> kFLOAT for example), the only valid conversions are:
(kFLOAT | kHALF | kINT32 | kBOOL) -> (kFLOAT | kHALF | kINT32 | kBOOL) (kFLOAT | kHALF) -> kUINT8 kUINT8 -> (kFLOAT | kHALF)
Conversion also happens implicitly, without calling setOutputType, if the output tensor is a network output.
Two types are compatible if they are identical, or are both in {kFLOAT, kHALF}. Implicit conversion between incompatible types, i.e. without using setOutputType, was recognized as incorrect as of TensorRT 8.4, but was retained for API compatibility within TensorRT 8.x releases. In TensorRT 10.0 onwards it is an error if the network output tensor type is incompatible with the layer output type. E.g., implicit conversion from kFLOAT to kINT32 is not allowed.
To explicitly convert kFLOAT to kINT32:
- Preferred: use ICastLayer.
- Legacy alternative: use IIdentityLayer and setOutputType(DataType::kINT32).
Similar advice applies for explicit conversion in the other direction.
- Warning
- Do not inherit from this class, as doing so will break forward-compatibility of the API and ABI.
Constructor & Destructor Documentation
◆ ~IIdentityLayer()
|
protectedvirtualdefaultnoexcept |
Member Data Documentation
◆ mImpl
|
protected |
The documentation for this class was generated from the following file:
