[loco] Introduce DepthwiseFilterEncoder (#4270)

DepthwiseFilterEncoder describes how tensor should be encoded into
depthwise convolutional filter.

Signed-off-by: Cheongyo Bahk <ch.bahk@samsung.com>

diff --git a/contrib/loco/include/loco/IR/DepthwiseFilterCodec.h b/contrib/loco/include/loco/IR/DepthwiseFilterCodec.h
new file mode 100644 (file)
index 0000000..e7fba73
--- /dev/null
+++ b/contrib/loco/include/loco/IR/DepthwiseFilterCodec.h
@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2019 Samsung Electronics Co., Ltd. All Rights Reserved
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef __LOCO_IR_DEPTHWISE_FILTER_CODEC_H__
+#define __LOCO_IR_DEPTHWISE_FILTER_CODEC_H__
+
+#include "loco/IR/DepthwiseFilterShape.h"
+#include "loco/IR/DepthwiseFilterIndex.h"
+
+#include "loco/IR/TensorShape.h"
+#include "loco/IR/TensorIndex.h"
+
+namespace loco
+{
+
+/**
+ * @brief Decribe how to build a depthwise convolution filter from a tensor
+ *
+ * Let us assume that "enc" is a depthwise filter encoder.
+ *
+ * Given a tensor "inp" and its shape "inp.shape", "enc" builds a depthwise filter
+ * "out" as follows:
+ *
+ * for each valid filter_index for enc.shape(inp.shape)
+ *   out.at(filter_index) = inp.at(enc.value(filter_index))
+ */
+struct DepthwiseFilterEncoder
+{
+  virtual ~DepthwiseFilterEncoder() = default;
+
+  virtual DepthwiseFilterShape shape(const TensorShape &shape) const = 0;
+  virtual TensorIndex value(const DepthwiseFilterIndex &index) const = 0;
+};
+
+// TODO Introduce DepthwiseFilterDecoder if required.
+
+} // namespace loco
+
+#endif // __LOCO_IR_DEPTHWISE_FILTER_CODEC_H__

diff --git a/contrib/loco/src/IR/DepthwiseFilterCodec.cpp b/contrib/loco/src/IR/DepthwiseFilterCodec.cpp
new file mode 100644 (file)
index 0000000..05a7fd7
--- /dev/null
+++ b/contrib/loco/src/IR/DepthwiseFilterCodec.cpp
@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2019 Samsung Electronics Co., Ltd. All Rights Reserved
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "loco/IR/DepthwiseFilterCodec.h"
+
+// NOTE This file validates "DepthwiseFilterCodec.h". Please DO NOT remove this file.