# mypy: allow-untyped-defs import logging from typing import TYPE_CHECKING, Union import torch from torch._dynamo.utils import counters from torch._inductor.codegen.rocm.ck_universal_gemm_template import CKGemmTemplate from torch._inductor.kernel.mm_common import load_kernel_template from .. import config as inductor_config, ir, lowering as L from ..kernel_inputs import MMKernelInputs from ..lowering import lowerings, make_pointwise, make_reduction, transform_args from ..select_algorithm import ( autotune_select_algorithm, ExternKernelChoice, SymbolicGridFn, TritonTemplate, ) from ..utils import ( _use_cutlass_for_op, use_aten_gemm_kernels, use_ck_gemm_template, use_cpp_bmm_template, use_cutlass_template, use_nv_universal_gemm_template, use_triton_template, ) from ..virtualized import ops, V from .mm_common import ( _is_static_problem, is_batch_stride_largest_or_zero, mm_args, use_native_matmul, ) if TYPE_CHECKING: from ..ir import ChoiceCaller from ..select_algorithm import KernelTemplate log = logging.getLogger(__name__) aten = torch.ops.aten @SymbolicGridFn def bmm_grid(b, m, n, meta, *, cdiv): return (cdiv(m, meta["BLOCK_M"]) * cdiv(n, meta["BLOCK_N"]), b, 1) # We define each template kernel in a separate file which is the name of the input to load_kernel_template # (e.g. triton_bmm for templates/triton_bmm.py.jinja). # If you are adding a new template, please follow that pattern and add a new file with your implementation in the templates folder. bmm_template = TritonTemplate( name="bmm", grid=bmm_grid, source=load_kernel_template("triton_bmm"), cache_codegen_enabled_for_template=True, ) aten_bmm = ExternKernelChoice(torch.bmm, "at::bmm_out", op_overload=aten.bmm.out) aten_bmm_dtype = ExternKernelChoice( torch.bmm, "at::_bmm_out_dtype_xpu" if torch.xpu.is_available() else "at::_bmm_out_dtype_cuda", name="bmm_dtype", op_overload=aten.bmm.dtype_out, ) aten_baddbmm = ExternKernelChoice( torch.baddbmm, "at::baddbmm_out", op_overload=aten.baddbmm.out ) @L.register_lowering(aten.bmm) def tuned_bmm(mat1, mat2, out_dtype=None, *, layout=None): """ Lowering for autotuning aten.bmm with different backends (Aten, Triton, CUTLASS, etc.) """ if all(x.get_device().type == "cpu" for x in [mat1, mat2]): # decompose to small ops when memory bound if mat1.get_size()[1] == 1 or mat2.get_size()[2] == 1: mat1 = L.unsqueeze(mat1, -1) mat2 = L.unsqueeze(mat2, 1) return L.sum_(L.mul(mat1, mat2), axis=2) def is_valid_to_require_contiguous(t): if not ir.is_storage_and_layout(t): return True _, layout = ir.as_storage_and_layout(t, freeze=False) return isinstance(layout, ir.FlexibleLayout) def is_preferred_layout_as_bmm_input(sizes, strides): # contiguous on one of the last two dims return ( strides[-1] == 1 and (sizes[-2] == 1 or strides[-2] >= sizes[-1]) ) or (strides[-2] == 1 and (sizes[-1] == 1 or strides[-1] >= sizes[-2])) # Make the input of bmm contiguous # if it is not contiguous on either of the last two dims, # because bmm cpu implementation would do contiguous() if not. # This is to avoid additional copies in bmm. def may_require_contiguous(t, meta_t): sizes = meta_t.meta["val"].size() strides = meta_t.meta["val"].stride() if not is_preferred_layout_as_bmm_input(sizes, strides): t = ir.ExternKernel.require_contiguous(t) return t if is_valid_to_require_contiguous(mat1): meta_mat1 = V.graph.current_node.args[0] mat1 = may_require_contiguous(mat1, meta_mat1) if is_valid_to_require_contiguous(mat2): meta_mat2 = V.graph.current_node.args[1] mat2 = may_require_contiguous(mat2, meta_mat2) if use_native_matmul(mat1, mat2): mat1 = lowerings[aten.unsqueeze](mat1, -1) mat2 = lowerings[aten.unsqueeze](mat2, 1) args, kwargs = transform_args( args=[mat1, mat2], kwargs={}, broadcast=True, type_promotion_kind=None, convert_input_to_bool=False, ) # Handles broadcasting the arguments if inductor_config.triton.codegen_upcast_to_fp32 and mat1.dtype in [ torch.float16, torch.bfloat16, ]: def _to_dtype(x): return ops.to_dtype(x, mat1.dtype, use_compute_types=False) args = [make_pointwise(_to_dtype)(x) for x in args] mul_pointwise = make_pointwise(ops.dot)(*args) dot_reduction = make_reduction("dot")(mul_pointwise, 2) return dot_reduction # TODO(coconutruben): integrate into MMKernelInputs when all callsites use that m, n, k, layout, mat1, mat2 = mm_args( mat1, mat2, layout=layout, out_dtype=out_dtype ) name = "bmm" # Create MMKernelInputs for BMM at the top kernel_inputs = MMKernelInputs([mat1, mat2], out_dtype=out_dtype) # below is for getting an overview logging info of inductor mms batch_size = mat1.get_size()[0] # Extract batch dimension counters["aten_mm_info"][f"aten.bmm_{batch_size}_{m}_{n}_{k}"] += 1 log.info( "Tuned aten.bmm: batch=%s, m=%s, n=%s, k=%s, mat1_dtype=%s, mat2_dtype=%s, output_layout=%s", batch_size, m, n, k, mat1.get_dtype(), mat2.get_dtype(), layout, ) aten_handler: ExternKernelChoice = aten_bmm aten_extra_kwargs = {} if out_dtype: assert mat1.get_device().type in ("cuda", "xpu"), ( "out_dtype is only supported for CUDA or XPU" ) aten_handler = aten_bmm_dtype aten_extra_kwargs = {"out_dtype": out_dtype} choices: list[ChoiceCaller] = [] # Collect all templates for unified call templates_to_use: list[Union[ExternKernelChoice, KernelTemplate]] = [] kwarg_overrides = {} if use_aten_gemm_kernels(): templates_to_use.append(aten_handler) kwarg_overrides[aten_handler.uid] = aten_extra_kwargs if use_triton_template(layout, check_max_autotune=False) and ( out_dtype is None or out_dtype == mat1.get_dtype() ): # TODO: add out_dtype support for Triton Template templates_to_use.append(bmm_template) # Single unified call for all templates choices.extend( V.choices.get_template_configs( kernel_inputs, templates_to_use, name, kwarg_overrides=kwarg_overrides, ) ) _, is_nonzero = _is_static_problem(layout) batch_stride_largest_or_zero = is_batch_stride_largest_or_zero(mat1, mat2, layout) if ( batch_stride_largest_or_zero and is_nonzero and use_cutlass_template(layout, m, n, k) and _use_cutlass_for_op(name) ): from ..codegen.cutlass.gemm_template import CUTLASS3xGemmTemplate CUTLASS3xGemmTemplate.add_cutlass_gemm_choices( choices, layout, kernel_inputs.nodes() ) # type: ignore[arg-type] if use_cpp_bmm_template(layout, mat1, mat2): from ..codegen.cpp_bmm_template import CppBmmTemplate CppBmmTemplate.add_choices( choices, layout, kernel_inputs.nodes(), ) if use_ck_gemm_template(layout, m, n, k): CKGemmTemplate.add_ck_gemm_choices(choices, layout, kernel_inputs.nodes()) if is_nonzero and use_nv_universal_gemm_template(layout, m, n, k, mat1, mat2): from ..codegen.nv_universal_gemm import add_nv_universal_gemm_choices add_nv_universal_gemm_choices(choices, layout, kernel_inputs) return autotune_select_algorithm(name, choices, kernel_inputs.nodes(), layout) @L.register_lowering(aten.baddbmm) def tuned_baddbmm(inp, mat1, mat2, *, alpha=1, beta=1, layout=None): """ Lowering for autotuning aten.mm with different backends (Aten, Triton, CUTLASS, etc.) """ if use_native_matmul(mat1, mat2): if beta == 0: arg1 = 0 else: arg1 = lowerings[aten.mul](beta, inp) if alpha == 0: arg2 = 0 else: arg2 = lowerings[aten.mul](alpha, lowerings[aten.bmm](mat1, mat2)) return lowerings[aten.add](arg1, arg2) # TODO(coconutruben): integrate into MMKernelInputs when all callsites use that m, n, k, layout, mat1, mat2, inp = mm_args(mat1, mat2, inp, layout=layout) # Create MMKernelInputs for BadDBMM at the top kernel_inputs = MMKernelInputs( [inp, mat1, mat2], scalars=dict(alpha=alpha, beta=beta) ) # below is for getting an overview logging info of inductor mms batch_size = mat1.get_size()[0] counters["aten_mm_info"][f"aten.baddbmm_{batch_size}_{m}_{n}_{k}"] += 1 log.info( "Tuned aten.baddbmm: batch_size=%s, m=%s, n=%s, k=%s, mat1_dtype=%s, mat2_dtype=%s, inp=%s, output_layout=%s", batch_size, m, n, k, mat1.get_dtype(), mat2.get_dtype(), inp.get_dtype(), layout, ) name = "baddbmm" # options to tune from choices: list[ChoiceCaller] = [] # Collect all templates for unified call templates_to_use: list[Union[ExternKernelChoice, KernelTemplate]] = [] if use_aten_gemm_kernels(): templates_to_use.append(aten_baddbmm) if use_triton_template(layout, check_max_autotune=False): templates_to_use.append(bmm_template) # Single unified call for all templates choices.extend( V.choices.get_template_configs(kernel_inputs, templates_to_use, name) ) return autotune_select_algorithm(name, choices, kernel_inputs.nodes(), layout)