Integrate CLTensorArgument

- Add CLTensorArgument to query the components and storages as OpenCL
variables (or by values when possible)
- Add caching mechanism in CLTensorArgument to keep track of the components and storages used
- Add unit tests

Resolves COMPMID-5787

Signed-off-by: Gian Marco Iodice <gianmarco.iodice@arm.com>
Signed-off-by: Viet-Hoa Do <viet-hoa.do@arm.com>
Change-Id: Ib39e1f77b097e5b907a296fe6b0d41bb4bcd4ffc
Reviewed-on: https://review.mlplatform.org/c/ml/ComputeLibrary/+/9908
Comments-Addressed: Arm Jenkins <bsgcomp@arm.com>
Benchmark: Arm Jenkins <bsgcomp@arm.com>
Tested-by: Arm Jenkins <bsgcomp@arm.com>
Reviewed-by: Gunes Bayir <gunes.bayir@arm.com>
Reviewed-by: Jakub Sujak <jakub.sujak@arm.com>

1 files changed, 70 insertions, 0 deletions

diff --git a/compute_kernel_writer/src/cl/CLTensorArgument.h b/compute_kernel_writer/src/cl/CLTensorArgument.h
new file mode 100644
index 0000000000..cd924846c5
--- /dev/null
+++ b/compute_kernel_writer/src/cl/CLTensorArgument.h
@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2023 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.
+ */
+#ifndef CKW_SRC_CL_CLTENSORARGUMENT_H
+#define CKW_SRC_CL_CLTENSORARGUMENT_H
+
+#include "src/ITensorArgument.h"
+
+#include <string>
+#include <vector>
+
+namespace ckw
+{
+// Forward declarations
+class TensorInfo;
+
+/** OpenCL specific tensor argument
+ *  Internally, the object keeps track of the components and storages used to minimize the number
+ *  of kernel arguments required. Therefore, if we create this object but we do not access any components
+ *  or storages, the storages() and components() method will return an empty list.
+*/
+class CLTensorArgument : public ITensorArgument, ITensorStorageArgument, ITensorComponentArgument
+{
+public:
+    /** Constructor
+     *
+     * @param[in] name                 Tensor name
+     * @param[in] info                 Tensor info
+     * @param[in] return_dims_by_value Flag to return the dimensions by value whenever it is possible.
+     *                                 True, if the dimensions should be returned as value instead as variable.
+    */
+    CLTensorArgument(const std::string &name, const TensorInfo &info, bool return_dims_by_value);
+
+    // Inherited method overridden
+    TensorStorageVariable              storage(TensorStorageType x);
+    TileVariable                       component(TensorComponentType x);
+    std::vector<TensorStorageVariable> storages() const;
+    std::vector<TileVariable>          components() const;
+
+private:
+    std::string create_storage_name(TensorStorageType x) const;
+    std::string create_component_name(TensorComponentType x) const;
+
+    bool                             _return_dims_by_value{ false };
+    std::vector<TensorStorageType>       _storages_used{};
+    std::vector<TensorComponentType> _components_used{};
+};
+} // namespace ckw
+
+#endif // CKW_SRC_CL_CLTENSORARGUMENT_H