#include <Layer.hpp>

Inheritance diagram for Layer:

Public Member Functions
	Layer (unsigned int numInputSlots, unsigned int numOutputSlots, LayerType type, const char *name)

	Layer (unsigned int numInputSlots, unsigned int numOutputSlots, LayerType type, DataLayout layout, const char *name)

void	ExecuteStrategy (IStrategy &strategy) const override
	Apply a visitor to this layer. More...

const std::string &	GetNameStr () const

const OutputHandler &	GetOutputHandler (unsigned int i=0) const

OutputHandler &	GetOutputHandler (unsigned int i=0)

ShapeInferenceMethod	GetShapeInferenceMethod () const

const std::vector< InputSlot > &	GetInputSlots () const

const std::vector< OutputSlot > &	GetOutputSlots () const

std::vector< InputSlot >::iterator	BeginInputSlots ()

std::vector< InputSlot >::iterator	EndInputSlots ()

std::vector< OutputSlot >::iterator	BeginOutputSlots ()

std::vector< OutputSlot >::iterator	EndOutputSlots ()

bool	IsOutputUnconnected ()

void	ResetPriority () const

LayerPriority	GetPriority () const

LayerType	GetType () const override
	Returns the armnn::LayerType of this layer. More...

DataType	GetDataType () const

const BackendId &	GetBackendId () const

void	SetBackendId (const BackendId &id)

virtual std::unique_ptr< IWorkload >	CreateWorkload (const IWorkloadFactory &factory) const =0

virtual void	CreateTensorHandles (const TensorHandleFactoryRegistry &registry, const IWorkloadFactory &factory, const bool IsMemoryManaged=true)

virtual Layer *	Clone (Graph &graph) const =0
	Creates a dynamically-allocated copy of this layer. More...

void	VerifyLayerConnections (unsigned int expectedConnections, const CheckLocation &location) const

virtual void	ValidateTensorShapesFromInputs ()=0

std::vector< TensorShape >	InferOutputShapes (const std::vector< TensorShape > &inputShapes) const override
	Infer the shape of the output(s) based on the provided input shape(s) More...

virtual void	SerializeLayerParameters (ParameterStringifyFunction &fn) const
	Helper to serialize the layer parameters to string. More...

virtual void	ReleaseConstantData ()

template<typename Op >
void	OperateOnConstantTensors (Op op)

const char *	GetName () const override
	Returns the name of the layer. More...

unsigned int	GetNumInputSlots () const override
	Returns the number of connectable input slots. More...

unsigned int	GetNumOutputSlots () const override
	Returns the number of connectable output slots. More...

const InputSlot &	GetInputSlot (unsigned int index) const override
	Get a const input slot handle by slot index. More...

InputSlot &	GetInputSlot (unsigned int index) override
	Get the input slot handle by slot index. More...

const OutputSlot &	GetOutputSlot (unsigned int index=0) const override
	Get the const output slot handle by slot index. More...

OutputSlot &	GetOutputSlot (unsigned int index=0) override
	Get the output slot handle by slot index. More...

void	SetGuid (LayerGuid guid)

LayerGuid	GetGuid () const final
	Returns the unique id of the layer. More...

void	AddRelatedLayerName (const std::string layerName)

const std::list< std::string > &	GetRelatedLayerNames ()

virtual void	Reparent (Graph &dest, std::list< Layer *>::const_iterator iterator)=0

void	BackendSelectionHint (Optional< BackendId > backend) final
	Provide a hint for the optimizer as to which backend to prefer for this layer. More...

Optional< BackendId >	GetBackendHint () const

void	SetShapeInferenceMethod (ShapeInferenceMethod shapeInferenceMethod)

template<typename T >
std::shared_ptr< T >	GetAdditionalInformation () const

void	SetAdditionalInfoForObject (const AdditionalInfoObjectPtr &additionalInfo)

virtual const BaseDescriptor &	GetParameters () const override
	If the layer has a descriptor return it. More...

Public Member Functions inherited from IConnectableLayer
ARMNN_NO_DEPRECATE_WARN_BEGIN	ARMNN_DEPRECATED_MSG_REMOVAL_DATE ("Accept is deprecated. The ILayerVisitor that works in conjunction with this " "Accept function is deprecated. Use IStrategy in combination with " "ExecuteStrategy instead, which is an ABI/API stable version of the " "visitor pattern.", "22.05") virtual void Accept(ILayerVisitor &visitor) const =0
	Apply a visitor to this layer. More...

Protected Member Functions
virtual	~Layer ()=default

template<typename QueueDescriptor >
void	CollectQueueDescriptorInputs (QueueDescriptor &descriptor, WorkloadInfo &info) const

template<typename QueueDescriptor >
void	CollectQueueDescriptorOutputs (QueueDescriptor &descriptor, WorkloadInfo &info) const

void	ValidateAndCopyShape (const TensorShape &outputShape, const TensorShape &inferredShape, const ShapeInferenceMethod shapeInferenceMethod, const std::string &layerName, const unsigned int outputSlotIndex=0)

void	VerifyShapeInferenceType (const TensorShape &outputShape, ShapeInferenceMethod shapeInferenceMethod)

template<typename QueueDescriptor >
WorkloadInfo	PrepInfoAndDesc (QueueDescriptor &descriptor) const
	Helper function to reduce duplication in *LayerCreateWorkload. More...

template<typename LayerType , typename ... Params>
LayerType *	CloneBase (Graph &graph, Params &&... params) const

virtual ConstantTensors	GetConstantTensorsByRef () override

void	SetAdditionalInfo (QueueDescriptor &descriptor) const

Protected Member Functions inherited from IConnectableLayer
	~IConnectableLayer ()
	Objects are not deletable via the handle. More...

Protected Attributes
AdditionalInfoObjectPtr	m_AdditionalInfoObject

std::vector< OutputHandler >	m_OutputHandlers

ShapeInferenceMethod	m_ShapeInferenceMethod

Friends
class	Graph

Additional Inherited Members
Public Types inherited from IConnectableLayer
using	ConstantTensors = std::vector< std::reference_wrapper< std::shared_ptr< ConstTensorHandle > >>

Detailed Description

Definition at line 215 of file Layer.hpp.

Constructor & Destructor Documentation

◆ Layer() [1/2]

Layer	(	unsigned int	numInputSlots,
		unsigned int	numOutputSlots,
		LayerType	type,
		const char *	name
	)

Parameters

name	- Optional name for the layer (may be nullptr).

Definition at line 221 of file Layer.cpp.

References ARMNN_ASSERT, Layer::GetInputSlots(), Layer::m_OutputHandlers, and WorkloadDataCollector::Push().

 : Layer(numInputSlots, numOutputSlots, type, DataLayout::NCHW, name)
 {
 }

◆ Layer() [2/2]

Layer	(	unsigned int	numInputSlots,
		unsigned int	numOutputSlots,
		LayerType	type,
		DataLayout	layout,
		const char *	name
	)

Definition at line 194 of file Layer.cpp.

References armnn::IgnoreUnused(), and Layer::m_OutputHandlers.

 : m_OutputHandlers(numOutputSlots)
 , m_ShapeInferenceMethod(ShapeInferenceMethod::ValidateOnly)
 , m_LayerName(name ? name : "")
 , m_Type(type)
 , m_BackendId()
 , m_BackendHint(EmptyOptional())
 , m_Guid(profiling::ProfilingService::GetNextGuid())
 {
     IgnoreUnused(layout);
     m_InputSlots.reserve(numInputSlots);
     for (unsigned int i = 0; i < numInputSlots; ++i)
     {
         m_InputSlots.emplace_back(*this, i);
     }
 
     m_OutputSlots.reserve(numOutputSlots);
     for (unsigned int i = 0; i < numOutputSlots; ++i)
     {
         m_OutputSlots.emplace_back(*this, m_OutputHandlers[i]);
     }
 }

◆ ~Layer()

virtual ~Layer ( )

protectedvirtualdefault

Member Function Documentation

◆ AddRelatedLayerName()

void AddRelatedLayerName ( const std::string layerName )

inline

Definition at line 329 of file Layer.hpp.

329 { m_RelatedLayerNames.emplace_back(layerName); }

◆ BackendSelectionHint()

void BackendSelectionHint ( Optional< BackendId > backend )

inlinefinalvirtual

Provide a hint for the optimizer as to which backend to prefer for this layer.

Implements IConnectableLayer.

Definition at line 335 of file Layer.hpp.

Referenced by TEST_SUITE().

     {
         m_BackendHint = backend;
     }

◆ BeginInputSlots()

std::vector<InputSlot>::iterator BeginInputSlots ( )

inline

Definition at line 246 of file Layer.hpp.

Referenced by armnn::InsertConvertBf16ToFp32LayersBefore(), armnn::InsertConvertFp16ToFp32LayersBefore(), armnn::InsertConvertFp32ToBf16LayersBefore(), ConvertFp32NetworkToFp16Impl::Run(), MoveTransposeUpImpl::Run(), and MovePermuteUpImpl::Run().

246 { return m_InputSlots.begin(); }

◆ BeginOutputSlots()

std::vector<OutputSlot>::iterator BeginOutputSlots ( )

inline

Definition at line 250 of file Layer.hpp.

Referenced by Graph::Graph(), armnn::InsertDebugLayerAfter(), NeonBackend::OptimizeSubgraphView(), ClBackend::OptimizeSubgraphView(), ConvertFp32NetworkToFp16Impl::Run(), SquashEqualSiblingsImpl< Comparable >::Run(), and SplitterLayer::ValidateTensorShapesFromInputs().

250 { return m_OutputSlots.begin(); }

◆ Clone()

virtual Layer* Clone ( Graph & graph ) const

pure virtual

Creates a dynamically-allocated copy of this layer.

Parameters

graph - The Graph into which this Layer is being cloned.

Implemented in QLstmLayer, QuantizedLstmLayer, OutputLayer, BatchNormalizationLayer, ConcatLayer, LstmLayer, UnidirectionalSequenceLstmLayer, FullyConnectedLayer, SplitterLayer, Convolution2dLayer, DepthwiseConvolution2dLayer, TransposeConvolution2dLayer, DetectionPostProcessLayer, PreCompiledLayer, Convolution3dLayer, ConstantLayer, PermuteLayer, ReshapeLayer, ArgMinMaxLayer, ComparisonLayer, DepthToSpaceLayer, DivisionLayer, ElementwiseUnaryLayer, GatherLayer, LogicalBinaryLayer, LogSoftmaxLayer, MaximumLayer, MeanLayer, MinimumLayer, MultiplicationLayer, PadLayer, PreluLayer, SpaceToBatchNdLayer, SpaceToDepthLayer, StandInLayer, SubtractionLayer, TransposeLayer, AbsLayer, AdditionLayer, BatchToSpaceNdLayer, CastLayer, ConvertBf16ToFp32Layer, ConvertFp16ToFp32Layer, ConvertFp32ToBf16Layer, DebugLayer, DequantizeLayer, FakeQuantizationLayer, FloorLayer, InputLayer, InstanceNormalizationLayer, L2NormalizationLayer, MapLayer, MemCopyLayer, MemImportLayer, MergeLayer, NormalizationLayer, Pooling2dLayer, Pooling3dLayer, ReduceLayer, ResizeLayer, RsqrtLayer, ShapeLayer, SliceLayer, SoftmaxLayer, StackLayer, StridedSliceLayer, SwitchLayer, UnmapLayer, ActivationLayer, ConvertFp32ToFp16Layer, FillLayer, QuantizeLayer, RankLayer, and ChannelShuffleLayer.

Referenced by Graph::Graph().

◆ CloneBase()

LayerType * CloneBase	(	Graph &	graph,
		Params &&...	params
	)		const

protected

Definition at line 14 of file LayerCloneBase.hpp.

References Graph::AddLayer(), Layer::GetBackendHint(), Layer::GetBackendId(), Layer::GetGuid(), and Layer::m_ShapeInferenceMethod.

 {
     LayerType* const layer = graph.AddLayer<LayerType>(std::forward<Params>(params)...);
 
     layer->BackendSelectionHint(GetBackendHint());
     layer->SetBackendId(GetBackendId());
     layer->SetGuid(GetGuid());
     layer->SetShapeInferenceMethod(m_ShapeInferenceMethod);
 
     return layer;
 }

◆ CollectQueueDescriptorInputs()

void CollectQueueDescriptorInputs	(	QueueDescriptor &	descriptor,
		WorkloadInfo &	info
	)		const

inlineprotected

Definition at line 365 of file Layer.hpp.

References QueueDescriptor::m_Inputs, and WorkloadInfo::m_InputTensorInfos.

     {
         WorkloadDataCollector dataCollector(descriptor.m_Inputs, info.m_InputTensorInfos);
         CollectWorkloadInputs(dataCollector);
     }

◆ CollectQueueDescriptorOutputs()

void CollectQueueDescriptorOutputs	(	QueueDescriptor &	descriptor,
		WorkloadInfo &	info
	)		const

inlineprotected

Definition at line 372 of file Layer.hpp.

References QueueDescriptor::m_Outputs, and WorkloadInfo::m_OutputTensorInfos.

     {
         WorkloadDataCollector dataCollector(descriptor.m_Outputs, info.m_OutputTensorInfos);
         CollectWorkloadOutputs(dataCollector);
     }

◆ CreateTensorHandles()

void CreateTensorHandles	(	const TensorHandleFactoryRegistry &	registry,
		const IWorkloadFactory &	factory,
		const bool	IsMemoryManaged = `true`
	)

virtual

Reimplemented in ConcatLayer, OutputLayer, and SplitterLayer.

Definition at line 253 of file Layer.cpp.

References ARMNN_ASSERT, OutputHandler::CreateTensorHandles(), TensorHandleFactoryRegistry::GetFactory(), Layer::GetNumOutputSlots(), Layer::GetOutputHandler(), Layer::GetOutputSlot(), OutputSlot::GetTensorHandleFactoryId(), and ITensorHandleFactory::LegacyFactoryId.

 {
     for (unsigned int idx=0; idx < GetNumOutputSlots(); idx++)
     {
 
         OutputSlot& slot = GetOutputSlot(idx);
         ITensorHandleFactory::FactoryId factoryId = slot.GetTensorHandleFactoryId();
 
         OutputHandler& handler = GetOutputHandler(idx);
         if (factoryId == ITensorHandleFactory::LegacyFactoryId)
         {
             handler.CreateTensorHandles(workloadFactory, IsMemoryManaged);
         }
         else
         {
             ITensorHandleFactory* handleFactory;
             handleFactory = registry.GetFactory(factoryId);
             ARMNN_ASSERT(handleFactory);
             handler.CreateTensorHandles(*handleFactory, IsMemoryManaged);
         }
     }
 }

◆ CreateWorkload()

virtual std::unique_ptr<IWorkload> CreateWorkload ( const IWorkloadFactory & factory ) const

pure virtual

Implemented in QLstmLayer, QuantizedLstmLayer, BatchNormalizationLayer, LstmLayer, UnidirectionalSequenceLstmLayer, FullyConnectedLayer, Convolution2dLayer, PreCompiledLayer, DepthwiseConvolution2dLayer, TransposeConvolution2dLayer, DetectionPostProcessLayer, ChannelShuffleLayer, Convolution3dLayer, ConstantLayer, PermuteLayer, ReshapeLayer, ArgMinMaxLayer, ComparisonLayer, DepthToSpaceLayer, DivisionLayer, ElementwiseUnaryLayer, GatherLayer, LogicalBinaryLayer, LogSoftmaxLayer, MaximumLayer, MeanLayer, MinimumLayer, MultiplicationLayer, PadLayer, PreluLayer, SpaceToBatchNdLayer, SpaceToDepthLayer, StandInLayer, SubtractionLayer, TransposeLayer, AbsLayer, AdditionLayer, BatchToSpaceNdLayer, CastLayer, ConcatLayer, ConvertBf16ToFp32Layer, ConvertFp16ToFp32Layer, ConvertFp32ToBf16Layer, DebugLayer, DequantizeLayer, FakeQuantizationLayer, FloorLayer, InputLayer, InstanceNormalizationLayer, L2NormalizationLayer, MapLayer, MemCopyLayer, MemImportLayer, MergeLayer, NormalizationLayer, OutputLayer, Pooling2dLayer, Pooling3dLayer, QuantizeLayer, ReduceLayer, ResizeLayer, RsqrtLayer, ShapeLayer, SliceLayer, SoftmaxLayer, SplitterLayer, StackLayer, StridedSliceLayer, SwitchLayer, UnmapLayer, ActivationLayer, ConvertFp32ToFp16Layer, FillLayer, and RankLayer.

◆ EndInputSlots()

std::vector<InputSlot>::iterator EndInputSlots ( )

inline

Definition at line 247 of file Layer.hpp.

Referenced by armnn::InsertConvertBf16ToFp32LayersBefore(), armnn::InsertConvertFp16ToFp32LayersBefore(), armnn::InsertConvertFp32ToBf16LayersBefore(), ConvertFp32NetworkToFp16Impl::Run(), MoveTransposeUpImpl::Run(), and MovePermuteUpImpl::Run().

247 { return m_InputSlots.end(); }

◆ EndOutputSlots()

std::vector<OutputSlot>::iterator EndOutputSlots ( )

inline

Definition at line 251 of file Layer.hpp.

Referenced by armnn::InsertDebugLayerAfter(), NeonBackend::OptimizeSubgraphView(), ClBackend::OptimizeSubgraphView(), ConvertFp32NetworkToFp16Impl::Run(), and SplitterLayer::ValidateTensorShapesFromInputs().

251 { return m_OutputSlots.end(); }

◆ ExecuteStrategy()

void ExecuteStrategy ( IStrategy & strategy ) const

overridevirtual

Apply a visitor to this layer.

Implements IConnectableLayer.

Definition at line 481 of file Layer.cpp.

References IStrategy::ExecuteStrategy(), and Layer::GetName().

 {
     strategy.ExecuteStrategy(this, BaseDescriptor(), {}, GetName());
 }

◆ GetAdditionalInformation()

std::shared_ptr<T> GetAdditionalInformation ( ) const

inline

Definition at line 347 of file Layer.hpp.

Referenced by NeonBackend::OptimizeSubgraphView(), and ClBackend::OptimizeSubgraphView().

     {
         return std::static_pointer_cast<T>(m_AdditionalInfoObject);
     }

◆ GetBackendHint()

Optional<BackendId> GetBackendHint ( ) const

inline

Definition at line 339 of file Layer.hpp.

Referenced by NetworkImpl::AddPrecompiledLayer(), and Layer::CloneBase().

339 { return m_BackendHint; }

◆ GetBackendId()

const BackendId& GetBackendId ( ) const

inline

Definition at line 274 of file Layer.hpp.

Referenced by Graph::AddCompatibilityLayers(), armnn::ApplyBackendOptimizations(), armnn::AttemptBackendAssignment(), armnn::CalculateEdgeStrategy(), armnn::CalculateSlotOption(), armnn::CalculateSlotOptionForInput(), Layer::CloneBase(), LoadedNetwork::CreateWorkingMemHandle(), LoadedNetwork::GetOutputTensorInfo(), LoadedNetwork::ImportInputs(), LoadedNetwork::ImportOutputs(), LoadedNetwork::RegisterDebugCallback(), armnn::SelectTensorHandleStrategy(), and TEST_SUITE().

274 { return m_BackendId; }

◆ GetConstantTensorsByRef()

virtual ConstantTensors GetConstantTensorsByRef ( )

inlineoverrideprotectedvirtual

Implements IConnectableLayer.

Reimplemented in QLstmLayer, QuantizedLstmLayer, UnidirectionalSequenceLstmLayer, Convolution2dLayer, LstmLayer, DepthwiseConvolution2dLayer, FullyConnectedLayer, TransposeConvolution2dLayer, ConstantLayer, BatchNormalizationLayer, and DetectionPostProcessLayer.

Definition at line 401 of file Layer.hpp.

401 {return ConstantTensors(); };

armnn::IConnectableLayer::ConstantTensors

std::vector< std::reference_wrapper< std::shared_ptr< ConstTensorHandle > >> ConstantTensors

Definition: INetwork.hpp:124

◆ GetDataType()

DataType GetDataType ( ) const

Definition at line 287 of file Layer.cpp.

References InputSlot::GetConnection(), TensorInfo::GetDataType(), Layer::GetInputSlot(), Layer::GetNumInputSlots(), Layer::GetOutputSlot(), IOutputSlot::GetTensorInfo(), and OutputSlot::GetTensorInfo().

Referenced by ConvertFp32NetworkToFp16Impl::Run(), FuseBatchNorm< ConvLayer, ArmnnType, T >::Run(), ConvertFp32NetworkToBf16Impl::Run(), IsFloat32Layer::Test(), IsFloat16Layer::Test(), IsBFloat16Layer::Test(), and TEST_SUITE().

 {
     if (GetNumInputSlots() > 0) // Ignore the input layer.
     {
         return GetInputSlot(0).GetConnection()->GetTensorInfo().GetDataType();
     }
     return GetOutputSlot(0).GetTensorInfo().GetDataType();
 }

◆ GetGuid()

LayerGuid GetGuid ( ) const

inlinefinalvirtual

Returns the unique id of the layer.

Implements IConnectableLayer.

Definition at line 327 of file Layer.hpp.

Referenced by Layer::CloneBase(), DebugLayer::CreateWorkload(), OutputSlot::GetOwningLayerGuid(), NeonBackend::OptimizeSubgraphView(), ClBackend::OptimizeSubgraphView(), and Graph::SerializeToDot().

327 { return m_Guid; }

◆ GetInputSlot() [1/2]

const InputSlot& GetInputSlot ( unsigned int index ) const

inlineoverridevirtual

Get a const input slot handle by slot index.

Implements IConnectableLayer.

Definition at line 321 of file Layer.hpp.

321 { return m_InputSlots.at(index); }

◆ GetInputSlot() [2/2]

InputSlot& GetInputSlot ( unsigned int index )

inlineoverridevirtual

Get the input slot handle by slot index.

Implements IConnectableLayer.

Definition at line 322 of file Layer.hpp.

322 { return m_InputSlots.at(index); }

◆ GetInputSlots()

const std::vector<InputSlot>& GetInputSlots ( ) const

inline

Definition at line 242 of file Layer.hpp.

Referenced by armnn::AttemptBackendAssignment(), armnn::CalculateSlotOption(), SplitterLayer::CreateWorkload(), LoadedNetwork::EnqueueWorkload(), armnn::ForEachLayerInput(), Layer::GetPriority(), LoadedNetwork::ImportOutputs(), Layer::Layer(), LoadedNetwork::RegisterDebugCallback(), ConvertFp32NetworkToFp16Impl::Run(), and TEST_SUITE().

242 { return m_InputSlots; }

◆ GetName()

const char* GetName ( ) const

inlineoverridevirtual

Returns the name of the layer.

Implements IConnectableLayer.

Definition at line 316 of file Layer.hpp.

316 { return m_LayerName.c_str(); }

◆ GetNameStr()

const std::string& GetNameStr ( ) const

inline

Definition at line 225 of file Layer.hpp.

Referenced by armnn::CheckScaleSetOnQuantizedType(), DebugLayer::CreateWorkload(), LoadedNetwork::GetOutputTensorInfo(), Layer::InferOutputShapes(), armnn::InsertDebugLayerAfter(), IsConnected(), AddBroadcastReshapeLayerImpl::Run(), TEST_SUITE(), and Layer::VerifyLayerConnections().

     {
         return m_LayerName;
     }

◆ GetNumInputSlots()

unsigned int GetNumInputSlots ( ) const

inlineoverridevirtual

Returns the number of connectable input slots.

Implements IConnectableLayer.

Definition at line 318 of file Layer.hpp.

Referenced by CheckNumberOfInputSlot(), ConcatLayer::CreateWorkload(), LoadedNetwork::EnqueueWorkload(), Layer::GetDataType(), Layer::InferOutputShapes(), Graph::InferTensorInfos(), InputSlot::Insert(), armnn::InsertConvertBf16ToFp32LayersBefore(), armnn::InsertConvertFp16ToFp32LayersBefore(), armnn::InsertConvertFp32ToBf16LayersBefore(), StackLayer::ValidateTensorShapesFromInputs(), ConcatLayer::ValidateTensorShapesFromInputs(), and Layer::VerifyLayerConnections().

318 { return static_cast<unsigned int>(m_InputSlots.size()); }

◆ GetNumOutputSlots()

unsigned int GetNumOutputSlots ( ) const

inlineoverridevirtual

Returns the number of connectable output slots.

Implements IConnectableLayer.

Definition at line 319 of file Layer.hpp.

Referenced by OutputSlot::CalculateIndexOnOwner(), CheckNumberOfOutputSlot(), armnn::CheckScaleSetOnQuantizedType(), Layer::CreateTensorHandles(), SplitterLayer::CreateWorkload(), LoadedNetwork::EnqueueWorkload(), Layer::InferOutputShapes(), InputSlot::Insert(), armnn::InsertConvertFp32ToBf16LayersAfter(), armnn::InsertConvertFp32ToFp16LayersAfter(), armnn::InsertDebugLayerAfter(), armnn::SelectTensorHandleStrategy(), TEST_SUITE(), SwitchLayer::ValidateTensorShapesFromInputs(), UnmapLayer::ValidateTensorShapesFromInputs(), MapLayer::ValidateTensorShapesFromInputs(), and DetectionPostProcessLayer::ValidateTensorShapesFromInputs().

319 { return static_cast<unsigned int>(m_OutputSlots.size()); }

◆ GetOutputHandler() [1/2]

const OutputHandler& GetOutputHandler ( unsigned int i = 0 ) const

inline

Definition at line 230 of file Layer.hpp.

Referenced by Layer::CreateTensorHandles(), ConcatLayer::CreateWorkload(), LoadedNetwork::EnqueueWorkload(), InputSlot::Insert(), PermuteAsReshapeImpl::Run(), TransposeAsReshapeImpl::Run(), OptimizeConsecutiveReshapesImpl::Run(), MoveTransposeUpImpl::Run(), MovePermuteUpImpl::Run(), TEST_SUITE(), and InputLayer::ValidateTensorShapesFromInputs().

     {
         return m_OutputHandlers[i];
     }

◆ GetOutputHandler() [2/2]

OutputHandler& GetOutputHandler ( unsigned int i = 0 )

inline

Definition at line 235 of file Layer.hpp.

     {
         return const_cast<OutputHandler&>(const_cast<const Layer*>(this)->GetOutputHandler(i));
     }

◆ GetOutputSlot() [1/2]

const OutputSlot& GetOutputSlot ( unsigned int index = 0 ) const

inlineoverridevirtual

Get the const output slot handle by slot index.

Implements IConnectableLayer.

Examples:: CustomMemoryAllocatorSample.cpp.

Definition at line 323 of file Layer.hpp.

323 { return m_OutputSlots.at(index); }

◆ GetOutputSlot() [2/2]

OutputSlot& GetOutputSlot ( unsigned int index = 0 )

inlineoverridevirtual

Get the output slot handle by slot index.

Implements IConnectableLayer.

Definition at line 324 of file Layer.hpp.

324 { return m_OutputSlots.at(index); }

◆ GetOutputSlots()

const std::vector<OutputSlot>& GetOutputSlots ( ) const

inline

Definition at line 243 of file Layer.hpp.

Referenced by Graph::AddCompatibilityLayers(), armnn::ForEachLayerOutput(), LoadedNetwork::ImportInputs(), Graph::Print(), and LoadedNetwork::RegisterDebugCallback().

243 { return m_OutputSlots; }

◆ GetParameters()

virtual const BaseDescriptor& GetParameters ( ) const

inlineoverridevirtual

If the layer has a descriptor return it.

The base descriptor can then be cast to the correct descriptor class. If the layer has no associated descriptor a struct of type NullDescriptor will be returned. Note: NullDescriptors can be detected because they return true when the BaseDescriptor IsNull function is invoked.

Implements IConnectableLayer.

Definition at line 357 of file Layer.hpp.

357 { return m_NullDescriptor; }

◆ GetPriority()

LayerPriority GetPriority ( ) const

Definition at line 302 of file Layer.cpp.

References Layer::GetInputSlots(), OutputSlot::GetOwningLayer(), Layer::GetPriority(), Layer::GetType(), armnn::Input, and armnn::Output.

Referenced by Layer::GetPriority(), and SquashEqualSiblingsImpl< Comparable >::Run().

 {
     constexpr LayerPriority inputPrio = std::numeric_limits<LayerPriority>::lowest();
     constexpr LayerPriority outputPrio = std::numeric_limits<LayerPriority>::max();
 
     if (GetType() == LayerType::Input)
     {
         m_Priority = inputPrio;
     }
     else if (GetType() == LayerType::Output)
     {
         m_Priority = outputPrio;
     }
     else if (m_Priority == 0)
     {
         if (m_Visiting)
         {
             throw GraphValidationException("Graph has circular dependencies: cannot walk");
         }
 
         auto maxPrio = [](const LayerPriority prio, const InputSlot& slot) -> LayerPriority
             {
                 const OutputSlot *outputSlot = slot.GetConnectedOutputSlot();
                 if (outputSlot)
                 {
                     const Layer& input = outputSlot->GetOwningLayer();
                     return std::max(prio, input.GetPriority());
                 }
                 else
                 {
                     // unconnected input slot
                     return prio;
                 }
             };
 
         m_Visiting = true;
         LayerPriority parentPrio = std::accumulate(GetInputSlots().cbegin(), GetInputSlots().cend(), 0U, maxPrio);
         m_Visiting = false;
 
         if (parentPrio >= outputPrio)
         {
             throw GraphValidationException("Graph has too many edges");
         }
 
         m_Priority = parentPrio + 1U;
     }
 
     return m_Priority;
 }

◆ GetRelatedLayerNames()

const std::list<std::string>& GetRelatedLayerNames ( )

inline

Definition at line 331 of file Layer.hpp.

Referenced by ErasedLayerNamesObservable::Update().

331 { return m_RelatedLayerNames; }

◆ GetShapeInferenceMethod()

ShapeInferenceMethod GetShapeInferenceMethod ( ) const

inline

Definition at line 240 of file Layer.hpp.

240 { return m_ShapeInferenceMethod; };

armnn::Layer::m_ShapeInferenceMethod

ShapeInferenceMethod m_ShapeInferenceMethod

Definition: Layer.hpp:415

◆ GetType()

LayerType GetType ( ) const

inlineoverridevirtual

Returns the armnn::LayerType of this layer.

Implements IConnectableLayer.

Definition at line 270 of file Layer.hpp.

Referenced by armnn::ApplyBackendOptimizations(), armnn::AttemptBackendAssignment(), armnn::CalculateEdgeStrategy(), armnn::CalculateSlotOption(), armnn::CalculateSlotOptionForInput(), armnn::CheckScaleSetOnQuantizedType(), ConcatLayer::CreateWorkload(), SplitterLayer::CreateWorkload(), LoadedNetwork::EnqueueWorkload(), Layer::GetPriority(), LoadedNetwork::ImportInputs(), LoadedNetwork::ImportOutputs(), ElementwiseBaseLayer::InferOutputShapes(), Layer::InferOutputShapes(), Graph::InferTensorInfos(), ReshapeLayer::IsEqual(), TransposeLayer::IsEqual(), PermuteLayer::IsEqual(), TransposeLayer::IsInverse(), PermuteLayer::IsInverse(), IsLayerOfType(), NeonBackend::OptimizeSubgraphView(), ClBackend::OptimizeSubgraphView(), MockBackend::OptimizeSubgraphView(), LoadedNetwork::RegisterDebugCallback(), armnn::ReturnWithError(), ConvertFp32NetworkToFp16Impl::Run(), OptimizeConsecutiveReshapesImpl::Run(), AddDebugImpl::Run(), OptimizeInverseConversionsImpl::Run(), PermuteAndBatchToSpaceAsDepthToSpaceImpl< PermuteType >::Run(), MovePermuteUpImpl::Run(), RedirectMembersToConstantInputsImpl::Run(), MoveTransposeUpImpl::Run(), AddBroadcastReshapeLayerImpl::Run(), FuseBatchNorm< ConvLayer, ArmnnType, T >::Run(), OptimizeForTypeImpl< BaseType, OptimizeForConnectionImpl< BaseType, ChildType, Wrapped > >::Run(), ConvertFp32NetworkToBf16Impl::Run(), armnn::SelectTensorHandleStrategy(), TEST_SUITE(), ElementwiseBaseLayer::ValidateTensorShapesFromInputs(), ElementwiseUnaryLayer::ValidateTensorShapesFromInputs(), and Layer::VerifyLayerConnections().

270 { return m_Type; }

◆ InferOutputShapes()

std::vector< TensorShape > InferOutputShapes ( const std::vector< TensorShape > & inputShapes ) const

overridevirtual

Infer the shape of the output(s) based on the provided input shape(s)

Implements IConnectableLayer.

Reimplemented in QLstmLayer, QuantizedLstmLayer, ConcatLayer, LstmLayer, UnidirectionalSequenceLstmLayer, FullyConnectedLayer, SplitterLayer, Convolution2dLayer, DepthwiseConvolution2dLayer, TransposeConvolution2dLayer, Convolution3dLayer, ConstantLayer, PermuteLayer, ReshapeLayer, PadLayer, StandInLayer, BatchToSpaceNdLayer, Pooling2dLayer, Pooling3dLayer, ResizeLayer, ShapeLayer, SliceLayer, StackLayer, TransposeLayer, MergeLayer, ComparisonLayer, DepthToSpaceLayer, LogicalBinaryLayer, PreluLayer, SpaceToBatchNdLayer, SpaceToDepthLayer, ArgMinMaxLayer, ElementwiseUnaryLayer, GatherLayer, StridedSliceLayer, and ElementwiseBaseLayer.

Definition at line 371 of file Layer.cpp.

References ARMNN_ASSERT, CHECK_LOCATION, armnn::GetLayerTypeAsCString(), Layer::GetNameStr(), Layer::GetNumInputSlots(), Layer::GetNumOutputSlots(), and Layer::GetType().

 {
     ARMNN_ASSERT(GetNumInputSlots() != 0);
     ARMNN_ASSERT(GetNumOutputSlots() != 0);
 
     // By default we return what we got, meaning the output shape(s) are the same as the input(s).
     // This only works if the number of inputs and outputs are the same. Since we are in the Layer
     // base class, this means the implementation needs to be overridden in the specific layers for
     // the other cases. So the missing implementation justifies the UnimplementedException.
 
     if (GetNumInputSlots() != GetNumOutputSlots())
     {
         throw UnimplementedException(
                 fmt::format("Default implementation for InferOutputShapes can only be used for "
                             "layers with the same number of input and output slots. This doesn't "
                             "hold for {0} layer {1} (#inputs={2} #outputs={3}) {4}",
                             GetLayerTypeAsCString(this->GetType()),
                             GetNameStr(),
                             GetNumInputSlots(),
                             GetNumOutputSlots(),
                             CHECK_LOCATION().AsString()));
     }
     return inputShapes;
 }

◆ IsOutputUnconnected()

bool IsOutputUnconnected ( )

inline

Definition at line 254 of file Layer.hpp.

Referenced by OptimizeForConnectionImpl< BaseType, ChildType, Wrapped >::Run(), and OptimizeForExclusiveConnectionImpl< BaseType, ChildType, Wrapped >::Run().

     {
         unsigned int numConnections = 0;
 
         for (auto&& output : GetOutputSlots())
         {
             numConnections += output.GetNumConnections();
         }
 
         return (GetNumOutputSlots() > 0) && (numConnections == 0);
     }

◆ OperateOnConstantTensors()

void OperateOnConstantTensors ( Op op )

inline

Definition at line 303 of file Layer.hpp.

Referenced by Layer::ReleaseConstantData(), and ConvertConstants< Converter, Predicate >::Run().

     {
         for (auto constant : GetConstantTensorsByRef())
         {
             if (constant.get())
             {
                 op(constant);
             }
         }
     };

◆ PrepInfoAndDesc()

WorkloadInfo PrepInfoAndDesc ( QueueDescriptor & descriptor ) const

inlineprotected

Helper function to reduce duplication in *LayerCreateWorkload.

Definition at line 388 of file Layer.hpp.

References armnn::info.

     {
         WorkloadInfo info;
         CollectQueueDescriptorInputs(descriptor, info);
         CollectQueueDescriptorOutputs(descriptor, info);
         return info;
     }

◆ ReleaseConstantData()

void ReleaseConstantData ( )

virtual

Reimplemented in ConstantLayer.

Definition at line 278 of file Layer.cpp.

References Layer::OperateOnConstantTensors().

Referenced by TEST_SUITE().

 {
     // Now free up the static data.
     OperateOnConstantTensors([](std::shared_ptr<ConstTensorHandle>& handle)
                                  {
                                      handle.reset();
                                  });
 }

◆ Reparent()

virtual void Reparent	(	Graph &	dest,
		std::list< Layer *>::const_iterator	iterator
	)

pure virtual

Referenced by Graph::operator=().

◆ ResetPriority()

void ResetPriority ( ) const

Definition at line 296 of file Layer.cpp.

 {
     m_Priority = 0;
     m_Visiting = false;
 }

◆ SerializeLayerParameters()

void SerializeLayerParameters ( ParameterStringifyFunction & fn ) const

virtual

Helper to serialize the layer parameters to string.

(currently used in DotSerializer and company).

Definition at line 450 of file Layer.cpp.

References armnn::GetLayerTypeAsCString(), and StringifyLayerParameters< LayerParameter >::Serialize().

Referenced by LayerWithParameters< Pooling3dDescriptor >::SerializeLayerParameters().

 {
     std::string guid = std::to_string(m_Guid);
     std::string layerType = GetLayerTypeAsCString(m_Type);
     std::string backendId = std::string(m_BackendId);
     if (!(guid.compare("") == 0) && !guid.empty())
     {
         fn("Guid", guid);
     }
     if(!(m_LayerName.compare("") == 0) && !m_LayerName.empty())
     {
         fn("LayerName",m_LayerName);
     }
     if(!(layerType.compare("") == 0) && !layerType.empty())
     {
         fn("LayerType",layerType);
     }
     if(!(backendId.compare("") == 0) && !backendId.empty())
     {
         fn("BackendID",backendId);
     }
     std::shared_ptr<ActivationDescriptor>
             activationDescPtr = GetAdditionalInformation<ActivationDescriptor>();
 
     if (activationDescPtr)
     {
         StringifyLayerParameters<ActivationDescriptor>::Serialize(fn, *activationDescPtr.get());
     }
 }

◆ SetAdditionalInfo()

void SetAdditionalInfo ( QueueDescriptor & descriptor ) const

protected

Definition at line 248 of file Layer.cpp.

References QueueDescriptor::m_AdditionalInfoObject, and Layer::m_AdditionalInfoObject.

 {
     descriptor.m_AdditionalInfoObject = m_AdditionalInfoObject.get();
 }

◆ SetAdditionalInfoForObject()

void SetAdditionalInfoForObject ( const AdditionalInfoObjectPtr & additionalInfo )

inline

Definition at line 352 of file Layer.hpp.

     {
         m_AdditionalInfoObject = additionalInfo;
     }

◆ SetBackendId()

void SetBackendId ( const BackendId & id )

inline

Definition at line 275 of file Layer.hpp.

References CreateWorkload().

Referenced by NetworkImpl::AddPrecompiledLayer(), armnn::AttemptBackendAssignment(), armnn::InsertDebugLayerAfter(), and TEST_SUITE().

275 { m_BackendId = id; }

◆ SetGuid()

void SetGuid ( LayerGuid guid )

inline

Definition at line 326 of file Layer.hpp.

326 { m_Guid = guid; }

◆ SetShapeInferenceMethod()

void SetShapeInferenceMethod ( ShapeInferenceMethod shapeInferenceMethod )

inline

Definition at line 341 of file Layer.hpp.

     {
         m_ShapeInferenceMethod = shapeInferenceMethod;
     }

◆ ValidateAndCopyShape()

void ValidateAndCopyShape	(	const TensorShape &	outputShape,
		const TensorShape &	inferredShape,
		const ShapeInferenceMethod	shapeInferenceMethod,
		const std::string &	layerName,
		const unsigned int	outputSlotIndex = `0`
	)

protected

Definition at line 396 of file Layer.cpp.

References TensorShape::GetDimensionality(), TensorShape::GetDimensionSpecificity(), TensorShape::GetNumDimensions(), Layer::GetOutputSlot(), OutputSlot::GetTensorInfo(), armnn::info, OutputSlot::SetTensorInfo(), armnn::Specified, and armnn::ValidateOnly.

 {
     if (shapeInferenceMethod == ShapeInferenceMethod::ValidateOnly)
     {
         ConditionalThrowIfNotEqual<LayerValidationException>(
                 layerName + ": TensorShape set on OutputSlot[0] does not match the inferred shape.",
                 outputShape,
                 inferredShape);
         return;
     }
 
     if (outputShape.GetDimensionality() == Dimensionality::Specified)
     {
         for (unsigned int i = 0; i < outputShape.GetNumDimensions(); ++i)
         {
             if (outputShape.GetDimensionSpecificity(i) && outputShape[i] != inferredShape[i])
             {
                 std::stringstream ss;
                 ss << layerName << ": TensorShape set on OutputSlot[" << outputSlotIndex <<
                 "] does not match the inferred shape at dimension index [";
                 ss << i << "] " << outputShape << " != " << inferredShape;
                 throw LayerValidationException(ss.str());
             }
         }
     }
 
     TensorInfo info = GetOutputSlot(outputSlotIndex).GetTensorInfo();
 
     armnn::TensorInfo inferredTensorInfo(inferredShape,
                                          info.GetDataType(),
                                          info.GetQuantizationScale(),
                                          info.GetQuantizationOffset());
 
     GetOutputSlot(outputSlotIndex).SetTensorInfo(inferredTensorInfo);
 }

◆ ValidateTensorShapesFromInputs()

virtual void ValidateTensorShapesFromInputs ( )

pure virtual

Implemented in QLstmLayer, QuantizedLstmLayer, OutputLayer, BatchNormalizationLayer, ConcatLayer, LstmLayer, UnidirectionalSequenceLstmLayer, FullyConnectedLayer, SplitterLayer, Convolution2dLayer, ComparisonLayer, DepthToSpaceLayer, DepthwiseConvolution2dLayer, LogicalBinaryLayer, PreluLayer, SpaceToBatchNdLayer, SpaceToDepthLayer, TransposeConvolution2dLayer, ArgMinMaxLayer, DetectionPostProcessLayer, ElementwiseUnaryLayer, GatherLayer, StridedSliceLayer, Convolution3dLayer, PreCompiledLayer, ConstantLayer, PermuteLayer, ReshapeLayer, ChannelShuffleLayer, LogSoftmaxLayer, MeanLayer, PadLayer, StandInLayer, TransposeLayer, AbsLayer, BatchToSpaceNdLayer, CastLayer, ConvertBf16ToFp32Layer, ConvertFp16ToFp32Layer, ConvertFp32ToBf16Layer, DebugLayer, DequantizeLayer, FakeQuantizationLayer, FloorLayer, InputLayer, InstanceNormalizationLayer, L2NormalizationLayer, MapLayer, MemCopyLayer, MemImportLayer, MergeLayer, NormalizationLayer, Pooling2dLayer, Pooling3dLayer, ResizeLayer, RsqrtLayer, ShapeLayer, SliceLayer, SoftmaxLayer, StackLayer, SwitchLayer, UnmapLayer, ConvertFp32ToFp16Layer, FillLayer, ReduceLayer, ActivationLayer, QuantizeLayer, RankLayer, and ElementwiseBaseLayer.

Referenced by OutputSlot::IsTensorInfoSet().

◆ VerifyLayerConnections()

void VerifyLayerConnections	(	unsigned int	expectedConnections,
		const CheckLocation &	location
	)		const

Definition at line 352 of file Layer.cpp.

References ARMNN_ASSERT, CheckLocation::AsString(), Layer::GetInputSlot(), armnn::GetLayerTypeAsCString(), Layer::GetNameStr(), Layer::GetNumInputSlots(), and Layer::GetType().

 {
     ARMNN_ASSERT(GetNumInputSlots() == expectedConnections);
 
     for (unsigned int i=0; i<expectedConnections; ++i)
     {
         if (GetInputSlot(i).GetConnection() == nullptr)
         {
             throw LayerValidationException(
                     fmt::format("Input connection #{0} must be connected "
                                 "for {1} layer {2} {3}",
                                 i,
                                 GetLayerTypeAsCString(this->GetType()),
                                 GetNameStr(),
                                 location.AsString()));
         }
     }
 }

◆ VerifyShapeInferenceType()

void VerifyShapeInferenceType	(	const TensorShape &	outputShape,
		ShapeInferenceMethod	shapeInferenceMethod
	)

protected

Definition at line 436 of file Layer.cpp.

References TensorShape::AreAllDimensionsSpecified(), TensorShape::GetDimensionality(), armnn::NotSpecified, and armnn::ValidateOnly.

 {
     if (shapeInferenceMethod == ShapeInferenceMethod::ValidateOnly)
     {
         ConditionalThrow<LayerValidationException>(
                 outputShape.GetDimensionality() != Dimensionality::NotSpecified,
                 "Dimensionality can not be NotSpecified while using ShapeInferenceMethod::ValidateOnly");
 
         ConditionalThrow<LayerValidationException>(
                 outputShape.AreAllDimensionsSpecified(),
                 "Unspecified dimension while using ShapeInferenceMethod::ValidateOnly");
     }
 }

Friends And Related Function Documentation

◆ Graph

friend class Graph

friend

Definition at line 361 of file Layer.hpp.

Member Data Documentation

◆ m_AdditionalInfoObject

AdditionalInfoObjectPtr m_AdditionalInfoObject

protected

Definition at line 401 of file Layer.hpp.

Referenced by Layer::SetAdditionalInfo().

◆ m_OutputHandlers

std::vector<OutputHandler> m_OutputHandlers

protected

Definition at line 414 of file Layer.hpp.

Referenced by ConcatLayer::CreateWorkload(), SplitterLayer::CreateWorkload(), and Layer::Layer().

◆ m_ShapeInferenceMethod

ShapeInferenceMethod m_ShapeInferenceMethod

protected

Definition at line 415 of file Layer.hpp.

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

src/armnn/Layer.hpp
src/armnn/Layer.cpp
src/armnn/layers/LayerCloneBase.hpp

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Layer() [1/2]

◆ Layer() [2/2]

◆ ~Layer()

Member Function Documentation

◆ AddRelatedLayerName()

◆ BackendSelectionHint()

◆ BeginInputSlots()

◆ BeginOutputSlots()

◆ Clone()

◆ CloneBase()

◆ CollectQueueDescriptorInputs()

◆ CollectQueueDescriptorOutputs()

◆ CreateTensorHandles()

◆ CreateWorkload()

◆ EndInputSlots()

◆ EndOutputSlots()

◆ ExecuteStrategy()

◆ GetAdditionalInformation()

◆ GetBackendHint()

◆ GetBackendId()

◆ GetConstantTensorsByRef()

◆ GetDataType()

◆ GetGuid()

◆ GetInputSlot() [1/2]

◆ GetInputSlot() [2/2]

◆ GetInputSlots()

◆ GetName()

◆ GetNameStr()

◆ GetNumInputSlots()

◆ GetNumOutputSlots()

◆ GetOutputHandler() [1/2]

◆ GetOutputHandler() [2/2]

◆ GetOutputSlot() [1/2]

◆ GetOutputSlot() [2/2]

◆ GetOutputSlots()

◆ GetParameters()

◆ GetPriority()

◆ GetRelatedLayerNames()

◆ GetShapeInferenceMethod()

◆ GetType()

◆ InferOutputShapes()

◆ IsOutputUnconnected()

◆ OperateOnConstantTensors()

◆ PrepInfoAndDesc()

◆ ReleaseConstantData()

◆ Reparent()

◆ ResetPriority()

◆ SerializeLayerParameters()

◆ SetAdditionalInfo()

◆ SetAdditionalInfoForObject()

◆ SetBackendId()

◆ SetGuid()

◆ SetShapeInferenceMethod()

◆ ValidateAndCopyShape()

◆ ValidateTensorShapesFromInputs()

◆ VerifyLayerConnections()

◆ VerifyShapeInferenceType()

Friends And Related Function Documentation

◆ Graph

Member Data Documentation

◆ m_AdditionalInfoObject

◆ m_OutputHandlers

◆ m_ShapeInferenceMethod