Struct ClusterDim 

pub struct ClusterDim {
    pub x: u32,
    pub y: u32,
    pub z: u32,
}

Cluster dimensions specifying how many thread blocks form one cluster.

Each dimension specifies the number of blocks in that direction of the cluster. The total number of blocks in a cluster is x * y * z.

Constraints

• All dimensions must be non-zero.
• The total blocks per cluster must not exceed the hardware limit (typically 8 or 16 for Hopper GPUs).
• The grid dimensions must be evenly divisible by the cluster dimensions.

Fields

x: u32

Number of blocks in the X dimension of the cluster.

y: u32

Number of blocks in the Y dimension of the cluster.

z: u32

Number of blocks in the Z dimension of the cluster.

Implementations

impl ClusterDim

pub fn new(x: u32, y: u32, z: u32) -> Self

Creates a new cluster dimension.

pub fn x(x: u32) -> Self

Creates a 1D cluster (only X dimension used).

pub fn xy(x: u32, y: u32) -> Self

Creates a 2D cluster.

pub fn total(&self) -> u32

Returns the total number of blocks per cluster.

Trait Implementations

impl Clone for ClusterDim

fn clone(&self) -> ClusterDim

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ClusterDim

impl Debug for ClusterDim

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ClusterDim

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ClusterDim

impl Hash for ClusterDim

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ClusterDim

fn eq(&self, other: &ClusterDim) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ClusterDim