/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-composable-kernel/checkouts/develop/include/ck_tile/ops/gemm/kernel/gemm_multi_d_kernel.hpp Source File

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-composable-kernel/checkouts/develop/include/ck_tile/ops/gemm/kernel/gemm_multi_d_kernel.hpp Source File#

Composable Kernel: /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-composable-kernel/checkouts/develop/include/ck_tile/ops/gemm/kernel/gemm_multi_d_kernel.hpp Source File
Go to the documentation of this file.
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2025, Advanced Micro Devices, Inc. All rights reserved.
  
 #pragma once
  
 #include <iostream>
 #include <string>
  
 #include "ck_tile/core.hpp"
 #include "ck_tile/ops/common.hpp"
 #include "ck_tile/host/concat.hpp"
 #include "ck_tile/host/kernel_launch.hpp"
 #include "ck_tile/host/stream_utils.hpp"
 #include "ck_tile/core/utility/env.hpp"
 #include "ck_tile/ops/gemm/kernel/universal_gemm_kernel.hpp"
 #include "ck_tile/core/utility/type_traits.hpp"
  
 namespace ck_tile {
  
 template <index_t NumDTensor = 1>
 struct GemmMultiDHostArgs
 {
     CK_TILE_HOST GemmMultiDHostArgs() = default;
     CK_TILE_HOST GemmMultiDHostArgs(const void* a_ptr_,
                                     const void* b_ptr_,
                                     const std::array<const void*, NumDTensor>& ds_ptr_,
                                     void* e_ptr_,
                                     index_t k_batch_,
                                     index_t M_,
                                     index_t N_,
                                     index_t K_,
                                     index_t stride_A_,
                                     index_t stride_B_,
                                     const std::array<index_t, NumDTensor>& stride_Ds_,
                                     index_t stride_E_)
         : a_ptr(a_ptr_),
           b_ptr(b_ptr_),
           ds_ptr(ds_ptr_),
           e_ptr(e_ptr_),
           M(M_),
           N(N_),
           K(K_),
           stride_A(stride_A_),
           stride_B(stride_B_),
           stride_Ds(stride_Ds_),
           stride_E(stride_E_),
           k_batch(k_batch_)
     {
     }
  
     const void* a_ptr;
     const void* b_ptr;
     const std::array<const void*, NumDTensor> ds_ptr;
     union
     {
         void* e_ptr;
         void* c_ptr;
     };
     index_t M;
     index_t N;
     index_t K;
     index_t stride_A;
     index_t stride_B;
     const std::array<index_t, NumDTensor> stride_Ds;
     union
     {
         index_t stride_E;
         index_t stride_C;
     };
  
     index_t k_batch;
 };
  
 template <typename TilePartitioner_, typename GemmPipeline_, typename EpiloguePipeline_>
 struct GemmKernelMultiD
 {
     using UniversalGemmKernel =
         UniversalGemmKernel<TilePartitioner_, GemmPipeline_, EpiloguePipeline_>;
     static constexpr index_t kBlockSize = UniversalGemmKernel::kBlockSize;
  
     using TilePartitioner  = remove_cvref_t<TilePartitioner_>;
     using GemmPipeline     = remove_cvref_t<GemmPipeline_>;
     using EpiloguePipeline = remove_cvref_t<EpiloguePipeline_>;
  
     using ALayout  = remove_cvref_t<typename GemmPipeline::ALayout>;
     using BLayout  = remove_cvref_t<typename GemmPipeline::BLayout>;
     using CLayout  = remove_cvref_t<typename GemmPipeline::CLayout>;
     using DsLayout = remove_cvref_t<typename EpiloguePipeline::DsLayout>;
  
     using ADataType  = remove_cvref_t<typename GemmPipeline::ADataType>;
     using BDataType  = remove_cvref_t<typename GemmPipeline::BDataType>;
     using EDataType  = remove_cvref_t<typename EpiloguePipeline::ODataType>;
     using DsDataType = remove_cvref_t<typename EpiloguePipeline::DsDataType>;
  
     static_assert(!is_detected<is_tuple, ALayout>::value &&
                       !is_detected<is_tuple, ADataType>::value,
                   "ALayout and ADataType must be scalars.");
  
     static_assert(!is_detected<is_tuple, BLayout>::value &&
                       !is_detected<is_tuple, BDataType>::value,
                   "BLayout and BDataType must be scalars.");
  
     static_assert(!is_detected<is_tuple, CLayout>::value &&
                       !is_detected<is_tuple, EDataType>::value,
                   "CLayout and EDataType must be scalars.");
  
     static_assert(is_detected<is_tuple, DsLayout>::value &&
                       is_detected<is_tuple, DsDataType>::value &&
                       DsLayout::size() == DsDataType::size() && DsLayout::size() > 0,
                   "DsLayout and DsDataType must be tuples and must have the same size.");
  
     static constexpr index_t NumATensor = 1;
     static constexpr index_t NumBTensor = 1;
     static constexpr index_t NumDTensor = DsDataType::size();
  
     CK_TILE_HOST static auto GetName() -> const std::string
     {
         return UniversalGemmKernel::GetName();
     }
  
     CK_TILE_HOST static constexpr auto GridSize(index_t M, index_t N, index_t KBatch) -> dim3
     {
         return UniversalGemmKernel::GridSize(M, N, KBatch);
     }
  
     CK_TILE_HOST static auto MaxOccupancyGridSize(const stream_config& s) -> dim3
     {
         return UniversalGemmKernel::MaxOccupancyGridSize(s);
     }
  
     CK_TILE_HOST static constexpr auto BlockSize() -> dim3
     {
         return UniversalGemmKernel::BlockSize();
     }
  
     CK_TILE_HOST static constexpr auto
     MakeKernelArgs(const GemmMultiDHostArgs<NumDTensor>& hostArgs) ->
         typename UniversalGemmKernel::KernelArgs
     {
         return UniversalGemmKernel::MakeKernelArgs(
             UniversalGemmHostArgs<NumATensor, NumBTensor, NumDTensor>({hostArgs.a_ptr},
                                                                       {hostArgs.b_ptr},
                                                                       hostArgs.ds_ptr,
                                                                       hostArgs.e_ptr,
                                                                       hostArgs.k_batch,
                                                                       hostArgs.M,
                                                                       hostArgs.N,
                                                                       hostArgs.K,
                                                                       {hostArgs.stride_A},
                                                                       {hostArgs.stride_B},
                                                                       hostArgs.stride_Ds,
                                                                       hostArgs.stride_E));
     }
  
     CK_TILE_HOST static auto
     IsSupportedArgument(const typename UniversalGemmKernel::KernelArgs& kargs) -> bool
     {
         // Currently MultiD kernel doesn't support k_batch > 1
         if(kargs.k_batch > 1)
         {
             return false;
         }
  
         return UniversalGemmKernel::IsSupportedArgument(kargs);
     }
  
     CK_TILE_DEVICE auto operator()(typename UniversalGemmKernel::KernelArgs kargs) const -> void
     {
         UniversalGemmKernel{}.template operator()(kargs);
     }
 };
 } // namespace ck_tile