#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)

Public Member Functions inherited from IConnectableLayer
virtual void	Accept (ILayerVisitor &visitor) const =0
	Apply a visitor to this layer. More...

Protected Types
using	ConstantTensors = std::vector< std::reference_wrapper< std::unique_ptr< ScopedCpuTensorHandle > >>

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 ()

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

Detailed Description

Definition at line 210 of file Layer.hpp.

Member Typedef Documentation

◆ ConstantTensors

using ConstantTensors = std::vector<std::reference_wrapper<std::unique_ptr<ScopedCpuTensorHandle> >>

protected

Definition at line 393 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 218 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 191 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 324 of file Layer.hpp.

324 { 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 330 of file Layer.hpp.

Referenced by BOOST_AUTO_TEST_CASE().

     {
         m_BackendHint = backend;
     }

◆ BeginInputSlots()

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

inline

Definition at line 241 of file Layer.hpp.

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

241 { return m_InputSlots.begin(); }

◆ BeginOutputSlots()

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

inline

Definition at line 245 of file Layer.hpp.

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

245 { 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, LstmLayer, QuantizedLstmLayer, OutputLayer, BatchNormalizationLayer, SplitterLayer, ConcatLayer, Convolution2dLayer, DepthwiseConvolution2dLayer, FullyConnectedLayer, TransposeConvolution2dLayer, DetectionPostProcessLayer, PreCompiledLayer, 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, ConvertBf16ToFp32Layer, ConvertFp16ToFp32Layer, ConvertFp32ToBf16Layer, DebugLayer, DequantizeLayer, FakeQuantizationLayer, FloorLayer, InputLayer, InstanceNormalizationLayer, L2NormalizationLayer, MapLayer, MemCopyLayer, MemImportLayer, MergeLayer, NormalizationLayer, Pooling2dLayer, ReduceLayer, ResizeLayer, RsqrtLayer, SliceLayer, SoftmaxLayer, StackLayer, StridedSliceLayer, SwitchLayer, UnmapLayer, ActivationLayer, ConvertFp32ToFp16Layer, FillLayer, QuantizeLayer, and RankLayer.

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 358 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 365 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 SplitterLayer, ConcatLayer, and OutputLayer.

Definition at line 250 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 = 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, LstmLayer, QuantizedLstmLayer, BatchNormalizationLayer, Convolution2dLayer, PreCompiledLayer, DepthwiseConvolution2dLayer, FullyConnectedLayer, TransposeConvolution2dLayer, DetectionPostProcessLayer, 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, ConcatLayer, ConvertBf16ToFp32Layer, ConvertFp16ToFp32Layer, ConvertFp32ToBf16Layer, DebugLayer, DequantizeLayer, FakeQuantizationLayer, FloorLayer, InputLayer, InstanceNormalizationLayer, L2NormalizationLayer, MapLayer, MemCopyLayer, MemImportLayer, MergeLayer, NormalizationLayer, OutputLayer, Pooling2dLayer, QuantizeLayer, ReduceLayer, ResizeLayer, RsqrtLayer, SliceLayer, SoftmaxLayer, SplitterLayer, StackLayer, StridedSliceLayer, SwitchLayer, UnmapLayer, ActivationLayer, ConvertFp32ToFp16Layer, FillLayer, and RankLayer.

◆ EndInputSlots()

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

inline

Definition at line 242 of file Layer.hpp.

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

242 { return m_InputSlots.end(); }

◆ EndOutputSlots()

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

inline

Definition at line 246 of file Layer.hpp.

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

246 { return m_OutputSlots.end(); }

◆ ExecuteStrategy()

void ExecuteStrategy ( IStrategy & strategy ) const

overridevirtual

Apply a visitor to this layer.

Implements IConnectableLayer.

Definition at line 477 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 342 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 334 of file Layer.hpp.

Referenced by Layer::CloneBase().

334 { return m_BackendHint; }

◆ GetBackendId()

const BackendId& GetBackendId ( ) const

inline

Definition at line 269 of file Layer.hpp.

Referenced by Graph::AddCompatibilityLayers(), armnn::ApplyBackendOptimizations(), armnn::AttemptBackendAssignment(), BOOST_AUTO_TEST_CASE(), armnn::CalculateEdgeStrategy(), armnn::CalculateSlotOption(), armnn::CalculateSlotOptionForInput(), Layer::CloneBase(), LoadedNetwork::GetOutputTensorInfo(), and armnn::SelectTensorHandleStrategy().

269 { return m_BackendId; }

◆ GetConstantTensorsByRef()

virtual ConstantTensors GetConstantTensorsByRef ( )

inlineprotectedvirtual

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

Definition at line 394 of file Layer.hpp.

394 {return ConstantTensors(); };

armnn::Layer::ConstantTensors

std::vector< std::reference_wrapper< std::unique_ptr< ScopedCpuTensorHandle > >> ConstantTensors

Definition: Layer.hpp:393

◆ GetDataType()

DataType GetDataType ( ) const

Definition at line 283 of file Layer.cpp.

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

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

 {
     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 322 of file Layer.hpp.

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

322 { 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 316 of file Layer.hpp.

316 { 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 317 of file Layer.hpp.

317 { return m_InputSlots.at(index); }

◆ GetInputSlots()

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

inline

Definition at line 237 of file Layer.hpp.

Referenced by BOOST_AUTO_TEST_CASE(), SplitterLayer::CreateWorkload(), LoadedNetwork::EnqueueWorkload(), armnn::ForEachLayerInput(), Layer::GetPriority(), Layer::Layer(), and ConvertFp32NetworkToFp16Impl::Run().

237 { return m_InputSlots; }

◆ GetName()

const char* GetName ( ) const

inlineoverridevirtual

Returns the name of the layer.

Implements IConnectableLayer.

Definition at line 311 of file Layer.hpp.

311 { return m_LayerName.c_str(); }

◆ GetNameStr()

const std::string& GetNameStr ( ) const

inline

Definition at line 220 of file Layer.hpp.

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

     {
         return m_LayerName;
     }

◆ GetNumInputSlots()

unsigned int GetNumInputSlots ( ) const

inlineoverridevirtual

Returns the number of connectable input slots.

Implements IConnectableLayer.

Definition at line 313 of file Layer.hpp.

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

313 { 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 314 of file Layer.hpp.

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

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

◆ GetOutputHandler() [1/2]

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

inline

Definition at line 225 of file Layer.hpp.

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

     {
         return m_OutputHandlers[i];
     }

◆ GetOutputHandler() [2/2]

OutputHandler& GetOutputHandler ( unsigned int i = 0 )

inline

Definition at line 230 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.

Definition at line 318 of file Layer.hpp.

318 { 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 319 of file Layer.hpp.

319 { return m_OutputSlots.at(index); }

◆ GetOutputSlots()

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

inline

Definition at line 238 of file Layer.hpp.

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

238 { return m_OutputSlots; }

◆ GetPriority()

LayerPriority GetPriority ( ) const

Definition at line 298 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 326 of file Layer.hpp.

Referenced by ErasedLayerNamesObservable::Update().

326 { return m_RelatedLayerNames; }

◆ GetShapeInferenceMethod()

ShapeInferenceMethod GetShapeInferenceMethod ( ) const

inline

Definition at line 235 of file Layer.hpp.

235 { return m_ShapeInferenceMethod; };

armnn::Layer::m_ShapeInferenceMethod

ShapeInferenceMethod m_ShapeInferenceMethod

Definition: Layer.hpp:408

◆ GetType()

LayerType GetType ( ) const

inlineoverridevirtual

Returns the armnn::LayerType of this layer.

Implements IConnectableLayer.

Definition at line 265 of file Layer.hpp.

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

265 { 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, LstmLayer, QuantizedLstmLayer, SplitterLayer, ConcatLayer, Convolution2dLayer, DepthwiseConvolution2dLayer, FullyConnectedLayer, TransposeConvolution2dLayer, ConstantLayer, PermuteLayer, ReshapeLayer, PadLayer, StandInLayer, BatchToSpaceNdLayer, Pooling2dLayer, ResizeLayer, SliceLayer, StackLayer, TransposeLayer, MergeLayer, ComparisonLayer, DepthToSpaceLayer, LogicalBinaryLayer, PreluLayer, SpaceToBatchNdLayer, SpaceToDepthLayer, ArgMinMaxLayer, ElementwiseUnaryLayer, StridedSliceLayer, and ElementwiseBaseLayer.

Definition at line 367 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 249 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 298 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 381 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 274 of file Layer.cpp.

References Layer::OperateOnConstantTensors().

Referenced by BOOST_AUTO_TEST_CASE().

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

◆ Reparent()

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

pure virtual

Referenced by Graph::operator=(), and Graph::SubstituteSubgraph().

◆ ResetPriority()

void ResetPriority ( ) const

Definition at line 292 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 446 of file Layer.cpp.

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

Referenced by LayerWithParameters< ResizeDescriptor >::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 245 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 347 of file Layer.hpp.

     {
         m_AdditionalInfoObject = additionalInfo;
     }

◆ SetBackendId()

void SetBackendId ( const BackendId & id )

inline

Definition at line 270 of file Layer.hpp.

References CreateWorkload().

Referenced by armnn::AttemptBackendAssignment(), BOOST_AUTO_TEST_CASE(), BOOST_FIXTURE_TEST_CASE(), armnn::InsertDebugLayerAfter(), and MockBackend::OptimizeSubgraphView().

270 { m_BackendId = id; }

◆ SetGuid()

void SetGuid ( LayerGuid guid )

inline

Definition at line 321 of file Layer.hpp.

321 { m_Guid = guid; }

◆ SetShapeInferenceMethod()

void SetShapeInferenceMethod ( ShapeInferenceMethod shapeInferenceMethod )

inline

Definition at line 336 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 392 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, LstmLayer, QuantizedLstmLayer, OutputLayer, BatchNormalizationLayer, SplitterLayer, ConcatLayer, Convolution2dLayer, ComparisonLayer, DepthToSpaceLayer, DepthwiseConvolution2dLayer, FullyConnectedLayer, LogicalBinaryLayer, PreluLayer, SpaceToBatchNdLayer, SpaceToDepthLayer, TransposeConvolution2dLayer, ArgMinMaxLayer, DetectionPostProcessLayer, ElementwiseUnaryLayer, StridedSliceLayer, PreCompiledLayer, ConstantLayer, PermuteLayer, ReshapeLayer, GatherLayer, LogSoftmaxLayer, MeanLayer, PadLayer, StandInLayer, TransposeLayer, AbsLayer, BatchToSpaceNdLayer, ConvertBf16ToFp32Layer, ConvertFp16ToFp32Layer, ConvertFp32ToBf16Layer, DebugLayer, DequantizeLayer, FakeQuantizationLayer, FloorLayer, InputLayer, InstanceNormalizationLayer, L2NormalizationLayer, MapLayer, MemCopyLayer, MemImportLayer, MergeLayer, NormalizationLayer, Pooling2dLayer, ResizeLayer, RsqrtLayer, 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 348 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 432 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 354 of file Layer.hpp.

Member Data Documentation

◆ m_AdditionalInfoObject

AdditionalInfoObjectPtr m_AdditionalInfoObject

protected

Definition at line 394 of file Layer.hpp.

Referenced by Layer::SetAdditionalInfo().

◆ m_OutputHandlers

std::vector<OutputHandler> m_OutputHandlers

protected

Definition at line 407 of file Layer.hpp.

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

◆ m_ShapeInferenceMethod

ShapeInferenceMethod m_ShapeInferenceMethod

protected

Definition at line 408 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 Types

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ ConstantTensors

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()

◆ 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