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
|
/*
* Copyright (c) Facebook, Inc. and its affiliates.
* All rights reserved.
* This source code is licensed under the BSD-style license found in the
* LICENSE file in the root directory of this source tree.
*/
#pragma once
#include <array>
#include <string>
namespace fbgemm {
/**
* @brief A struct to conveniently store all convolution parameters.
*/
template <int SPATIAL_DIM = 2>
struct conv_param_t {
int MB; ///< Mini Batch size
int IC; ///< Number of Input Channels
int OC; ///< Number of Output Channels
std::array<int, SPATIAL_DIM> IN_DIM; ///< Input Image Dimension
int G; ///< Number of Groups
std::array<int, SPATIAL_DIM> K; ///< Filter (Kernel) dimensions
std::array<int, SPATIAL_DIM> stride; //< Strides
std::array<int, SPATIAL_DIM * 2>
pad; //< Padding (first SPATIAL_DIM is for prev/top/left padding, second
// SPATIAL_DIM is for next/bottom/right padding)
std::array<int, SPATIAL_DIM> dilation; //< Kernel dilation
// The following are derived parameters
std::array<int, SPATIAL_DIM> OUT_DIM; //< Output Image Dimension
std::array<int, SPATIAL_DIM> IN_DIMP; //< Input Image Dimension Padded
/**
* @brief Constructor for initializing the convolution parameters.
* TODO: Dilation is not handled correctly.
*/
conv_param_t(
int mb,
int ic,
int oc,
std::array<int, SPATIAL_DIM> in_dim,
int g,
std::array<int, SPATIAL_DIM> k,
std::array<int, SPATIAL_DIM> strd,
std::array<int, SPATIAL_DIM * 2> pd)
: MB(mb),
IC(ic),
OC(oc),
IN_DIM(in_dim),
G(g),
K(k),
stride(strd),
pad(pd) {
if (ic % g != 0) {
throw std::runtime_error(
"groups = " + std::to_string(g) +
" does not divide number of input channels = " + std::to_string(ic));
}
if (oc % g != 0) {
throw std::runtime_error(
"groups = " + std::to_string(g) +
" does not divide number of output channels = " + std::to_string(oc));
}
for (int d = 0; d < SPATIAL_DIM; ++d) {
dilation[d] = 1;
IN_DIMP[d] = IN_DIM[d] + pad[d] + pad[SPATIAL_DIM + d];
OUT_DIM[d] = (IN_DIMP[d] - K[d]) / stride[d] + 1;
}
}
/**
* @brief Helper function to get convolution parameters as string.
*/
std::string toString() const {
std::string dim_string[3] = {"T", "H", "W"};
std::string out = "";
out += "MB:" + std::to_string(MB) + ", ";
out += "IC:" + std::to_string(IC) + ", ";
out += "OC:" + std::to_string(OC) + ", ";
if (SPATIAL_DIM <= 3) {
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "I" + dim_string[3 - SPATIAL_DIM + d] + ":" +
std::to_string(IN_DIM[d]) + ", ";
}
} else {
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "I" + std::to_string(d) + ":" + std::to_string(IN_DIM[d]) + ", ";
}
}
out += "G:" + std::to_string(G) + ", ";
if (SPATIAL_DIM <= 3) {
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "K" + dim_string[3 - SPATIAL_DIM + d] + ":" +
std::to_string(K[d]) + ", ";
}
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "stride_" + dim_string[3 - SPATIAL_DIM + d] + ":" +
std::to_string(stride[d]) + ", ";
}
for (int d = 0; d < SPATIAL_DIM * 2; ++d) {
out += "pad_" + dim_string[3 - SPATIAL_DIM + (d % SPATIAL_DIM)] + ":" +
std::to_string(pad[d]);
if (d < SPATIAL_DIM * 2 - 1) {
out += ", ";
}
}
} else {
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "K" + std::to_string(d) + ":" + std::to_string(K[d]) + ", ";
}
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "stride_" + std::to_string(d) + ":" + std::to_string(stride[d]) +
", ";
}
for (int d = 0; d < SPATIAL_DIM; ++d) {
out += "pad_" + std::to_string(d) + ":" + std::to_string(pad[d]);
if (d < SPATIAL_DIM * 2 - 1) {
out += ", ";
}
}
}
return out;
}
};
} // namespace fbgemm
|