ArmNN
 23.05
ClConvolution2dWorkload.cpp
Go to the documentation of this file.
1 //
2 // Copyright © 2017, 2023 Arm Ltd and Contributors. All rights reserved.
3 // SPDX-License-Identifier: MIT
4 //
5 
7 
8 #include "ClWorkloadUtils.hpp"
9 
10 #include <cl/ClLayerSupport.hpp>
11 #include <cl/ClTensorHandle.hpp>
12 #include <cl/ClLayerSupport.hpp>
16 
17 #include <arm_compute/runtime/CL/functions/CLConvolutionLayer.h>
18 
19 namespace armnn
20 {
21 using namespace armcomputetensorutils;
22 
24  const TensorInfo& output,
25  const Convolution2dDescriptor& descriptor,
26  const TensorInfo& weights,
27  const Optional<TensorInfo>& biases,
28  bool isFastMathEnabled,
29  const ActivationDescriptor* activationDescriptor)
30 {
31  const arm_compute::TensorInfo aclInputInfo = BuildArmComputeTensorInfo(input, descriptor.m_DataLayout);
32  const arm_compute::TensorInfo aclOutputInfo = BuildArmComputeTensorInfo(output, descriptor.m_DataLayout);
33  arm_compute::TensorInfo aclWeightsInfo = BuildArmComputeTensorInfo(weights, descriptor.m_DataLayout);
34  aclWeightsInfo.set_are_values_constant(weights.IsConstant());
35 
36  const arm_compute::Size2D aclDilationInfo = BuildArmComputeSize2D(descriptor.m_DilationX,
37  descriptor.m_DilationY);
38 
39  arm_compute::TensorInfo aclBiasesInfo;
40  arm_compute::TensorInfo *optionalAclBiasesInfo = nullptr;
41 
42  if (descriptor.m_BiasEnabled)
43  {
44  ARMNN_ASSERT(biases.has_value());
45  // Same for bias as weights. We don't currently support non const.
46  if (!biases.value().IsConstant())
47  {
48  return arm_compute::Status{arm_compute::ErrorCode::RUNTIME_ERROR,
49  "ArmNN ClConvolution2dWorkload does not support non constant bias."};
50  }
51  aclBiasesInfo = BuildArmComputeTensorInfo(biases.value(), descriptor.m_DataLayout);
52  aclBiasesInfo.set_are_values_constant(biases.value().IsConstant());
53  optionalAclBiasesInfo = &aclBiasesInfo;
54  }
55 
56  arm_compute::PadStrideInfo layerInfo = BuildArmComputePadStrideInfo(descriptor);
57 
58  const arm_compute::ActivationLayerInfo activationInfo = ConvertActivationDescriptorToAclActivationLayerInfo(
59  activationDescriptor);
60 
61  return arm_compute::CLConvolutionLayer::validate(&aclInputInfo,
62  &aclWeightsInfo,
63  optionalAclBiasesInfo,
64  &aclOutputInfo,
65  layerInfo,
66  arm_compute::WeightsInfo(),
67  aclDilationInfo,
68  activationInfo,
69  isFastMathEnabled);
70 }
71 
73  const WorkloadInfo& info,
74  std::shared_ptr<arm_compute::MemoryManagerOnDemand>& memoryManager,
75  const arm_compute::CLCompileContext& clCompileContext,
76  const bool isFastMathEnabled)
78  , m_ConvolutionLayer(memoryManager)
79 {
80  ARMNN_SCOPED_PROFILING_EVENT(Compute::Undefined, "ClConvolution2dWorkload");
81 
82  const arm_compute::Size2D aclDilationInfo = BuildArmComputeSize2D(m_Data.m_Parameters.m_DilationX,
84 
85  uint32_t numInputs = m_Data.m_Parameters.m_BiasEnabled ? 3: 2;
86  m_Data.ValidateInputsOutputs("ClConvolution2dWorkload", numInputs, 1);
87 
88  arm_compute::ICLTensor& input = static_cast<IClTensorHandle*>(m_Data.m_Inputs[0])->GetTensor();
89  arm_compute::ICLTensor& output = static_cast<IClTensorHandle*>(m_Data.m_Outputs[0])->GetTensor();
90  arm_compute::ICLTensor& weights = static_cast<IClTensorHandle*>(m_Data.m_Inputs[1])->GetTensor();
91  weights.info()->set_are_values_constant(info.m_InputTensorInfos[1].IsConstant());
92 
94  {
95  arm_compute::ICLTensor& bias = static_cast<IClTensorHandle*>(m_Data.m_Inputs[2])->GetTensor();
96  bias.info()->set_are_values_constant(info.m_InputTensorInfos[2].IsConstant());
97  // We do not support dynamic bias
98  ARMNN_ASSERT(info.m_InputTensorInfos[2].IsConstant() == true);
99 
100  m_BiasProxy = std::make_unique<ICLTensorProxy>(&bias);
101  }
102 
103  // Create Proxy tensor and set the initial tensor handle to it
104  m_InputProxy = std::make_unique<ICLTensorProxy>(&input);
105  m_OutputProxy = std::make_unique<ICLTensorProxy>(&output);
106  m_WeightsProxy = std::make_unique<ICLTensorProxy>(&weights);
107 
108  arm_compute::DataLayout aclDataLayout = ConvertDataLayout(m_Data.m_Parameters.m_DataLayout);
109  input.info()->set_data_layout(aclDataLayout);
110  output.info()->set_data_layout(aclDataLayout);
111  weights.info()->set_data_layout(aclDataLayout);
112 
113  arm_compute::PadStrideInfo padStrideInfo = BuildArmComputePadStrideInfo(m_Data.m_Parameters);
114 
115  const arm_compute::ActivationLayerInfo activationInfo = ConvertAdditionalInfoToAclActivationLayerInfo(descriptor);
116 
117  {
118  ARMNN_SCOPED_PROFILING_EVENT(Compute::Undefined, "ClConvolution2dWorkload_configure");
119  m_ConvolutionLayer.configure(clCompileContext,
120  m_InputProxy.get(),
121  m_WeightsProxy.get(),
122  m_BiasProxy.get(),
123  m_OutputProxy.get(),
124  padStrideInfo,
125  arm_compute::WeightsInfo(),
126  aclDilationInfo,
127  activationInfo,
128  isFastMathEnabled);
129  }
130 
131  m_ConvolutionMethod =
132  m_ConvolutionLayer.get_convolution_method(input.info(),
133  weights.info(),
134  output.info(),
135  padStrideInfo,
136  arm_compute::WeightsInfo(),
137  activationInfo,
138  arm_compute::CLScheduler::get().target(),
139  aclDilationInfo,
140  isFastMathEnabled);
141 
142  // Add details for profiling output
143  WorkloadInfo detailsInfo;
144 
145  detailsInfo.m_InputTensorInfos = info.m_InputTensorInfos;
146  detailsInfo.m_OutputTensorInfos = info.m_OutputTensorInfos;
147  detailsInfo.m_WeightsTensorInfo = armnn::Optional<armnn::TensorInfo>(info.m_InputTensorInfos[1]);
149  if (descriptor.m_Parameters.m_BiasEnabled)
150  {
151  detailsInfo.m_BiasTensorInfo = armnn::Optional<armnn::TensorInfo>(info.m_InputTensorInfos[2]);
152  }
153 
154  // Report Profiling Details
155  ARMNN_REPORT_PROFILING_WORKLOAD_DESC("ClConvolution2dWorkload_Construct",
156  descriptor.m_Parameters,
157  detailsInfo,
158  GetGuid());
159 }
160 
162 {
163  ARMNN_SCOPED_PROFILING_EVENT_CL_GUID("ClConvolution2dWorkload_Execute", GetGuid());
164  RunClFunction(m_ConvolutionLayer, CHECK_LOCATION());
165 }
166 
167 arm_compute::ConvolutionMethod ClConvolution2dWorkload::GetConvolutionMethod() const
168 {
169  return m_ConvolutionMethod;
170 }
171 
173 {
174  arm_compute::ICLTensor& input = static_cast<IClTensorHandle*>(m_Data.m_Inputs[0])->GetTensor();
175  arm_compute::ICLTensor& output = static_cast<IClTensorHandle*>(m_Data.m_Outputs[0])->GetTensor();
176 
177  m_InputProxy->set(&input);
178  m_OutputProxy->set(&output);
179 }
180 
181 } //namespace armnn
armnn::WorkloadInfo::m_BiasTensorInfo
Optional< TensorInfo > m_BiasTensorInfo
Definition: WorkloadInfo.hpp:21
armnn::Convolution2dDescriptor::m_DataLayout
DataLayout m_DataLayout
The data layout to be used (NCHW, NHWC).
Definition: Descriptors.hpp:572
armnn::Convolution2dDescriptor::m_BiasEnabled
bool m_BiasEnabled
Enable/disable bias.
Definition: Descriptors.hpp:570
armnn::BaseWorkload< Convolution2dQueueDescriptor >::GetGuid
arm::pipe::ProfilingGuid GetGuid() const final
Definition: Workload.hpp:61
armnn::IClTensorHandle
Definition: IClTensorHandle.hpp:13
armnn::QueueDescriptor::ValidateInputsOutputs
void ValidateInputsOutputs(const std::string &descName, unsigned int numExpectedIn, unsigned int numExpectedOut) const
Definition: WorkloadData.cpp:472
armnn::DataLayout
DataLayout
Definition: Types.hpp:62
armnn::ConvertActivationDescriptorToAclActivationLayerInfo
arm_compute::ActivationLayerInfo ConvertActivationDescriptorToAclActivationLayerInfo(const ActivationDescriptor &actDesc)
Definition: ArmComputeUtils.hpp:85
armnn::Convolution2dDescriptor::m_DilationY
uint32_t m_DilationY
Dilation along y axis.
Definition: Descriptors.hpp:568
CHECK_LOCATION
#define CHECK_LOCATION()
Definition: Exceptions.hpp:203
armnn::ActivationDescriptor
An ActivationDescriptor for the ActivationLayer.
Definition: Descriptors.hpp:36
armnn::WorkloadInfo::m_ConvolutionMethod
Optional< std::string > m_ConvolutionMethod
Definition: WorkloadInfo.hpp:22
armnn::Convolution2dDescriptor::m_DilationX
uint32_t m_DilationX
Dilation along x axis.
Definition: Descriptors.hpp:566
TensorHandle.hpp
armnn::BaseWorkload< Convolution2dQueueDescriptor >::m_Data
Convolution2dQueueDescriptor m_Data
Definition: Workload.hpp:83
armnn::WorkloadInfo::m_WeightsTensorInfo
Optional< TensorInfo > m_WeightsTensorInfo
Definition: WorkloadInfo.hpp:20
armnn
Copyright (c) 2021 ARM Limited and Contributors.
Definition: 01_00_quick_start.dox:6
armnn::OptionalReferenceSwitch< std::is_reference< T >::value, T >::value
const T & value() const
Definition: Optional.hpp:146
ClLayerSupport.hpp
ClConvolution2dWorkload.hpp
armnn::WorkloadInfo::m_OutputTensorInfos
std::vector< TensorInfo > m_OutputTensorInfos
Definition: WorkloadInfo.hpp:19
armnn::TensorInfo::IsConstant
bool IsConstant() const
Definition: Tensor.cpp:509
armnn::ClConvolution2dWorkload::Execute
void Execute() const override
Definition: ClConvolution2dWorkload.cpp:161
armnn::ClConvolution2dWorkload::ClConvolution2dWorkload
ClConvolution2dWorkload(const Convolution2dQueueDescriptor &descriptor, const WorkloadInfo &info, std::shared_ptr< arm_compute::MemoryManagerOnDemand > &memoryManager, const arm_compute::CLCompileContext &clCompileContext, const bool isFastMathEnabled=false)
Definition: ClConvolution2dWorkload.cpp:72
ArmComputeTensorUtils.hpp
ARMNN_SCOPED_PROFILING_EVENT
#define ARMNN_SCOPED_PROFILING_EVENT(backendId, name)
Definition: Profiling.hpp:220
ArmComputeUtils.hpp
armnn::TensorInfo
Definition: Tensor.hpp:152
armnn::Convolution2dDescriptor
A Convolution2dDescriptor for the Convolution2dLayer.
Definition: Descriptors.hpp:522
armnn::ClConvolution2dWorkload::GetConvolutionMethod
arm_compute::ConvolutionMethod GetConvolutionMethod() const
Definition: ClConvolution2dWorkload.cpp:167
armnn::OptionalBase::has_value
bool has_value() const noexcept
Definition: Optional.hpp:53
armnn::RunClFunction
void RunClFunction(arm_compute::IFunction &function, const CheckLocation &location)
Definition: ClWorkloadUtils.hpp:160
armnn::Status
Status
Definition: Types.hpp:42
armnn::ClBaseWorkload
Definition: ClBaseWorkload.hpp:13
armnn::Compute::Undefined
@ Undefined
armnn::ClConvolution2dWorkload::Reconfigure
void Reconfigure() override
Definition: ClConvolution2dWorkload.cpp:172
armnn::ConvertAdditionalInfoToAclActivationLayerInfo
arm_compute::ActivationLayerInfo ConvertAdditionalInfoToAclActivationLayerInfo(const QueueDescriptor &queueDescriptor)
Definition: ArmComputeUtils.hpp:103
armnn::WorkloadInfo
Contains information about TensorInfos of a layer.
Definition: WorkloadInfo.hpp:16
armnn::QueueDescriptorWithParameters::m_Parameters
LayerDescriptor m_Parameters
Definition: WorkloadData.hpp:66
ARMNN_ASSERT
#define ARMNN_ASSERT(COND)
Definition: Assert.hpp:14
ARMNN_REPORT_PROFILING_WORKLOAD_DESC
#define ARMNN_REPORT_PROFILING_WORKLOAD_DESC(name, desc, infos, guid)
Definition: Profiling.hpp:227
armnn::Convolution2dQueueDescriptor
Definition: WorkloadData.hpp:205
armnn::Optional
Definition: Optional.hpp:270
ClWorkloadUtils.hpp
armnn::QueueDescriptor::m_Outputs
std::vector< ITensorHandle * > m_Outputs
Definition: WorkloadData.hpp:27
armnn::ClConvolution2dWorkloadValidate
arm_compute::Status ClConvolution2dWorkloadValidate(const TensorInfo &input, const TensorInfo &output, const Convolution2dDescriptor &descriptor, const TensorInfo &weights, const Optional< TensorInfo > &biases, bool isFastMathEnabled, const ActivationDescriptor *activationDescriptor)
Definition: ClConvolution2dWorkload.cpp:23
armnn::GetConvolutionMethodString
std::string GetConvolutionMethodString(arm_compute::ConvolutionMethod &convolutionMethod)
Definition: ClWorkloadUtils.hpp:38
ARMNN_SCOPED_PROFILING_EVENT_CL_GUID
#define ARMNN_SCOPED_PROFILING_EVENT_CL_GUID(name, guid)
Definition: ClWorkloadUtils.hpp:28
ClTensorHandle.hpp
armnn::WorkloadInfo::m_InputTensorInfos
std::vector< TensorInfo > m_InputTensorInfos
Definition: WorkloadInfo.hpp:18
armnn::QueueDescriptor::m_Inputs
std::vector< ITensorHandle * > m_Inputs
Definition: WorkloadData.hpp:26
armnn::BoostLogSeverityMapping::info
@ info