triton.language.multiple_of

triton.language.multiple_of(input, values, _semantic=None)

Let the compiler know that the values in input are all multiples of value.

Example

import pytest
import torch
import torch_npu
from torch.testing import assert_close

import triton
import triton.language as tl


@triton.jit
def multiple_of_kernel(x_ptr, out_ptr, BLOCK_SIZE: tl.constexpr):
    offsets = tl.arange(0, BLOCK_SIZE)
    # Declare that the offsets are multiples of BLOCK_SIZE
    offsets = tl.multiple_of(offsets, [BLOCK_SIZE])
    x = tl.load(x_ptr + offsets)
    tl.store(out_ptr + offsets, x * 2)


def test_multiple_of():
    BLOCK_SIZE = 128
    x = torch.randn(BLOCK_SIZE, device="npu", dtype=torch.float32)
    out = torch.empty(BLOCK_SIZE, device="npu", dtype=torch.float32)

    multiple_of_kernel[(1, )](x, out, BLOCK_SIZE=BLOCK_SIZE)
    torch.npu.synchronize()

    # multiple_of is only a compiler hint and does not change the result
    assert_close(out, x * 2, rtol=1e-3, atol=1e-3)


if __name__ == "__main__":
    test_multiple_of()
    print("test_multiple_of PASSED!")

Special Restrictions

• DataType: Ascend A2/A3 does not support uint16/uint32/uint64/fp64, Ascend 950 does not support fp64 (hardware limitation).

• values: describes the divisibility of the first value along each dimension, so its rank must match input (e.g. [1, 1] for a 2-D input).