/* * Copyright (c) 2023-2024 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. */ #include "arm_compute/dynamic_fusion/sketch/gpu/operators/GpuMatMul.h" #include "arm_compute/core/KernelDescriptors.h" #include "arm_compute/core/utils/misc/ShapeCalculator.h" #include "arm_compute/core/Validate.h" #include "arm_compute/runtime/CL/CLScheduler.h" #include "src/common/utils/Log.h" #include "src/core/helpers/AutoConfiguration.h" #include "src/dynamic_fusion/sketch/ArgumentPack.h" #include "src/dynamic_fusion/sketch/gpu/components/cl/ClComponentMatMul.h" #include "src/dynamic_fusion/sketch/gpu/GpuWorkloadSketchImpl.h" namespace arm_compute { namespace experimental { namespace dynamic_fusion { namespace { void calculate_and_init_dst_if_empty(ITensorInfo *dst, const ITensorInfo *lhs, const ITensorInfo *rhs, const MatMulAttributes &attributes, const GpuMatMulSettings &settings) { ARM_COMPUTE_UNUSED(attributes); if (dst->total_size() == 0U) { const auto dst_shape = misc::shape_calculator::compute_matmul_shape( lhs->tensor_shape(), rhs->tensor_shape(), MatMulKernelInfo(attributes.adj_lhs(), attributes.adj_rhs(), settings.m0(), settings.n0(), settings.k0())); auto_init_if_empty(*dst, lhs->clone()->set_tensor_shape(dst_shape)); } } /* A helper method to reduce the duplication in dst tensor initialization * when calling validate() */ Status is_supported_op_helper(const GpuWorkloadContext &context, const ITensorInfo *lhs, const ITensorInfo *rhs, const ITensorInfo *dst, const MatMulAttributes &attributes, const GpuMatMulSettings &settings) { ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(lhs, rhs); TensorInfo dst_info_to_validate; const ITensorInfo *dst_info_to_validate_ptr = &dst_info_to_validate; if (dst != nullptr) { dst_info_to_validate_ptr = dst; } calculate_and_init_dst_if_empty(&dst_info_to_validate, lhs, rhs, attributes, settings); // Check support level // Data type ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(lhs, 1, DataType::F16, DataType::F32); // Check components if (context.gpu_language() == GpuLanguage::OpenCL) { const auto cl_compile_ctx = context.cl_compile_context(); ARM_COMPUTE_RETURN_ERROR_ON(cl_compile_ctx == nullptr); // Validate MatMul Component { const auto properties = IGpuKernelComponent::Properties().stage(UnitWorkloadStage{UnitWorkloadStage::Stage::Run}); ArgumentPack arguments; arguments.add_const_tensor(ACL_SRC_0, lhs); arguments.add_const_tensor(ACL_SRC_1, rhs); arguments.add_const_tensor(ACL_DST_0, dst_info_to_validate_ptr); ARM_COMPUTE_RETURN_ON_ERROR(ClComponentMatMul::validate(properties, arguments, attributes, settings)); } } else { ARM_COMPUTE_RETURN_ERROR_MSG("Unimplemented Gpu language"); } return Status{}; } constexpr GpuOperatorType operator_type = GpuOperatorType::Complex; } // namespace int GpuMatMulSettings::n0() const { return _n0; } GpuMatMulSettings &GpuMatMulSettings::n0(int n0) { _n0 = n0; return *this; } int GpuMatMulSettings::m0() const { return _m0; } GpuMatMulSettings &GpuMatMulSettings::m0(int m0) { _m0 = m0; return *this; } int GpuMatMulSettings::k0() const { return _k0; } GpuMatMulSettings &GpuMatMulSettings::k0(int k0) { _k0 = k0; return *this; } Status GpuMatMul::is_supported_op(const GpuWorkloadContext &context, const ITensorInfo *lhs, const ITensorInfo *rhs, const MatMulAttributes &attributes, const GpuMatMulSettings &settings) { return is_supported_op_helper(context, lhs, rhs, nullptr, attributes, settings); } Status GpuMatMul::validate_op(const GpuWorkloadSketch &sketch, const ITensorInfo *lhs, const ITensorInfo *rhs, const MatMulAttributes &attributes, const GpuMatMulSettings &settings) { ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(lhs, rhs); // Check if tensors have valid id. I.e. they are created from a sketch ARM_COMPUTE_RETURN_ERROR_ON(!lhs->has_valid_id() || !rhs->has_valid_id()); // Refer to GpuMatmul::validate_op() for id-validness of this TensorInfo object TensorInfo dst_info_to_validate; // Auto initialize dst tensor info calculate_and_init_dst_if_empty(&dst_info_to_validate, lhs, rhs, attributes, settings); // Perform fusion test // Check if operator meets fusion constraints ArgumentPack tensors; tensors.add_const_tensor(ACL_SRC_0, lhs); tensors.add_const_tensor(ACL_SRC_1, rhs); tensors.add_const_tensor(ACL_DST_0, &dst_info_to_validate); const auto op = sketch.implementation().operator_group().new_operator(operator_type, tensors); ARM_COMPUTE_RETURN_ERROR_ON_MSG(!sketch.implementation().operator_group().try_add_operator(op), "Operator fusion test failed. This operator cannot be fused into the workload"); // Check if configuration is supported return is_supported_op_helper(*sketch.gpu_context(), lhs, rhs, &dst_info_to_validate, attributes, settings); } ITensorInfo *GpuMatMul::create_op(GpuWorkloadSketch &sketch, ITensorInfo *lhs, ITensorInfo *rhs, const Attributes &attributes, const Settings &settings) { ARM_COMPUTE_LOG_PARAMS(lhs, rhs, attributes, settings); ITensorInfo *dst = sketch.implementation().create_virtual_tensor(); // Assert validation ARM_COMPUTE_ERROR_THROW_ON(GpuMatMul::validate_op(sketch, lhs, rhs, attributes, settings)); ARM_COMPUTE_ERROR_ON_NULLPTR(lhs, rhs, dst); // Auto initialize dst tensor calculate_and_init_dst_if_empty(dst, lhs, rhs, attributes, settings); // Translate into components and add to component graph auto &comp_graph = sketch.implementation().component_graph(); const auto sketch_ctx = sketch.implementation().context(); if (sketch_ctx->gpu_language() == GpuLanguage::OpenCL) { auto properties = IGpuKernelComponent::Properties(); properties.stage(UnitWorkloadStage{UnitWorkloadStage::Stage::Run}); ArgumentPack arguments; arguments.add_const_tensor(ACL_SRC_0, lhs); arguments.add_const_tensor(ACL_SRC_1, rhs); arguments.add_const_tensor(ACL_DST_0, dst); comp_graph.add_new_component(properties, arguments, attributes, settings); } else { ARM_COMPUTE_ERROR("Unimplemented Gpu language"); } // Set up fusion test by adding to the Operator Group // Note this has to be performed after all the components have been successfully added to the component graph // Pack tensor infos ArgumentPack tensors; tensors.add_const_tensor(ACL_SRC_0, lhs); tensors.add_const_tensor(ACL_SRC_1, rhs); tensors.add_const_tensor(ACL_DST_0, dst); const auto op = sketch.implementation().operator_group().new_operator(operator_type, tensors); sketch.implementation().operator_group().add_operator(op); return dst; } } // namespace dynamic_fusion } // namespace experimental } // namespace arm_compute