Compute Library
 23.08
ConvolutionLayerNode.cpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2018-2019, 2021 Arm Limited.
3  *
4  * SPDX-License-Identifier: MIT
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy
7  * of this software and associated documentation files (the "Software"), to
8  * deal in the Software without restriction, including without limitation the
9  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10  * sell copies of the Software, and to permit persons to whom the Software is
11  * furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in all
14  * copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22  * SOFTWARE.
23  */
25 
26 #include "arm_compute/core/Utils.h"
30 
31 namespace arm_compute
32 {
33 namespace graph
34 {
36  unsigned int num_groups,
37  ConvolutionMethod method,
38  FastMathHint fast_math_hint,
39  QuantizationInfo out_quant_info)
40  : _info(std::move(info)), _num_groups(num_groups), _method(method), _fast_math_hint(fast_math_hint), _out_quant_info(std::move(out_quant_info)), _fused_activation()
41 {
42  _input_edges.resize(3, EmptyEdgeID);
43  _outputs.resize(1, NullTensorID);
44 }
45 
47 {
48  _method = method;
49 }
50 
52 {
53  return _method;
54 }
55 
57 {
58  _fast_math_hint = hint;
59 }
60 
62 {
63  return _fast_math_hint;
64 }
65 
67 {
68  return _info;
69 }
70 
72 {
73  return _num_groups;
74 }
75 
77 {
78  return _fused_activation;
79 }
80 
82 {
83  _fused_activation = fused_activation;
84 }
85 
87 {
88  _info = info;
89 }
90 
92  const TensorDescriptor &weights_descriptor,
93  const PadStrideInfo &info)
94 {
95  unsigned int output_width = 0;
96  unsigned int output_height = 0;
97 
98  const unsigned int input_width = get_dimension_size(input_descriptor, DataLayoutDimension::WIDTH);
99  const unsigned int input_height = get_dimension_size(input_descriptor, DataLayoutDimension::HEIGHT);
100  const unsigned int kernel_width = get_dimension_size(weights_descriptor, DataLayoutDimension::WIDTH);
101  const unsigned int kernel_height = get_dimension_size(weights_descriptor, DataLayoutDimension::HEIGHT);
102 
103  std::tie(output_width, output_height) = scaled_dimensions(input_width, input_height, kernel_width, kernel_height, info);
104 
105  const DataLayout data_layout = input_descriptor.layout;
106  TensorDescriptor output_descriptor = input_descriptor;
107  output_descriptor.shape.set(get_dimension_idx(data_layout, DataLayoutDimension::WIDTH), output_width);
108  output_descriptor.shape.set(get_dimension_idx(data_layout, DataLayoutDimension::HEIGHT), output_height);
109  output_descriptor.shape.set(get_dimension_idx(data_layout, DataLayoutDimension::CHANNEL), weights_descriptor.shape[3]);
110 
111  return output_descriptor;
112 }
113 
115 {
116  if((input_id(0) != NullTensorID) && (input_id(1) != NullTensorID) && (output_id(0) != NullTensorID))
117  {
118  Tensor *dst = output(0);
119  ARM_COMPUTE_ERROR_ON(dst == nullptr);
120  dst->desc() = configure_output(0);
121  return true;
122  }
123  return false;
124 }
125 
127 {
128  ARM_COMPUTE_UNUSED(idx);
129  const Tensor *src = input(0);
130  const Tensor *weights = input(1);
131 
132  ARM_COMPUTE_ERROR_ON(src == nullptr || weights == nullptr);
133 
134  TensorDescriptor output_info = compute_output_descriptor(src->desc(), weights->desc(), _info);
135  if(!_out_quant_info.empty())
136  {
137  output_info.quant_info = _out_quant_info;
138  }
139 
140  return output_info;
141 }
142 
144 {
146 }
147 
149 {
150  v.visit(*this);
151 }
152 } // namespace graph
153 } // namespace arm_compute
arm_compute::graph::EmptyEdgeID
constexpr EdgeID EmptyEdgeID
Definition: Types.h:82
arm_compute::test::validation::src
SimpleTensor< float > src
Definition: DFT.cpp:155
arm_compute::graph::ConvolutionLayerNode::accept
void accept(INodeVisitor &v) override
Accepts a node visitor.
Definition: ConvolutionLayerNode.cpp:148
arm_compute::graph::ConvolutionLayerNode::convolution_method
ConvolutionMethod convolution_method() const
Convolution layer method accessor.
Definition: ConvolutionLayerNode.cpp:51
arm_compute::QuantizationInfo
Quantization information.
Definition: QuantizationInfo.h:68
input_width
const size_t input_width
Definition: impl.cpp:63
arm_compute::DataLayout
DataLayout
[DataLayout enum definition]
Definition: CoreTypes.h:109
arm_compute::DataLayoutDimension::CHANNEL
@ CHANNEL
channel
arm_compute::graph::ConvolutionLayerNode::set_convolution_info
void set_convolution_info(PadStrideInfo info)
Sets convolution info.
Definition: ConvolutionLayerNode.cpp:86
ConvolutionLayerNode.h
arm_compute::graph::ConvolutionLayerNode::fast_math_hint
FastMathHint fast_math_hint() const
Fast math hint accessor.
Definition: ConvolutionLayerNode.cpp:61
INodeVisitor.h
arm_compute::graph::INode::input_id
TensorID input_id(size_t idx) const
Returns the tensor ID of a given input of the node.
Definition: INode.cpp:138
arm_compute::test::validation::dst
auto dst
Definition: DFT.cpp:170
arm_compute::graph::Tensor::desc
TensorDescriptor & desc()
TensorInfo metadata accessor.
Definition: Tensor.cpp:40
arm_compute::graph::INode::output
Tensor * output(size_t idx) const
Returns the tensor of a given output of the node.
Definition: INode.cpp:159
arm_compute::scaled_dimensions
std::pair< unsigned int, unsigned int > scaled_dimensions(int width, int height, int kernel_width, int kernel_height, const PadStrideInfo &pad_stride_info, const Size2D &dilation=Size2D(1U, 1U))
Returns expected width and height of output scaled tensor depending on dimensions rounding mode.
Definition: Utils.cpp:288
arm_compute::graph::ConvolutionLayerNode::type
NodeType type() const override
Returns node's type.
Definition: ConvolutionLayerNode.cpp:143
arm_compute::graph::ConvolutionLayerNode::set_fast_math_hint
void set_fast_math_hint(FastMathHint hint)
Sets the fast math fast hint.
Definition: ConvolutionLayerNode.cpp:56
arm_compute::graph::ConvolutionLayerNode::set_convolution_method
void set_convolution_method(ConvolutionMethod method)
Sets the convolution layer method to use.
Definition: ConvolutionLayerNode.cpp:46
arm_compute::graph::ConvolutionLayerNode::forward_descriptors
bool forward_descriptors() override
Forwards descriptor information to outputs if possible.
Definition: ConvolutionLayerNode.cpp:114
arm_compute::graph::Tensor
Tensor object.
Definition: Tensor.h:41
arm_compute::graph::ConvolutionLayerNode::num_groups
unsigned int num_groups() const
Number of groups in convolution accessor.
Definition: ConvolutionLayerNode.cpp:71
arm_compute::graph::get_dimension_size
size_t get_dimension_size(const TensorDescriptor &descriptor, const DataLayoutDimension data_layout_dimension)
Get size of a tensor's given dimension depending on its layout.
Definition: Utils.cpp:142
arm_compute::DataLayoutDimension::WIDTH
@ WIDTH
width
arm_compute::test::validation::data_layout
const auto data_layout
Definition: ConvolutionLayer.cpp:406
arm_compute::ActivationLayerInfo
Activation Layer Information class.
Definition: ActivationLayerInfo.h:55
ARM_COMPUTE_ERROR_ON
#define ARM_COMPUTE_ERROR_ON(cond)
If the condition is true then an error message is printed and an exception thrown.
Definition: Error.h:467
arm_compute::test::validation::output_info
output_info
Definition: DirectConvolutionLayer.cpp:547
arm_compute::graph::ConvolutionLayerNode::node_type
static constexpr NodeType node_type
Definition: ConvolutionLayerNode.h:117
arm_compute::DataLayoutDimension::HEIGHT
@ HEIGHT
height
arm_compute::graph::TensorDescriptor::layout
DataLayout layout
Data layout.
Definition: TensorDescriptor.h:111
arm_compute::graph::NodeType
NodeType
Supported nodes.
Definition: Types.h:203
arm_compute::graph::INodeVisitor::visit
virtual void visit(INode &n)=0
Visit INode.
arm_compute::graph::ConvolutionLayerNode::ConvolutionLayerNode
ConvolutionLayerNode(PadStrideInfo info, unsigned int num_groups=1, ConvolutionMethod method=ConvolutionMethod::Default, FastMathHint fast_math_hint=FastMathHint::Disabled, QuantizationInfo out_quant_info=QuantizationInfo())
Constructor.
Definition: ConvolutionLayerNode.cpp:35
arm_compute::graph::TensorDescriptor::shape
TensorShape shape
Tensor shape.
Definition: TensorDescriptor.h:109
ARM_COMPUTE_UNUSED
#define ARM_COMPUTE_UNUSED(...)
To avoid unused variables warnings.
Definition: Error.h:152
arm_compute::PadStrideInfo
Definition: CoreTypes.h:138
arm_compute::graph::ConvolutionLayerNode::fused_activation
ActivationLayerInfo fused_activation() const
Returns fused activation.
Definition: ConvolutionLayerNode.cpp:76
arm_compute::graph::INodeVisitor
Node visitor interface.
Definition: INodeVisitor.h:34
Utils.h
arm_compute::graph::FastMathHint
FastMathHint
Enable or disable fast math for Convolution layer.
Definition: Types.h:147
arm_compute::graph::ConvolutionLayerNode::set_fused_activation
void set_fused_activation(ActivationLayerInfo fused_activation)
Sets fused activation.
Definition: ConvolutionLayerNode.cpp:81
arm_compute::test::validation::num_groups
const unsigned int num_groups
Definition: Im2Col.cpp:153
arm_compute::graph::ConvolutionMethod
ConvolutionMethod
Supported Convolution layer methods.
Definition: Types.h:130
arm_compute::graph::get_dimension_idx
size_t get_dimension_idx(DataLayout data_layout, const DataLayoutDimension data_layout_dimension)
Get index of a tensor's given dimension depending on its layout.
Definition: Utils.cpp:148
arm_compute::graph::ConvolutionLayerNode::configure_output
TensorDescriptor configure_output(size_t idx) const override
Calculates output configuration.
Definition: ConvolutionLayerNode.cpp:126
arm_compute
Copyright (c) 2017-2023 Arm Limited.
Definition: introduction.dox:24
arm_compute::QuantizationInfo::empty
bool empty() const
Indicates whether this QuantizationInfo has valid settings or not.
Definition: QuantizationInfo.h:139
arm_compute::graph::TensorDescriptor
Tensor metadata class.
Definition: TensorDescriptor.h:38
arm_compute::graph::ConvolutionLayerNode::convolution_info
PadStrideInfo convolution_info() const
Convolution metadata accessor.
Definition: ConvolutionLayerNode.cpp:66
arm_compute::graph::INode::input
Tensor * input(size_t idx) const
Returns the tensor of a given input of the node.
Definition: INode.cpp:151
arm_compute::graph::INode::output_id
TensorID output_id(size_t idx) const
Returns the tensor ID of a given output of the node.
Definition: INode.cpp:145
Utils.h
arm_compute::graph::NullTensorID
constexpr TensorID NullTensorID
Constant NodeID specifying an equivalent of null node.
Definition: Types.h:78
arm_compute::test::validation::info
ScaleKernelInfo info(interpolation_policy, default_border_mode, PixelValue(), sampling_policy, false)
arm_compute::TensorShape::set
TensorShape & set(size_t dimension, size_t value, bool apply_dim_correction=true, bool increase_dim_unit=true)
Accessor to set the value of one of the dimensions.
Definition: TensorShape.h:79
arm_compute::graph::ConvolutionLayerNode::compute_output_descriptor
static TensorDescriptor compute_output_descriptor(const TensorDescriptor &input_descriptor, const TensorDescriptor &weights_descriptor, const PadStrideInfo &info)
Computes convolution output descriptor.
Definition: ConvolutionLayerNode.cpp:91
Graph.h
input_height
const size_t input_height
Definition: impl.cpp:62