aboutsummaryrefslogtreecommitdiff
path: root/arm_compute/core/NEON/kernels/convolution/winograd/winograd_output_transform.hpp
blob: 07a0b8666a5cfcede77b30951fe66d6f8221b1c1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
/*
 * Copyright (c) 2018 ARM Limited.
 *
 * SPDX-License-Identifier: MIT
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to
 * deal in the Software without restriction, including without limitation the
 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 * sell copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

#pragma once

namespace winograd
{


namespace
{

template <int KernelRows, int KernelCols, int InnerTileRows, int InnerTileCols, typename T>
class OutputTransformImplTiles
{
  public:
    typedef void (*TileFn)(
      const int n_channels,         /** @param[in] Number of channels in output tensor */
      const T* const matrix_base,   /** @param[in] Base pointer to Winograd output matrices. */
      const int matrix_stride,      /** @param[in] Stride between matrices in the output space. */
      const T* const biases,        /** @param[in] Pointer to bias vector (may be nullptr). */
      T* const output,              /** @param[out] Pointer to output tensor. */
      const int output_row_stride,  /** @param[in] Stride across rows of the output tensor. */
      const int output_col_stride,  /** @param[in] Stride between columns of the output tensor. */
      const int _pad_bottom,        /** @param[in] Bottom padding for unspecialised tiles. */
      const int _pad_right          /** @param[in] Right padding for unspecialised tiles. */
    );

    static TileFn get_tile_specialization(
      const int pad_bottom,
      const int pad_right
    );

    static constexpr unsigned int OutputTileRows = InnerTileRows - KernelRows + 1;
    static constexpr unsigned int OutputTileCols = InnerTileCols - KernelCols + 1;

  private:
    static constexpr unsigned int n_pad_bottom = OutputTileRows - 1;
    static constexpr unsigned int n_pad_right = OutputTileCols - 1;

    static const TileFn tilefn_generic;   /** Generic tile processing function. */
    static const TileFn tilefn_unpadded;  /** Tile processor for unpadded tiles. */
    static const TileFn tilefn_bottom_padded[n_pad_bottom];  /** Bottom padding only. */
    static const TileFn tilefn_right_padded[n_pad_right];    /** Right padding only. */
};

template <int KernelCols, int InnerTileCols, typename T>
class OutputTransformImplTiles<1, KernelCols, 1, InnerTileCols, T>
{
  public:
    typedef void (*TileFn)(
      const int n_channels,         /** @param[in] Number of channels in output tensor */
      const T* const matrix_base,   /** @param[in] Base pointer to Winograd output matrices. */
      const int matrix_stride,      /** @param[in] Stride between matrices in the output space. */
      const T* const biases,        /** @param[in] Pointer to bias vector (may be nullptr). */
      T* const output,              /** @param[out] Pointer to output tensor. */
      const int output_row_stride,  /** @param[in] Stride across rows of the output tensor. */
      const int output_col_stride,  /** @param[in] Stride between columns of the output tensor. */
      const int _pad_bottom,        /** @param[in] Bottom padding for unspecialised tiles. */
      const int _pad_right          /** @param[in] Right padding for unspecialised tiles. */
    );

    static TileFn get_tile_specialization(
      const int pad_bottom,
      const int pad_right
    );

    static constexpr unsigned int OutputTileRows = 1;
    static constexpr unsigned int OutputTileCols = InnerTileCols - KernelCols + 1;

  private:
    static constexpr unsigned int n_pad_right = OutputTileCols - 1;

    static const TileFn tilefn_unpadded;  /** Tile processor for unpadded tiles. */
    static const TileFn tilefn_right_padded[n_pad_right];    /** Right padding only. */
};

template <int KernelRows, int KernelCols, int InnerTileRows, int InnerTileCols, typename T>
class OutputTransformImpl
{
  private:
    static void process_tile_row(
      const int tile_N,
      const int n_channels,
      const T* const matrix_base,
      const int matrix_stride,
      const int matrix_row_stride,
      const T* const biases,
      T* const output,
      const int output_row_stride,
      const int output_col_stride,
      const int row_pad_bottom,
      const int row_pad_right
    );

    using Tiles = OutputTransformImplTiles<
      KernelRows, KernelCols, InnerTileRows, InnerTileCols, T
    >;

  public:
    /** Apply the output transform to a tensor. */
    static void execute(
      const int n_batches,
      const int out_batch_stride,
      const int n_rows,
      const int out_row_stride,
      const int n_cols,
      const int out_col_stride,
      const int n_channels,
      const T* const matrix_base,
      const int matrix_stride,
      const int matrix_row_stride,
      const T* const biases,
      T* const output
    );

    static constexpr unsigned int OutputTileRows = Tiles::OutputTileRows;
    static constexpr unsigned int OutputTileCols = Tiles::OutputTileCols;
};

template <int KernelRows, int InnerTileRows, typename T>
class OutputTransformImpl<KernelRows, 1, InnerTileRows, 1, T>
{
  public:
    /** Apply the output transform to a tensor. */
    static void execute(
      const int n_batches,
      const int out_batch_stride,
      const int n_rows,
      const int out_row_stride,
      const int n_cols,
      const int out_col_stride,
      const int n_channels,
      const T* const matrix_base,
      const int matrix_stride,
      const int matrix_row_stride,
      const T* const biases,
      T* const output
    );

    static constexpr unsigned int OutputTileRows = InnerTileRows - KernelRows + 1;
    static constexpr unsigned int OutputTileCols = 1;
};

}  // namespace (anonymous)

template <int KernelRows, int KernelCols, int InnerTileRows, int InnerTileCols, typename T>
class OutputTransform
{
  public:
    /***********************************************************************/
    /** Create an OutputTransform operator fixed on a given problem and set
     * of pointers.
     */
    OutputTransform(
      const T* const matrix_base,   /** Pointer to base of matrices. */
      const int matrix_stride,      /** Stride between matrices. */
      const int matrix_row_stride,  /** Stride within a matrix. */
      const T* const biases,        /** Pointer to biases vector. */
      T* const output,              /** Pointer to output tensor. */
      const int n_batches,          /** Number of batches in output tensor. */
      const int n_rows,             /** Number of rows in output tensor. */
      const int n_cols,             /** Number of columns in output tensor. */
      const int n_channels,         /** Number of channels in output tensor. */
      const int out_batch_stride=0, /** Output batch stride. */
      const int out_row_stride=0,   /** Output row stride. */
      const int out_col_stride=0    /** Output column stride. */
    );

    /** Get the window of work a given operator can perform. */
    unsigned int get_window() const;
    static constexpr unsigned int WINDOW_BLOCK = 16;  // Base size of window

    /** Perform work upon a window of the input. */
    void run(const unsigned int start, const unsigned int stop);

    /** Apply the transform to create a tensor. */
    static void execute(
      const int n_batches,
      const int out_batch_stride,
      const int n_rows,
      const int out_row_stride,
      const int n_cols,
      const int out_col_stride,
      const int n_channels,
      const T* const matrix_base,
      const int matrix_stride,
      const int matrix_row_stride,
      const T* const biases,
      T* const output
    );

  private:
    using Transform = OutputTransformImpl<
      KernelRows, KernelCols, InnerTileRows, InnerTileCols, T
    >;

    static constexpr unsigned int OutputTileRows = Transform::OutputTileRows;
    static constexpr unsigned int OutputTileCols = Transform::OutputTileCols;

    /** Member constants for instances of the transform. */
    const T* const _matrix_base;
    const T* const _biases;
    const int _matrix_stride, _matrix_row_stride;
    T* const _outptr;
    const int _n_batches, _n_rows, _n_cols, _n_channels, _tile_M, _tile_N;
    const int _out_col_stride, _out_row_stride, _out_batch_stride;
};

}  // namespace winograd