/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-composable-kernel/checkouts/docs-6.4.3/include/ck/tensor_operation/gpu/block/blockwise_gemm_dlops_v2r2.hpp Source File

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-composable-kernel/checkouts/docs-6.4.3/include/ck/tensor_operation/gpu/block/blockwise_gemm_dlops_v2r2.hpp Source File#

Composable Kernel: /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-composable-kernel/checkouts/docs-6.4.3/include/ck/tensor_operation/gpu/block/blockwise_gemm_dlops_v2r2.hpp Source File
Go to the documentation of this file.
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2018-2023, Advanced Micro Devices, Inc. All rights reserved.
  
 #ifndef CK_BLOCKWISE_GEMM_DLOPS_V2R2_HPP
 #define CK_BLOCKWISE_GEMM_DLOPS_V2R2_HPP
  
 #include "common_header.hpp"
 #include "tensor_adaptor.hpp"
 #include "threadwise_tensor_slice_transfer.hpp"
 #include "threadwise_contraction_dlops.hpp"
  
 namespace ck {
  
 // C[M0, M1, N0, N1] += transpose(A[K, M0, M1]) * B[K, N0, N1]
 // A and B are visable to the whole block, C is distributed among each thread
 // Assume:
 //   1. A:
 //     1. AKMBlockDesc is known at compile-time
 //     2. ABlockBuffer is DynamicBuffer
 //   2. B:
 //     1. BKNBlockDesc is known at compile-time
 //     2. BBlockBuffer is DynamicBuffer
 //   3. C:
 //     1. CM0M1N0N1ThreadDesc is known at compile-time
 //     2. CThreadBuffer is StaticBuffer
 // Also assume:
 //   M0 = N0 = 2. It will do 2x2 pipelined read and fma (ABBA optimization)
 template <
     index_t BlockSize,
     typename FloatA,
     typename FloatB,
     typename FloatC,
     typename AKMBlockDesc,
     typename BKNBlockDesc,
     index_t M1PerThreadM11,
     index_t N1PerThreadN11,
     index_t KPerThread,
     index_t M1N1ThreadClusterM100,
     index_t M1N1ThreadClusterN100,
     index_t M1N1ThreadClusterM101,
     index_t M1N1ThreadClusterN101,
     index_t AThreadCopyScalarPerVector_M11,
     index_t BThreadCopyScalarPerVector_N11,
     typename enable_if<AKMBlockDesc::IsKnownAtCompileTime() && BKNBlockDesc::IsKnownAtCompileTime(),
                        bool>::type = false>
 struct BlockwiseGemmDlops_km_kn_m0m1n0n1_v2r2_pipeline_2x2
 {
     using AIndex = MultiIndex<3>;
     using BIndex = MultiIndex<3>;
     using CIndex = MultiIndex<4>;
  
     static constexpr auto I0 = Number<0>{};
     static constexpr auto I1 = Number<1>{};
     static constexpr auto I2 = Number<2>{};
     static constexpr auto I3 = Number<3>{};
  
     static constexpr index_t K = AKMBlockDesc{}.GetLength(I0);
     static constexpr index_t M = AKMBlockDesc{}.GetLength(I1);
     static constexpr index_t N = BKNBlockDesc{}.GetLength(I1);
  
     static constexpr index_t M100 = M1N1ThreadClusterM100;
     static constexpr index_t N100 = M1N1ThreadClusterN100;
  
     static constexpr index_t M101 = M1N1ThreadClusterM101;
     static constexpr index_t N101 = M1N1ThreadClusterN101;
  
     static constexpr index_t M11 = M1PerThreadM11;
     static constexpr index_t N11 = N1PerThreadN11;
  
     static constexpr index_t M1 = M1N1ThreadClusterM100 * M1N1ThreadClusterM101 * M1PerThreadM11;
     static constexpr index_t N1 = M1N1ThreadClusterN100 * M1N1ThreadClusterN101 * N1PerThreadN11;
  
     static constexpr index_t M0 = M / M1;
     static constexpr index_t N0 = N / N1;
  
     __host__ __device__ static constexpr auto
     MakeAKM0M1BlockDescriptor(const AKMBlockDesc& /* a_k_m_block_desc */)
     {
         const auto a_k_m0_m1_block_desc = transform_tensor_descriptor(
             AKMBlockDesc{},
             make_tuple(make_pass_through_transform(Number<K>{}),
                        make_unmerge_transform(make_tuple(Number<M0>{}, Number<M1>{}))),
             make_tuple(Sequence<0>{}, Sequence<1>{}),
             make_tuple(Sequence<0>{}, Sequence<1, 2>{}));
  
         return a_k_m0_m1_block_desc;
     }
  
     __host__ __device__ static constexpr auto
     MakeBKN0N1BlockDescriptor(const BKNBlockDesc& /* b_k_n_block_desc */)
     {
         const auto b_k_n0_n1_block_desc = transform_tensor_descriptor(
             BKNBlockDesc{},
             make_tuple(make_pass_through_transform(Number<K>{}),
                        make_unmerge_transform(make_tuple(Number<N0>{}, Number<N1>{}))),
             make_tuple(Sequence<0>{}, Sequence<1>{}),
             make_tuple(Sequence<0>{}, Sequence<1, 2>{}));
  
         return b_k_n0_n1_block_desc;
     }
  
     __host__ __device__ static constexpr auto MakeCM0M100M101M11N0N100N101N11ToMNBlockAdaptor()
     {
         // upper: [M0, M100, M101, M11, N0, N100, N101, N11]
         // lower: [M, N]
         constexpr auto c_m0_m100_m101_m11_n0_n100_n101_n11_to_m_n_block_adaptor =
             make_single_stage_tensor_adaptor(
                 make_tuple(make_unmerge_transform(make_tuple(
                                Number<M0>{}, Number<M100>{}, Number<M101>{}, Number<M11>{})),
                            make_unmerge_transform(make_tuple(
                                Number<N0>{}, Number<N100>{}, Number<N101>{}, Number<N11>{}))),
                 make_tuple(Sequence<0>{}, Sequence<1>{}),
                 make_tuple(Sequence<0, 1, 2, 3>{}, Sequence<4, 5, 6, 7>{}));
  
         return c_m0_m100_m101_m11_n0_n100_n101_n11_to_m_n_block_adaptor;
     }
  
     __host__ __device__ static constexpr auto
     MakeCM0M100M101M11N0N100N101N11ToM0M1N0N1BlockAdaptor()
     {
         // upper: [M0, M100, M101, M11, N0, N100, N101, N11]
         // lower: [M0, M1, N0, N1]
         constexpr auto c_m0_m100_m101_m11_n0_n100_n101_n11_to_m0_m1_n0_n1_block_adaptor =
             make_single_stage_tensor_adaptor(
                 make_tuple(make_pass_through_transform(Number<M0>{}),
                            make_unmerge_transform(
                                make_tuple(Number<M100>{}, Number<M101>{}, Number<M11>{})),
                            make_pass_through_transform(Number<N0>{}),
                            make_unmerge_transform(
                                make_tuple(Number<N100>{}, Number<N101>{}, Number<N11>{}))),
                 make_tuple(Sequence<0>{}, Sequence<1>{}, Sequence<2>{}, Sequence<3>{}),
                 make_tuple(Sequence<0>{}, Sequence<1, 2, 3>{}, Sequence<4>{}, Sequence<5, 6, 7>{}));
  
         return c_m0_m100_m101_m11_n0_n100_n101_n11_to_m0_m1_n0_n1_block_adaptor;
     }
  
     __host__ __device__ static constexpr auto GetCM0M1N0N1ThreadTensorLengths()
     {
         return Sequence<M0, M11, N0, N11>{};
     }
  
     static constexpr auto a_k_m0_m1_block_desc_ = MakeAKM0M1BlockDescriptor(AKMBlockDesc{});
     static constexpr auto b_k_n0_n1_block_desc_ = MakeBKN0N1BlockDescriptor(BKNBlockDesc{});
  
     public:
     __device__ BlockwiseGemmDlops_km_kn_m0m1n0n1_v2r2_pipeline_2x2()
         : c_thread_origin_data_idx_{CalculateCM0M1N0N1ThreadOriginOnBlock(
               get_thread_local_1d_id())},
           a_thread_copy_{
               make_tuple(0, c_thread_origin_data_idx_[I0], c_thread_origin_data_idx_[I1])},
           b_thread_copy_{
               make_tuple(0, c_thread_origin_data_idx_[I2], c_thread_origin_data_idx_[I3])}
     {
         static_assert(AKMBlockDesc::IsKnownAtCompileTime() && BKNBlockDesc::IsKnownAtCompileTime(),
                       "wrong! Desc should be known at compile-time");
  
         static_assert(BlockSize == M101 * M100 * N101 * N100,
                       "wrong! blocksize and cluster size not consistent");
  
         static_assert(M % M1 == 0 && N % N1 == 0, "wrong!");
  
         static_assert(AKMBlockDesc{}.GetLength(I0) == BKNBlockDesc{}.GetLength(I0),
                       "wrong! K dimension not consistent");
  
         // TODO: remove this restriction
         static_assert(M0 == 2 && N0 == 2, "wrong");
     }
  
     __device__ static CIndex CalculateCM0M1N0N1ThreadOriginOnBlock(index_t thread_id)
     {
         // lower: [M0, M1, N0, N1]
         // upper: [M0, M100, M101, M11, N0, N100, N101, N11]
         constexpr auto adaptor0 = MakeCM0M100M101M11N0N100N101N11ToM0M1N0N1BlockAdaptor();
  
         // lower: [M0, M100, M101, M11, N0, N100, N101, N11]
         // upper: [Tid, M0, M11, N0, N11]
         constexpr auto adaptor1 = make_single_stage_tensor_adaptor(
             make_tuple(make_merge_transform(make_tuple(M100, N100, M101, N101)),
                        make_pass_through_transform(M0),
                        make_pass_through_transform(M11),
                        make_pass_through_transform(N0),
                        make_pass_through_transform(N11)),
             make_tuple(
                 Sequence<1, 5, 2, 6>{}, Sequence<0>{}, Sequence<3>{}, Sequence<4>{}, Sequence<7>{}),
             make_tuple(Sequence<0>{}, Sequence<1>{}, Sequence<2>{}, Sequence<3>{}, Sequence<4>{}));
  
         constexpr auto adaptor = chain_tensor_adaptors(adaptor0, adaptor1);
  
         return adaptor.CalculateBottomIndex(make_multi_index(thread_id, 0, 0, 0, 0));
     }
  
     __host__ __device__ static constexpr index_t GetABlockAlignment() { return M1PerThreadM11; }
  
     __host__ __device__ static constexpr auto GetBBlockAlignment() { return N1PerThreadN11; }
  
     template <typename CM0M1N0N1ThreadDesc,
               typename ABlockBuffer,
               typename BBlockBuffer,
               typename CThreadBuffer>
     __device__ void Run(const CM0M1N0N1ThreadDesc& /* c_m0_m1_n0_n1_thread_desc */,
                         const ABlockBuffer& a_block_buf,
                         const BBlockBuffer& b_block_buf,
                         CThreadBuffer& c_thread_buf) const
     {
         static_assert(CM0M1N0N1ThreadDesc::IsKnownAtCompileTime(),
                       "wrong! Desc should be known at compile-time");
  
         // TODO: remove this restriction
         static_assert(M0 == 2 && N0 == 2 && CM0M1N0N1ThreadDesc{}.GetLength(I0) == M0 &&
                           CM0M1N0N1ThreadDesc{}.GetLength(I2) == N0,
                       "wrong");
  
         auto a_thread_buf = make_static_buffer<AddressSpaceEnum::Vgpr, FloatA>(
             a_k_m0_m1_thread_desc_.GetElementSpaceSize());
         auto b_thread_buf = make_static_buffer<AddressSpaceEnum::Vgpr, FloatB>(
             b_k_n0_n1_thread_desc_.GetElementSpaceSize());
  
         constexpr auto threadwise_gemm =
             ThreadwiseGemmDlops_km0m1_kn0n1_m0m1n0n1<FloatA,
                                                      FloatB,
                                                      FloatC,
                                                      decltype(a_k_m0_m1_thread_desc_),
                                                      decltype(b_k_n0_n1_thread_desc_),
                                                      CM0M1N0N1ThreadDesc,
                                                      Sequence<KPerThread>,
                                                      Sequence<1, M1PerThreadM11>,
                                                      Sequence<1, N1PerThreadN11>>{};
  
         // read A_sub_0
         a_thread_copy_.Run(a_k_m0_m1_block_desc_,
                            make_tuple(I0, I0, I0),
                            a_block_buf,
                            a_k_m0_m1_thread_desc_,
                            make_tuple(I0, I0, I0),
                            a_thread_buf);
  
         // read B_sub_0
         b_thread_copy_.Run(b_k_n0_n1_block_desc_,
                            make_tuple(I0, I0, I0),
                            b_block_buf,
                            b_k_n0_n1_thread_desc_,
                            make_tuple(I0, I0, I0),
                            b_thread_buf);
  
         // read B_sub_1
         b_thread_copy_.Run(b_k_n0_n1_block_desc_,
                            make_tuple(I0, I1, I0),
                            b_block_buf,
                            b_k_n0_n1_thread_desc_,
                            make_tuple(I0, I1, I0),
                            b_thread_buf);
  
         // read A_sub_1
         a_thread_copy_.Run(a_k_m0_m1_block_desc_,
                            make_tuple(I0, I1, I0),
                            a_block_buf,
                            a_k_m0_m1_thread_desc_,
                            make_tuple(I0, I1, I0),
                            a_thread_buf);
  
         // C_sub_00 += transpose(A_sub_0) * B_sub_0
         threadwise_gemm.Run(a_thread_buf,
                             make_tuple(I0, I0, I0),
                             b_thread_buf,
                             make_tuple(I0, I0, I0),
                             c_thread_buf,
                             make_tuple(I0, I0, I0, I0));
  
         // C_sub_01 += transpose(A_sub_0) * B_sub_1
         threadwise_gemm.Run(a_thread_buf,
                             make_tuple(I0, I0, I0),
                             b_thread_buf,
                             make_tuple(I0, I1, I0),
                             c_thread_buf,
                             make_tuple(I0, I0, I1, I0));
  
         // loop over rest of k
         static_for<KPerThread, K, KPerThread>{}([&](auto k) {
             // read A_sub_0
             a_thread_copy_.Run(a_k_m0_m1_block_desc_,
                                make_tuple(k, I0, I0),
                                a_block_buf,
                                a_k_m0_m1_thread_desc_,
                                make_tuple(I0, I0, I0),
                                a_thread_buf);
  
             // C_sub_10 += transpose(A_sub_1) * B_sub_0
             threadwise_gemm.Run(a_thread_buf,
                                 make_tuple(I0, I1, I0),
                                 b_thread_buf,
                                 make_tuple(I0, I0, I0),
                                 c_thread_buf,
                                 make_tuple(I1, I0, I0, I0));
  
             // read B_sub_0
             b_thread_copy_.Run(b_k_n0_n1_block_desc_,
                                make_tuple(k, I0, I0),
                                b_block_buf,
                                b_k_n0_n1_thread_desc_,
                                make_tuple(I0, I0, I0),
                                b_thread_buf);
  
             // C_sub_11 += transpose(A_sub_1) * B_sub_1
             threadwise_gemm.Run(a_thread_buf,
                                 make_tuple(I0, I1, I0),
                                 b_thread_buf,
                                 make_tuple(I0, I1, I0),
                                 c_thread_buf,
                                 make_tuple(I1, I0, I1, I0));
  
             // read B_sub_1
             b_thread_copy_.Run(b_k_n0_n1_block_desc_,
                                make_tuple(k, I1, I0),
                                b_block_buf,
                                b_k_n0_n1_thread_desc_,
                                make_tuple(I0, I1, I0),
                                b_thread_buf);
  
             // read A_sub_1
             a_thread_copy_.Run(a_k_m0_m1_block_desc_,
                                make_tuple(k, I1, I0),
                                a_block_buf,
                                a_k_m0_m1_thread_desc_,
                                make_tuple(I0, I1, I0),
                                a_thread_buf);
  
             // C_sub_00 += transpose(A_sub_0) * B_sub_0
             threadwise_gemm.Run(a_thread_buf,
                                 make_tuple(I0, I0, I0),
                                 b_thread_buf,
                                 make_tuple(I0, I0, I0),
                                 c_thread_buf,
                                 make_tuple(I0, I0, I0, I0));
  
             // C_sub_01 += transpose(A_sub_0) * B_sub_1
             threadwise_gemm.Run(a_thread_buf,
                                 make_tuple(I0, I0, I0),
                                 b_thread_buf,
                                 make_tuple(I0, I1, I0),
                                 c_thread_buf,
                                 make_tuple(I0, I0, I1, I0));
         });
  
         // C_sub_10 += transpose(A_sub_1) * B_sub_0
         threadwise_gemm.Run(a_thread_buf,
                             make_tuple(I0, I1, I0),
                             b_thread_buf,
                             make_tuple(I0, I0, I0),
                             c_thread_buf,
                             make_tuple(I1, I0, I0, I0));
  
         // C_sub_11 += transpose(A_sub_1) * B_sub_1
         threadwise_gemm.Run(a_thread_buf,
                             make_tuple(I0, I1, I0),
                             b_thread_buf,
                             make_tuple(I0, I1, I0),
                             c_thread_buf,
                             make_tuple(I1, I0, I1, I0));
     }
  
     private:
     // A[K, M0, M1]
     static constexpr auto a_k_m0_m1_thread_desc_ = make_naive_tensor_descriptor_packed(
         make_tuple(Number<KPerThread>{}, Number<M0>{}, Number<M1PerThreadM11>{}));
  
     // B[K, N0, N1]
     static constexpr auto b_k_n0_n1_thread_desc_ = make_naive_tensor_descriptor_packed(
         make_tuple(Number<KPerThread>{}, Number<N0>{}, Number<N1PerThreadN11>{}));
  
     using AThreadCopy = ThreadwiseTensorSliceTransfer_v4<FloatA,
                                                          FloatA,
                                                          decltype(a_k_m0_m1_block_desc_),
                                                          decltype(a_k_m0_m1_thread_desc_),
                                                          Sequence<KPerThread, 1, M1PerThreadM11>,
                                                          Sequence<0, 1, 2>,
                                                          2,
                                                          AThreadCopyScalarPerVector_M11,
                                                          1>;
  
     using BThreadCopy = ThreadwiseTensorSliceTransfer_v4<FloatB,
                                                          FloatB,
                                                          decltype(b_k_n0_n1_block_desc_),
                                                          decltype(b_k_n0_n1_thread_desc_),
                                                          Sequence<KPerThread, 1, N1PerThreadN11>,
                                                          Sequence<0, 1, 2>,
                                                          2,
                                                          BThreadCopyScalarPerVector_N11,
                                                          1>;
  
     CIndex c_thread_origin_data_idx_;
  
     AThreadCopy a_thread_copy_;
     BThreadCopy b_thread_copy_;
 };
  
 } // namespace ck
 #endif