blob: 277f2de543b721e59dc435a84ce5ecb4e411942a [file] [log] [blame]
Louis Verhaardebf4af62021-01-27 15:57:57 +01001# Copyright (C) 2020-2021 Arm Limited or its affiliates. All rights reserved.
Tim Hall79d07d22020-04-27 18:20:16 +01002#
3# SPDX-License-Identifier: Apache-2.0
4#
5# Licensed under the Apache License, Version 2.0 (the License); you may
6# not use this file except in compliance with the License.
7# You may obtain a copy of the License at
8#
9# www.apache.org/licenses/LICENSE-2.0
10#
11# Unless required by applicable law or agreed to in writing, software
12# distributed under the License is distributed on an AS IS BASIS, WITHOUT
13# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14# See the License for the specific language governing permissions and
15# limitations under the License.
Tim Hall79d07d22020-04-27 18:20:16 +010016# Description:
17# Internal representation of a Neural Network Operation.
Louis Verhaarde8a5a782020-11-02 18:04:27 +010018import copy
Louis Verhaardaee5d752020-09-30 09:01:52 +020019from collections import namedtuple
20from enum import Enum
Dwight Lidman9b43f842020-12-08 17:56:44 +010021from typing import Any
22from typing import Dict
23from typing import List
Louis Verhaarde8a5a782020-11-02 18:04:27 +010024from typing import Optional
Louis Verhaardebf4af62021-01-27 15:57:57 +010025from typing import Tuple
Dwight Lidman9b43f842020-12-08 17:56:44 +010026from typing import TYPE_CHECKING
Tim Hall79d07d22020-04-27 18:20:16 +010027
Louis Verhaard1a92f782021-02-09 16:08:26 +010028from .api import NpuRoundingMode
Michael McGeagh528a56d2020-12-16 11:33:21 +000029from .errors import VelaError
Tim Hall4ed38bc2020-10-20 18:54:20 +010030from .numeric_util import full_shape
patrik.gustavssoneeb85152020-12-21 17:10:40 +000031from .shape4d import Shape4D
Tim Hall4ed38bc2020-10-20 18:54:20 +010032
Patrik Gustavsson2349d422020-12-01 16:02:29 +010033
Dwight Lidman9b43f842020-12-08 17:56:44 +010034if TYPE_CHECKING:
35 from .tensor import Tensor
36
Tim Hall4ed38bc2020-10-20 18:54:20 +010037PointXY = namedtuple("PointXY", "x y")
38PointXYZ = namedtuple("PointXYZ", "x y z")
39
Tim Hall79d07d22020-04-27 18:20:16 +010040
Louis Verhaardaee5d752020-09-30 09:01:52 +020041class NpuBlockType(Enum):
Tim Hall79d07d22020-04-27 18:20:16 +010042 Default = 0
43 ConvolutionMxN = 1
44 VectorProduct = 2
45 Pooling = 3
46 ConvolutionDepthWise = 4
47 ElementWise = 5
Fredrik Svedberga0c36242020-06-03 15:43:31 +020048 ReduceSum = 6
Tim Hall79d07d22020-04-27 18:20:16 +010049
50
Tim Hall4ed38bc2020-10-20 18:54:20 +010051class Kernel:
Louis Verhaarde8a5a782020-11-02 18:04:27 +010052 """
53 Kernel information for NPU operations
54 """
55
Tim Halld8339a72021-05-27 18:49:40 +010056 def __init__(
57 self,
58 w: int,
59 h: int,
60 stride_x: int = 1,
61 stride_y: int = 1,
62 dilation_x: int = 1,
63 dilation_y: int = 1,
64 valid_padding=False,
65 ):
Louis Verhaarde8a5a782020-11-02 18:04:27 +010066 assert stride_x > 0 and stride_y > 0
67 assert dilation_x > 0 and dilation_y > 0
Tim Hall4ed38bc2020-10-20 18:54:20 +010068 self.width = w
69 self.height = h
Louis Verhaarde8a5a782020-11-02 18:04:27 +010070 self.stride = PointXY(stride_x, stride_y)
71 self.dilation = PointXY(dilation_x, dilation_y)
Tim Halld8339a72021-05-27 18:49:40 +010072 self.valid_padding = valid_padding
Tim Hall4ed38bc2020-10-20 18:54:20 +010073
Louis Verhaarde8a5a782020-11-02 18:04:27 +010074 def elements_wh(self) -> int:
Tim Hall4ed38bc2020-10-20 18:54:20 +010075 return self.width * self.height
76
Louis Verhaarde8a5a782020-11-02 18:04:27 +010077 def area_width(self) -> int:
Tim Hall4ed38bc2020-10-20 18:54:20 +010078 return (self.width - 1) * self.dilation.x + 1
79
Louis Verhaarde8a5a782020-11-02 18:04:27 +010080 def area_height(self) -> int:
Tim Hall4ed38bc2020-10-20 18:54:20 +010081 return (self.height - 1) * self.dilation.y + 1
82
Tim Halld8339a72021-05-27 18:49:40 +010083 def dilation(self) -> PointXY:
84 return self.dilation
85
Louis Verhaardebf4af62021-01-27 15:57:57 +010086 def dilated_wh(self) -> Tuple[int, int]:
87 """Returns the dilated kernel width/height"""
88 return self.dilation.x * (self.width - 1) + 1, self.dilation.y * (self.height - 1) + 1
89
Louis Verhaarde8a5a782020-11-02 18:04:27 +010090 def __str__(self):
91 return f"w={self.width}, h={self.height}, stride={tuple(self.stride)}, dilation={tuple(self.dilation)}"
92
Tim Hall4ed38bc2020-10-20 18:54:20 +010093
Louis Verhaardaee5d752020-09-30 09:01:52 +020094# Classifies operators of type Custom
95class CustomType(Enum):
96 ThirdPartyOp = 0 # Third party custom op
97 NpuOp = 1 # NPU op
98 ExistingNpuOp = 2 # NPU op that was part of the input network
99
100
101TensorIndices = namedtuple("TensorIndices", ["ifms", "weights", "biases"])
102
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200103NNG_NO_INDICES = TensorIndices([], [], [])
104NNG_IFM_INDICES = TensorIndices([0], [], [])
105NNG_IFM_WEIGHTS_INDICES = TensorIndices([0], [1], [])
106NNG_IFM_WEIGHTS_BIAS_INDICES = TensorIndices([0], [1], [2])
107NNG_IFM_IFM2_INDICES = TensorIndices([0, 1], [], [])
108NNG_CONV2D_BACKPROP_INDICES = TensorIndices([2], [1], [3])
109NNG_TRANSPOSE_CONV_INDICES = TensorIndices([0], [1], [3])
110NNG_CONCAT_INDICES = TensorIndices([1, 2], [], [])
111NNG_SPLIT_IFM_INDICES = TensorIndices([1], [], [])
112NNG_BLOCK_LSTM_INDICES = TensorIndices([3], [4], [])
Louis Verhaardaee5d752020-09-30 09:01:52 +0200113
114
115# Static information related to operation codes
116class OperatorInfo:
117 __slots__ = ("id", "block_type", "indices", "is_unary")
118 _id = 0
119
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200120 def __init__(self, block_type=NpuBlockType.Default, indices=NNG_NO_INDICES, is_unary=False):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200121 OperatorInfo._id += 1
122 self.id = OperatorInfo._id
123 self.block_type = block_type
124 self.indices = indices # Indices of the different tensor purposes
125 self.is_unary = is_unary # Classifies elementwise operators
126
127
128# Internally used operation codes
129class Op(Enum):
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200130 Abs = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_INDICES, is_unary=True)
131 Add = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200132 AddN = OperatorInfo()
133 Any = OperatorInfo()
134 ArgMax = OperatorInfo()
135 ArgMin = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200136 AvgPool = OperatorInfo(block_type=NpuBlockType.Pooling, indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200137 BatchMatMul = OperatorInfo()
138 BatchToSpaceND = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200139 BidirectionalSequenceLstm = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
140 BidirectionalSequenceRnn = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
141 BlockLSTM = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_BLOCK_LSTM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200142
143 CLZ = OperatorInfo(
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200144 block_type=NpuBlockType.ElementWise, indices=NNG_IFM_INDICES, is_unary=True
Louis Verhaardaee5d752020-09-30 09:01:52 +0200145 ) # NPU specific operation
146 Call = OperatorInfo()
147 Cast = OperatorInfo()
148 Ceil = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200149 Clamp = OperatorInfo(indices=NNG_IFM_INDICES) # TOSA specific
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100150 Clip = OperatorInfo() # NPU specific fused activation function for clipping between activation.min/max
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200151 Concat = OperatorInfo(indices=NNG_CONCAT_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200152 ConcatEmbeddings = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200153 ConcatSliceWrite = OperatorInfo(indices=NNG_IFM_INDICES)
154 ConcatTFLite = OperatorInfo(indices=NNG_CONCAT_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200155 Const = OperatorInfo() # Constant tensor, only used in CPU subgraphs
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200156 Conv2D = OperatorInfo(block_type=NpuBlockType.ConvolutionMxN, indices=NNG_IFM_WEIGHTS_INDICES)
157 Conv2DBackpropInput = OperatorInfo(block_type=NpuBlockType.ConvolutionMxN, indices=NNG_CONV2D_BACKPROP_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200158 Conv2DBackpropInputSwitchedBias = OperatorInfo(
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200159 block_type=NpuBlockType.ConvolutionMxN, indices=NNG_TRANSPOSE_CONV_INDICES
Louis Verhaardaee5d752020-09-30 09:01:52 +0200160 )
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200161 Conv2DBias = OperatorInfo(block_type=NpuBlockType.ConvolutionMxN, indices=NNG_IFM_WEIGHTS_BIAS_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200162 Cos = OperatorInfo()
Tim Hall42abec12021-02-04 21:31:57 +0000163 Cumsum = OperatorInfo()
Louis Verhaardaee5d752020-09-30 09:01:52 +0200164 Custom = OperatorInfo() # Custom 3rd party operator, only used in CPU subgraphs
165 CustomNpuOp = OperatorInfo() # NPU custom operator, only used in CPU subgraphs
Louis Verhaardaee5d752020-09-30 09:01:52 +0200166 Delegate = OperatorInfo()
167 Densify = OperatorInfo()
168 DepthToSpace = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200169 DepthwiseConv2DBias = OperatorInfo(
170 block_type=NpuBlockType.ConvolutionDepthWise, indices=NNG_IFM_WEIGHTS_BIAS_INDICES
171 )
172 Dequantize = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200173 Div = OperatorInfo()
174 Elu = OperatorInfo()
175 EmbeddingLookup = OperatorInfo()
176 EmbeddingLookupSparse = OperatorInfo()
177 Equal = OperatorInfo()
178 Exp = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200179 ExpandDims = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200180 FakeQuantWithMinMaxArgs = OperatorInfo()
181 Fill = OperatorInfo()
182 Floor = OperatorInfo()
183 FloorDiv = OperatorInfo()
184 FloorMod = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200185 FullyConnected = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_BIAS_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200186 GatherNd = OperatorInfo()
187 GatherV2 = OperatorInfo()
188 Greater = OperatorInfo()
189 GreaterEqual = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200190 HardSwish = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200191 HashtableLookup = OperatorInfo()
Patrik Gustavssonef3ebdd2021-10-01 11:10:25 +0200192 Identity = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200193 If = OperatorInfo()
194 L2Norm = OperatorInfo()
195 L2Pool2D = OperatorInfo()
196 LRN = OperatorInfo()
197 LSHProjection = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200198 LeakyRelu = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_INDICES, is_unary=True)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200199 Less = OperatorInfo()
200 LessEqual = OperatorInfo()
201 Log = OperatorInfo()
202 LogSoftmax = OperatorInfo()
203 LogicalAnd = OperatorInfo()
204 LogicalNot = OperatorInfo()
205 LogicalOr = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200206 Lstm = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200207 LUT = OperatorInfo() # NPU specific, operator has LUT, only used in fused activation functions
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200208 MatMul = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200209 MatrixDiag = OperatorInfo()
210 MatrixSetDiag = OperatorInfo()
211 Max = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200212 MaxPool = OperatorInfo(block_type=NpuBlockType.Pooling, indices=NNG_IFM_INDICES)
213 Maximum = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
214 Mean = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200215 Min = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200216 Minimum = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200217 MirrorPad = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200218 Mul = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200219 Neg = OperatorInfo()
220 NonMaxSuppressionV4 = OperatorInfo()
221 NonMaxSuppressionV5 = OperatorInfo()
222 NotEqual = OperatorInfo()
223 OneHot = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200224 Pack = OperatorInfo(indices=NNG_IFM_INDICES)
225 PackReshaped = OperatorInfo(indices=NNG_IFM_INDICES)
226 Pad = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200227 PadV2 = OperatorInfo()
228 Placeholder = OperatorInfo() # Only used in CPU subgraphs
229 Pow = OperatorInfo()
230 Prelu = OperatorInfo()
231 Prod = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200232 Quantize = OperatorInfo(indices=NNG_IFM_INDICES)
233 QuantizedAvgPool = OperatorInfo(block_type=NpuBlockType.Pooling, indices=NNG_IFM_INDICES)
234 QuantizedConv2D = OperatorInfo(block_type=NpuBlockType.ConvolutionMxN, indices=NNG_IFM_WEIGHTS_INDICES)
235 QuantizedMatMul = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
236 QuantizedMaxPool = OperatorInfo(block_type=NpuBlockType.Pooling, indices=NNG_IFM_INDICES)
237 QuantizedReshape = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200238 Range = OperatorInfo()
239 Rank = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200240 ReduceSum = OperatorInfo(block_type=NpuBlockType.ReduceSum, indices=NNG_IFM_INDICES)
241 Relu = OperatorInfo(indices=NNG_IFM_INDICES)
242 Relu6 = OperatorInfo(indices=NNG_IFM_INDICES)
243 ReluN1To1 = OperatorInfo(indices=NNG_IFM_INDICES)
244 ReluN = OperatorInfo(indices=NNG_IFM_INDICES) # TOSA specific
245 Rescale = OperatorInfo(indices=NNG_IFM_INDICES) # TOSA specific
246 RescaleAdd = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
Patrik Gustavssonb081d672021-08-25 13:49:25 +0200247 RescaleMul = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200248 Reshape = OperatorInfo(indices=NNG_IFM_INDICES)
249 ResizeBilinear = OperatorInfo(block_type=NpuBlockType.Pooling, indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200250 ResizeNearestNeighbor = OperatorInfo()
251 ReverseSequence = OperatorInfo()
252 ReverseV2 = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200253 Rnn = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200254 Round = OperatorInfo()
255 Rsqrt = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200256 SHL = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES) # NPU specific operation
257 SHR = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES) # NPU specific operation
Louis Verhaardaee5d752020-09-30 09:01:52 +0200258 ScatterNd = OperatorInfo()
259 SegmentSum = OperatorInfo()
260 Select = OperatorInfo()
261 SelectV2 = OperatorInfo()
262 Shape = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200263 Sigmoid = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200264 SignBit = OperatorInfo()
265 Sin = OperatorInfo()
266 SkipGram = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200267 Slice = OperatorInfo(indices=NNG_IFM_INDICES)
268 Softmax = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200269 SpaceToBatchND = OperatorInfo()
270 SpaceToDepth = OperatorInfo()
271 SparseToDense = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200272 Split = OperatorInfo(indices=NNG_SPLIT_IFM_INDICES)
273 SplitSliceRead = OperatorInfo(indices=NNG_IFM_INDICES)
274 SplitV = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200275 Sqrt = OperatorInfo()
276 Square = OperatorInfo()
277 SquaredDifference = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200278 Squeeze = OperatorInfo(indices=NNG_IFM_INDICES)
279 StridedSlice = OperatorInfo(indices=NNG_IFM_INDICES)
280 Sub = OperatorInfo(block_type=NpuBlockType.ElementWise, indices=NNG_IFM_IFM2_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200281 SubgraphInput = OperatorInfo() # Only used in CPU subgraphs
282 Sum = OperatorInfo()
283 Svdf = OperatorInfo()
Patrik Gustavssonf436ada2021-09-14 14:56:48 +0200284 Table = OperatorInfo(indices=NNG_IFM_INDICES)
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200285 Tanh = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200286 Tile = OperatorInfo()
287 TopKV2 = OperatorInfo()
James Ward6bf16132021-09-08 11:14:20 +0100288 Transpose = OperatorInfo(indices=NNG_IFM_IFM2_INDICES)
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200289 UnidirectionalSequenceLstm = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
290 UnidirectionalSequenceRnn = OperatorInfo(block_type=NpuBlockType.VectorProduct, indices=NNG_IFM_WEIGHTS_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200291 Unique = OperatorInfo()
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200292 Unpack = OperatorInfo(indices=NNG_IFM_INDICES)
293 UnpackReshaped = OperatorInfo(indices=NNG_IFM_INDICES)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200294 Where = OperatorInfo()
295 While = OperatorInfo()
296 ZerosLike = OperatorInfo()
Dwight Lidman8a12da12021-07-19 13:43:05 +0200297 CallOnce = OperatorInfo()
298 BroadcastTo = OperatorInfo()
299 Rfft2D = OperatorInfo()
300 Conv3D = OperatorInfo()
301 Imag = OperatorInfo()
302 Real = OperatorInfo()
303 ComplexAbs = OperatorInfo()
304 Hashtable = OperatorInfo()
305 HashtableFind = OperatorInfo()
306 HashtableImport = OperatorInfo()
307 HashtableSize = OperatorInfo()
308 ReduceAll = OperatorInfo()
309 Conv3DTranspose = OperatorInfo()
Rickard Bolin2de898a2021-12-20 08:35:23 +0000310 VarHandle = OperatorInfo()
311 ReadVariable = OperatorInfo()
312 AssignVariable = OperatorInfo()
313 BroadcastArgs = OperatorInfo()
314 RandomStandardNormal = OperatorInfo()
Louis Verhaardaee5d752020-09-30 09:01:52 +0200315
316 @property
317 def info(self):
318 return self.value
319
320 @property
321 def npu_block_type(self):
322 return self.info.block_type
323
324 def is_conv2d_op(self):
325 return self.info.block_type == NpuBlockType.ConvolutionMxN
326
327 def is_depthwise_conv2d_op(self):
328 return self.info.block_type == NpuBlockType.ConvolutionDepthWise
329
330 def is_pool_op(self):
331 return self.info.block_type == NpuBlockType.Pooling
332
333 def is_maxpool_op(self):
334 return self in (Op.MaxPool, Op.QuantizedMaxPool)
335
336 def is_avgpool_op(self):
337 return self in (Op.QuantizedAvgPool, Op.AvgPool)
338
339 def is_elementwise_op(self):
340 return self.info.block_type == NpuBlockType.ElementWise
341
342 def is_unary_elementwise_op(self):
343 return self.info.block_type == NpuBlockType.ElementWise and self.info.is_unary
344
345 def is_binary_elementwise_op(self):
346 return self.info.block_type == NpuBlockType.ElementWise and not self.info.is_unary
347
348 def is_relu_op(self):
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200349 return self in (Op.Relu, Op.Relu6, Op.ReluN1To1, Op.ReluN, Op.Clip, Op.Clamp)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200350
351 def is_activation_op(self):
Diqing Zhong189f7482021-01-26 12:12:51 +0100352 return self.is_relu_op() or self in (Op.Tanh, Op.Sigmoid, Op.Softmax, Op.LUT, Op.HardSwish)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200353
354 def is_split_op(self):
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100355 return self in (Op.Split, Op.SplitV, Op.StridedSlice, Op.Slice, Op.UnpackReshaped, Op.Unpack)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200356
357 def is_concat_op(self):
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100358 return self in (Op.Concat, Op.ConcatTFLite, Op.PackReshaped, Op.Pack)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200359
360 def needs_bias(self):
361 return bool(self.info.indices.biases)
362
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100363 def needs_shapes(self):
364 return bool(self.info.indices.ifms)
365
Louis Verhaardaee5d752020-09-30 09:01:52 +0200366 @classmethod
367 def op_set(cls, predicate):
368 # Returns the set of all operator codes that fulfill the given predicate
369 return {op_type for op_type in Op if predicate(op_type)}
370
371 def __str__(self):
372 return self.name
373
374 __repr__ = __str__
375
376 def __lt__(self, other):
377 return self.value.id < other.value.id
378
379
Michael McGeagh16895482020-12-14 15:51:20 +0000380class Padding(Enum):
381 SAME = 0
382 VALID = 1
Louis Verhaardae2d5532020-12-11 17:19:54 +0100383 EXPLICIT = 2 # Padding is specified in a PAD operation (only used for NPU operations)
Michael McGeagh16895482020-12-14 15:51:20 +0000384
385
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100386class ActivationFunction:
387 """Fused activation function"""
388
389 def __init__(self, op_type: Op):
390 self.op_type = op_type # The activation operation to be performed
391 # min/max are optional; if present they are non-quantized values
392 self.min: Optional[float] = None
393 self.max: Optional[float] = None
394 # Table lookup index, only applicable for Op.LUT activation, 0-7
395 self.lut_index: int = 0
396
397 def clone(self):
398 res = copy.copy(self)
399 return res
400
401
Patrik Gustavsson8f1f9aa2021-06-28 07:41:58 +0200402class ExplicitScaling:
403 """Explicit scaling parameters"""
404
405 def __init__(self, per_channel, shift, multiplier):
406 self.per_channel = per_channel
407 self.shift = shift
408 self.multiplier = multiplier
409
410 def clone(self):
411 res = copy.copy(self)
412 return res
413
414
415def create_activation_function(op_type: Op, min=None, max=None) -> ActivationFunction:
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100416 """Creates activation function with min/max depending on op_type"""
417 act = ActivationFunction(op_type)
418 if op_type == Op.Relu:
419 act.min = 0.0
420 elif op_type == Op.Relu6:
421 act.min = 0.0
422 act.max = 6.0
423 elif op_type == Op.ReluN1To1:
424 act.min = -1.0
425 act.max = 1.0
426 elif op_type == Op.Tanh:
427 act.min = -1.0
428 act.max = 1.0
429 elif op_type == Op.Sigmoid:
430 act.min = 0.0
431 act.max = 1.0
Diqing Zhong189f7482021-01-26 12:12:51 +0100432 elif op_type == Op.HardSwish:
433 act.min = 0.0
Patrik Gustavsson5e26eda2021-06-30 09:07:16 +0200434 if op_type == Op.Clamp:
Patrik Gustavsson8f1f9aa2021-06-28 07:41:58 +0200435 assert min is not None and max is not None
436 act.min = min
437 act.max = max
438 elif op_type == Op.ReluN:
439 assert max is not None
440 act.min = 0.0
441 act.max = max
442
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100443 return act
444
445
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000446def get_slice_offsets(input_shape: List[int], offset_tens: int, offset_mask: int, is_begin: bool = True):
Louis Verhaardfa2f92a2020-09-21 11:56:18 +0200447 # For strided slice operator: get start or end offsets
448 offsets = len(input_shape) * [0] if is_begin else input_shape[:]
449 for idx in range(len(input_shape)):
450 # If the i:th bit in the mask is set then the value on offset_tens[i] should be ignored
451 if (offset_mask & (1 << idx)) == 0:
452 offsets[idx] = offset_tens.values[idx]
453 if offsets[idx] < 0:
454 # Convert offset to positive value
455 offsets[idx] += input_shape[idx]
456 return offsets
457
458
Tim Hall79d07d22020-04-27 18:20:16 +0100459class Operation:
460 """Class representing a Neural Network operation. Has a name, a type,
Dwight Lidmanc6ac1942020-10-02 14:55:45 +0200461 input and output tensors, as well as an attribute dictionary."""
Tim Hall79d07d22020-04-27 18:20:16 +0100462
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200463 __slots__ = (
464 "type",
465 "name",
466 "op_index",
467 "attrs",
468 "inputs",
469 "outputs",
Fredrik Svedberg8d0f4892021-02-16 21:59:50 +0100470 "intermediates",
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200471 "flops",
472 "scheduled_pass",
473 "run_on_npu",
Louis Verhaardaee5d752020-09-30 09:01:52 +0200474 "activation",
475 "memory_function",
Dwight Lidman4f728c02020-12-17 15:14:45 +0100476 "forced_input_quantization",
Louis Verhaardaee5d752020-09-30 09:01:52 +0200477 "forced_output_quantization",
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200478 "activation_lut",
Tim Hall4ed38bc2020-10-20 18:54:20 +0100479 "_kernel",
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100480 "ifm_shapes",
481 "ofm_shapes",
Fredrik Svedberge82be7c2021-01-18 15:21:03 +0100482 "rescale",
Patrik Gustavssone3b1b912021-02-09 15:38:46 +0100483 "read_offsets",
Tim Halld8339a72021-05-27 18:49:40 +0100484 "read_shapes",
Louis Verhaard1a92f782021-02-09 16:08:26 +0100485 "rounding_mode",
Patrik Gustavsson8f1f9aa2021-06-28 07:41:58 +0200486 "explicit_scaling",
Dwight Lidman4f728c02020-12-17 15:14:45 +0100487 "low_precision_scaling",
Louis Verhaardc822d622021-03-11 14:59:06 +0100488 "write_offset",
489 "write_shape",
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200490 )
Tim Hall79d07d22020-04-27 18:20:16 +0100491
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100492 def __init__(self, op_type: Op, name: str):
Tim Hall79d07d22020-04-27 18:20:16 +0100493 self.type = op_type
494 self.name = name
Dwight Lidman9b43f842020-12-08 17:56:44 +0100495 self.attrs: Dict[str, Any] = {}
496 self.inputs: List[Tensor] = []
497 self.outputs: List[Tensor] = []
Fredrik Svedberg8d0f4892021-02-16 21:59:50 +0100498 self.intermediates: List[Tensor] = []
Tim Hall79d07d22020-04-27 18:20:16 +0100499 self.flops = 0
500 self.run_on_npu = True
Louis Verhaardaee5d752020-09-30 09:01:52 +0200501 # Fused activation function. If not none: operator code.
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100502 self.activation: Optional[ActivationFunction] = None
Louis Verhaardaee5d752020-09-30 09:01:52 +0200503 # Fused memory function, if not None: operator code
Louis Verhaardc822d622021-03-11 14:59:06 +0100504 self.memory_function: Optional[Op] = None
Louis Verhaardaee5d752020-09-30 09:01:52 +0200505 # If not none: contains QuantizationParameters to be used as output quantization
506 # (which overrides the ofm tensor's quantization), used in LUT
Dwight Lidman4f728c02020-12-17 15:14:45 +0100507 self.forced_input_quantization = None
Louis Verhaardaee5d752020-09-30 09:01:52 +0200508 self.forced_output_quantization = None
Tim Hall79d07d22020-04-27 18:20:16 +0100509 self.scheduled_pass = None
Tim Hallc8310b12020-06-17 14:53:11 +0100510 self.op_index = None # input network operator index
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200511 self.activation_lut = None
Tim Hall4ed38bc2020-10-20 18:54:20 +0100512 self._kernel = None
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000513 self.ifm_shapes: List[Shape4D] = []
514 self.ofm_shapes: List[Shape4D] = []
Fredrik Svedberge82be7c2021-01-18 15:21:03 +0100515 # If not none: contains rescale to be used as output scaling
516 # (which overrides the ofm tensor's scale)
517 self.rescale = None
Patrik Gustavssone3b1b912021-02-09 15:38:46 +0100518 self.read_offsets: List[Shape4D] = [None, None] # offset for [ifm, ifm2]
Tim Halld8339a72021-05-27 18:49:40 +0100519 self.read_shapes: List[Shape4D] = [None, None] # read shape for [ifm, ifm2]
Louis Verhaard1a92f782021-02-09 16:08:26 +0100520 self.rounding_mode: Optional[NpuRoundingMode] = None
Patrik Gustavsson8f1f9aa2021-06-28 07:41:58 +0200521 # Rescale op in TOSA supplies explicit multiplier and shift values
522 self.explicit_scaling: Optional[ExplicitScaling] = None
Dwight Lidman4f728c02020-12-17 15:14:45 +0100523 # The Mean operator (implemented as a depthwise convolution) requires scaling
524 # to be calculated differently in one case. In that case, this is set to True.
525 self.low_precision_scaling = False
Louis Verhaardc822d622021-03-11 14:59:06 +0100526 # Write offset, for operations that only produce a part of the OFM
527 self.write_offset: Optional[Shape4D] = None
528 # The amount of OFM that is produced by the operation (only if write_offset is not None).
529 # E.g. an operation that only fills the bottom row of an OFM of size 1x10x8x1 would have
530 # write_offset 0,9,0,0, write_shape 1,1,8,1
531 self.write_shape: Optional[Shape4D] = None
Tim Hall79d07d22020-04-27 18:20:16 +0100532
533 def clone(self, suffix="_clone"):
534 res = Operation(self.type, self.name + suffix)
535
536 res.attrs = dict(self.attrs)
537 res.inputs = list(self.inputs)
538 res.outputs = list(self.outputs)
Fredrik Svedberg8d0f4892021-02-16 21:59:50 +0100539 res.intermediates = list(self.intermediates)
Tim Hall79d07d22020-04-27 18:20:16 +0100540 res.flops = self.flops
Louis Verhaardaee5d752020-09-30 09:01:52 +0200541 res.run_on_npu = self.run_on_npu
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100542 res.activation = None if self.activation is None else self.activation.clone()
Louis Verhaardaee5d752020-09-30 09:01:52 +0200543 res.memory_function = self.memory_function
Dwight Lidman4f728c02020-12-17 15:14:45 +0100544 res.forced_input_quantization = self.forced_input_quantization
Louis Verhaardaee5d752020-09-30 09:01:52 +0200545 res.forced_output_quantization = self.forced_output_quantization
Tim Hall79d07d22020-04-27 18:20:16 +0100546 res.scheduled_pass = self.scheduled_pass
Tim Hallc8310b12020-06-17 14:53:11 +0100547 res.op_index = None # not relevant as not part of input network
Patrik Gustavssone3b1b912021-02-09 15:38:46 +0100548 res.read_offsets = list(self.read_offsets)
Tim Halld8339a72021-05-27 18:49:40 +0100549 res.read_shapes = list(self.read_shapes)
Louis Verhaard1a92f782021-02-09 16:08:26 +0100550 res.rounding_mode = self.rounding_mode
Patrik Gustavsson8f1f9aa2021-06-28 07:41:58 +0200551 res.explicit_scaling = self.explicit_scaling
Dwight Lidman4f728c02020-12-17 15:14:45 +0100552 res.low_precision_scaling = self.low_precision_scaling
Patrik Gustavsson46408a82021-09-20 10:47:47 +0200553 res.rescale = self.rescale
Tim Hall79d07d22020-04-27 18:20:16 +0100554
555 return res
556
557 def __str__(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200558 return "<nng.Operation '{}' type={}>".format(self.name, self.type)
Tim Hall79d07d22020-04-27 18:20:16 +0100559
560 __repr__ = __str__
561
Michael McGeagh65fd9982020-10-20 11:49:28 +0100562 def get_kernel_size(self):
Tim Hall4ed38bc2020-10-20 18:54:20 +0100563 weights = self.weights
564 if weights and self.type.npu_block_type in (NpuBlockType.ConvolutionDepthWise, NpuBlockType.ConvolutionMxN):
565 weight_shape = full_shape(4, weights.shape, 1)
Michael McGeagh65fd9982020-10-20 11:49:28 +0100566 h = weight_shape[-4]
567 w = weight_shape[-3]
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100568 elif self.type.npu_block_type in (NpuBlockType.Pooling, NpuBlockType.ReduceSum) and "ksize" in self.attrs:
569 h, w = self.attrs["ksize"][1:3]
Tim Hall4ed38bc2020-10-20 18:54:20 +0100570 else:
Michael McGeagh65fd9982020-10-20 11:49:28 +0100571 h = self.attrs.get("filter_height", 1)
572 w = self.attrs.get("filter_width", 1)
573 return w, h
574
575 def get_kernel_stride(self):
576 if "strides" in self.attrs:
577 _, h, w, _ = self.attrs["strides"]
578 else:
579 h = self.attrs.get("stride_h", 1)
580 w = self.attrs.get("stride_w", 1)
581 return w, h
582
583 def get_kernel_dilation(self):
584 if "dilation" in self.attrs:
585 _, h, w, _ = self.attrs["dilation"]
586 else:
587 h = self.attrs.get("dilation_h_factor", 1)
588 w = self.attrs.get("dilation_w_factor", 1)
589 return w, h
590
591 @property
592 def kernel(self):
593 k_w, k_h = self.get_kernel_size()
594 s_w, s_h = self.get_kernel_stride()
595 d_w, d_h = self.get_kernel_dilation()
596 self._kernel = Kernel(k_w, k_h, s_w, s_h, d_w, d_h)
Tim Hall4ed38bc2020-10-20 18:54:20 +0100597 return self._kernel
598
Tim Hall79d07d22020-04-27 18:20:16 +0100599 def get_ifm_ifm2_weights_ofm(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200600 return self.ifm, self.ifm2, self.weights, self.ofm
Tim Hall79d07d22020-04-27 18:20:16 +0100601
Patrik Gustavssone2bfa7e2021-09-08 15:04:11 +0200602 def get_ifm_ifm2_ofm(self):
603 return self.ifm, self.ifm2, self.ofm
604
Tim Hall79d07d22020-04-27 18:20:16 +0100605 def get_ifm_weights_biases_ofm(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200606 return self.ifm, self.weights, self.bias, self.ofm
Tim Hall79d07d22020-04-27 18:20:16 +0100607
Jacob Bohlin49d92122020-08-19 14:36:46 +0200608 def get_ifm_ifm2_weights_biases_ofm(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200609 return self.ifm, self.ifm2, self.weights, self.bias, self.ofm
Jacob Bohlin49d92122020-08-19 14:36:46 +0200610
Louis Verhaardaee5d752020-09-30 09:01:52 +0200611 def get_ifm_ofm(self):
612 return self.ifm, self.ofm
Jacob Bohlin49d92122020-08-19 14:36:46 +0200613
Louis Verhaardaee5d752020-09-30 09:01:52 +0200614 @property
615 def ifm(self):
616 # Gets the IFM tensor, or None if not applicable
617 return self.get_input(self.type.info.indices.ifms, 0)
Jacob Bohlin49d92122020-08-19 14:36:46 +0200618
Louis Verhaardaee5d752020-09-30 09:01:52 +0200619 @property
620 def ifm2(self):
621 # Gets the IFM2 tensor, or None if not applicable
622 return self.get_input(self.type.info.indices.ifms, 1)
Louis Verhaard98a34992020-09-01 10:39:04 +0200623
Louis Verhaardaee5d752020-09-30 09:01:52 +0200624 @property
625 def bias(self):
626 # Gets the bias tensor, or None if not applicable
627 return self.get_input(self.type.info.indices.biases, 0)
628
629 @property
630 def weights(self):
631 # Gets the weight tensor, or None if not applicable
632 return self.get_input(self.type.info.indices.weights, 0)
633
634 def get_ifm_tensors(self):
635 # Gets the IFM tensors, or empty list if not applicable
636 return self._index_list_to_tensors(self.type.info.indices.ifms)
637
638 def get_weight_tensors(self):
639 # Gets the weight tensors, or empty list if not applicable
640 return self._index_list_to_tensors(self.type.info.indices.weights)
641
642 def get_bias_tensors(self):
643 # Gets the bias tensors, or empty list if not applicable
644 return self._index_list_to_tensors(self.type.info.indices.biases)
645
646 def _index_list_to_tensors(self, index_list):
647 return [self.inputs[ix] for ix in index_list if ix < len(self.inputs)]
648
649 def get_input(self, index_list, ix):
650 if ix >= len(index_list):
651 return None
652 if index_list[ix] >= len(self.inputs):
653 return None
654 return self.inputs[index_list[ix]]
655
656 @property
657 def ofm(self):
658 # Gets the OFM tensor, or None if not applicable
659 return self.outputs[0] if self.outputs else None
Tim Hall79d07d22020-04-27 18:20:16 +0100660
661 def get_concat_inputs_axis(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200662 assert self.type.is_concat_op()
Tim Hall79d07d22020-04-27 18:20:16 +0100663
Louis Verhaardaee5d752020-09-30 09:01:52 +0200664 if self.type == Op.Concat:
Tim Hall79d07d22020-04-27 18:20:16 +0100665 axis_tensor = self.inputs[0]
666 inputs = self.inputs[1:]
Louis Verhaardaee5d752020-09-30 09:01:52 +0200667 elif self.type == Op.ConcatTFLite:
Tim Hall79d07d22020-04-27 18:20:16 +0100668 inputs = self.inputs
669 axis = self.attrs["axis"]
Louis Verhaardaee5d752020-09-30 09:01:52 +0200670 elif self.type == Op.PackReshaped:
Tim Hall79d07d22020-04-27 18:20:16 +0100671 # Requires fixup_pack_input to be called before this point
672 inputs = self.inputs
673 axis = self.attrs["axis"]
674 assert len(self.inputs) == self.attrs["values_count"]
675 else:
Louis Verhaardaee5d752020-09-30 09:01:52 +0200676 assert len(axis_tensor.ops) == 1 and axis_tensor.ops[0].type == Op.Const
Tim Hall79d07d22020-04-27 18:20:16 +0100677 axis = int(axis_tensor.values)
678
679 return inputs, axis
680
Louis Verhaardb2fb2122020-06-04 15:51:24 +0200681 def get_dilation_h_w(self):
682 _, dilation_h, dilation_w, _ = self.attrs.get("dilation", (1, 1, 1, 1))
683 return dilation_h, dilation_w
684
Tim Hall79d07d22020-04-27 18:20:16 +0100685 def get_split_inputs_axis(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200686 assert self.type.is_split_op()
Tim Hall79d07d22020-04-27 18:20:16 +0100687
688 offset_start = None
689 offset_end = None
690 axis = None
Louis Verhaardaee5d752020-09-30 09:01:52 +0200691 if self.type == Op.Split:
Tim Hall79d07d22020-04-27 18:20:16 +0100692 num_splits = self.attrs.get("num_splits")
693 axis_tens = self.inputs[0]
Louis Verhaardaee5d752020-09-30 09:01:52 +0200694 assert len(axis_tens.ops) == 1 and axis_tens.ops[0].type == Op.Const
Tim Hall79d07d22020-04-27 18:20:16 +0100695 axis = int(axis_tens.values)
696 input_tens = self.inputs[1]
697 outputs = self.outputs
698 assert num_splits == len(outputs)
699
Louis Verhaardaee5d752020-09-30 09:01:52 +0200700 elif self.type == Op.SplitV:
Charles Xu53d47522020-05-04 11:32:05 +0200701 num_splits = self.attrs.get("num_splits")
702 input_tens = self.inputs[0]
703 size_tens = self.inputs[1]
Louis Verhaardaee5d752020-09-30 09:01:52 +0200704 assert len(size_tens.ops) == 1 and size_tens.ops[0].type == Op.Const
Charles Xu53d47522020-05-04 11:32:05 +0200705 sizes = size_tens.values
Patrik Gustavsson271ddc32020-09-01 09:15:27 +0200706
Charles Xu53d47522020-05-04 11:32:05 +0200707 axis_tens = self.inputs[2]
Louis Verhaardaee5d752020-09-30 09:01:52 +0200708 assert len(axis_tens.ops) == 1 and axis_tens.ops[0].type == Op.Const
Charles Xu53d47522020-05-04 11:32:05 +0200709 axis = int(axis_tens.values)
Patrik Gustavsson271ddc32020-09-01 09:15:27 +0200710
711 for idx, size in enumerate(sizes):
712 # One but only one size might be set to -1, indicating that size should be inferred
713 if size == -1:
714 sizes[idx] = input_tens.shape[axis] - (sum(sizes) + 1)
715 break
716
Charles Xu53d47522020-05-04 11:32:05 +0200717 outputs = self.outputs
718 assert num_splits == len(outputs)
719 assert sum(sizes) == input_tens.shape[axis]
720
Louis Verhaardaee5d752020-09-30 09:01:52 +0200721 elif self.type == Op.Slice:
Tim Hall79d07d22020-04-27 18:20:16 +0100722 input_tens, begin_tens, size_tens = self.inputs
723 outputs = self.outputs
724 offset_start = [0] * len(input_tens.shape)
725 offset_end = [0] * len(input_tens.shape)
726
727 for idx in range(len(begin_tens.values)):
728 # Check if the op should slice in dimension idx
729 if size_tens.values[idx] != input_tens.shape[idx]:
730 offset_start[idx] = begin_tens.values[idx]
731 offset_end[idx] = size_tens.values[idx] + offset_start[idx]
732
Louis Verhaardaee5d752020-09-30 09:01:52 +0200733 elif self.type == Op.StridedSlice:
Tim Hall79d07d22020-04-27 18:20:16 +0100734 input_tens, begin_tens, end_tens, strides_tens = self.inputs
735 outputs = self.outputs
Tim Hall79d07d22020-04-27 18:20:16 +0100736
737 # Extract masks
738 begin_mask = self.attrs["begin_mask"]
739 ellipsis_mask = self.attrs["ellipsis_mask"]
740 end_mask = self.attrs["end_mask"]
741 new_axis_mask = self.attrs["new_axis_mask"]
742 shrink_axis_mask = self.attrs["shrink_axis_mask"]
Patrik Gustavssoncf728902020-04-30 08:57:23 +0200743
744 # shrink_axis_mask/new_axis_mask/ellipsis_mask is not supported by the Operation class but the operation
Tim Hall79d07d22020-04-27 18:20:16 +0100745 # may have the attribute modified and handled in the graph optimization phase.
Patrik Gustavssoncf728902020-04-30 08:57:23 +0200746 assert shrink_axis_mask == new_axis_mask == ellipsis_mask == 0
Louis Verhaardfa2f92a2020-09-21 11:56:18 +0200747 offset_start = get_slice_offsets(input_tens.shape, begin_tens, begin_mask, is_begin=True)
748 offset_end = get_slice_offsets(input_tens.shape, end_tens, end_mask, is_begin=False)
Louis Verhaardaee5d752020-09-30 09:01:52 +0200749 elif self.type == Op.UnpackReshaped:
Tim Hall79d07d22020-04-27 18:20:16 +0100750 # Requires fixup_unpack_output to be called before this point
751 input_tens = self.inputs[0]
752 outputs = self.outputs
753 axis = self.attrs["axis"]
754 num_splits = self.attrs["num"]
755 # Number of outputs have to equal the value of the dimension to unpack
756 assert num_splits == len(outputs) == input_tens.shape[axis]
757 else:
758 assert False
759
760 return input_tens, outputs, axis, offset_start, offset_end
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200761
762 def set_activation_lut(self, lut_tensor):
Louis Verhaarde8a5a782020-11-02 18:04:27 +0100763 self.activation = ActivationFunction(Op.LUT)
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200764 self.activation_lut = lut_tensor
Michael McGeaghc5b549b2020-08-07 11:54:28 +0100765 self.add_input_tensor(lut_tensor)
Michael McGeagh5778ffd2020-08-06 17:31:02 +0100766
767 def add_input_tensor(self, tens):
768 self.inputs.append(tens)
769 if self not in tens.consumer_list:
770 tens.consumer_list.append(self)
771
Jacob Bohlin67e0d8f2020-08-20 10:53:02 +0200772 def set_input_tensor(self, tens, idx):
773 tens_to_remove = self.inputs[idx]
774 if tens_to_remove in tens.consumer_list:
775 tens.consumer_list.remove(tens_to_remove)
776
777 self.inputs[idx] = tens
778 if self not in tens.consumer_list:
779 tens.consumer_list.append(self)
780
Dwight Lidman4f728c02020-12-17 15:14:45 +0100781 def get_input_quantization(self):
782 if self.forced_input_quantization is not None:
783 return self.forced_input_quantization
784 return self.ifm.quantization
785
Michael McGeagh5778ffd2020-08-06 17:31:02 +0100786 def set_output_tensor(self, tens):
787 tens.ops = [self]
788 self.outputs = [tens]
Jacob Bohlina41cd4d2020-08-26 18:21:28 +0200789
Louis Verhaard98a34992020-09-01 10:39:04 +0200790 def get_output_quantization(self):
Louis Verhaardaee5d752020-09-30 09:01:52 +0200791 if self.forced_output_quantization is not None:
792 return self.forced_output_quantization
793 return self.ofm.quantization
Michael McGeagh528a56d2020-12-16 11:33:21 +0000794
795 def error(self, msg):
796 """
797 Raises a VelaError exception for errors encountered when parsing an Operation
798
799 :param self: Operation object that resulted in the error
800 :param msg: str object that contains a description of the specific error encountered
801 """
802
803 def _print_tensors(tensors):
804 lines = []
805 for idx, tens in enumerate(tensors):
806 tens_name = getattr(tens, "name", "Not a Tensor")
807 lines.append(f" {idx} = {tens_name}")
808 return lines
809
810 if self.op_index is None:
811 lines = [f"Invalid {self.type} (name = {self.name}) operator in the internal representation. {msg}"]
812 else:
813 lines = [f"Invalid {self.type} (op_index = {self.op_index}) operator in the input network. {msg}"]
814
815 lines += [" Input tensors:"]
816 lines += _print_tensors(self.inputs)
817
818 lines += [" Output tensors:"]
819 lines += _print_tensors(self.outputs)
820
821 raise VelaError("\n".join(lines))
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100822
823 def set_ifm_ofm_shapes(self):
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000824 self.ifm_shapes = []
825 self.ofm_shapes = []
826
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100827 ifm_tensor, ifm2_tensor, weight_tensor, ofm_tensor = self.get_ifm_ifm2_weights_ofm()
828
829 # set all shapes to op, as 4D
830 if self.type == Op.FullyConnected:
Patrik Gustavsson2c2522d2021-01-29 11:51:31 +0100831 if len(self.ifm.shape) == 2:
832 self.ifm_shapes.append(Shape4D([self.ifm.shape[0], 1, 1, self.ifm.shape[1]]))
833 else:
834 # Special case, handled in graph optimization
835 self.ifm_shapes.append(Shape4D(ifm_tensor.get_full_shape()))
836 if len(self.ofm.shape) == 2:
837 self.ofm_shapes.append(Shape4D([self.ofm.shape[0], 1, 1, self.ofm.shape[1]]))
838 else:
839 self.ofm_shapes.append(Shape4D(ofm_tensor.get_full_shape()))
840 if self.type == Op.Softmax:
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000841 self.ifm_shapes.append(Shape4D(ifm_tensor.get_full_shape()))
842 self.ofm_shapes.append(Shape4D(ofm_tensor.get_full_shape()))
Patrik Gustavssonda2b0032021-02-04 16:28:29 +0100843 elif self.type.is_split_op() or self.type.is_concat_op():
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100844 for inp in self.inputs:
845 if inp is not None:
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000846 self.ifm_shapes.append(Shape4D(full_shape(4, inp.shape, 1)))
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100847 else:
848 self.ifm_shapes.append(None)
849 for out in self.outputs:
850 if out is not None:
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000851 self.ofm_shapes.append(Shape4D(full_shape(4, out.shape, 1)))
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100852 else:
853 self.ofm_shapes.append(None)
854 else:
Patrik Gustavssonda2b0032021-02-04 16:28:29 +0100855 if ifm_tensor is not None:
856 self.ifm_shapes.append(Shape4D(full_shape(4, ifm_tensor.shape, 1)))
Patrik Gustavsson2349d422020-12-01 16:02:29 +0100857 if ifm2_tensor is not None:
patrik.gustavssoneeb85152020-12-21 17:10:40 +0000858 self.ifm_shapes.append(Shape4D(full_shape(4, ifm2_tensor.shape, 1)))
Patrik Gustavssonda2b0032021-02-04 16:28:29 +0100859 if ofm_tensor is not None:
860 self.ofm_shapes.append(Shape4D(full_shape(4, ofm_tensor.shape, 1)))
Tim Halld8339a72021-05-27 18:49:40 +0100861
862 def has_scaling(self):
863 scaled = True
864 for tensor in [self.ifm, self.ifm2, self.ofm]:
865 if tensor is not None:
866 if tensor.quantization is None:
867 scaled = False
868 break
869
870 return scaled