Struct MapLinearWithDim 

pub struct MapLinearWithDim<const N: usize = 3> { /* private fields */ }

Linear mapping for 1D array. N is the number of thread dimensions. width is the chunking window. The array is divided into chunks along threads until all elements are covered.

Examples

Given: bdim = (x=4, y=1, z=1) gdim = (x=1, y=1, z=1) arr: [T; 8] width = 2

With width = 2, the mapping assign two continuous elements to thread 0-3: [0, 0, 1, 1, 2, 2, 3, 3]

width = 1, the mapping assign two non-continuous elements to thread 0-3: [0, 1, 2, 3, 0, 1, 2, 3]

TODO: deprecate MapLinear and MapLinearWithDim in favor of reshape_map! macro.

Implementations

impl<const N: usize> MapLinearWithDim<N>

pub fn new(width: usize) -> Self

Trait Implementations

impl<const N: usize> Clone for MapLinearWithDim<N>

fn clone(&self) -> MapLinearWithDim<N>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<CS: ChunkScope> ScopeUniqueMap<CS> for MapLinearWithDim<3>

type IndexType = usize

type GlobalIndexType = usize

fn map( &self, idx: Self::IndexType, thread_ids: [u32; 6], ) -> (bool, Self::GlobalIndexType)

Returns the extra precondition of indexing operation and the global index. Without providing extra precondition, index will always check the OOB error with global idx.

fn precondition(&self) -> bool

impl<CS: ChunkScope> ScopeUniqueMap<CS> for MapLinearWithDim<1>

Safety

It is safe to use this mapping as long as the thread dimensions are properly configured.

type IndexType = usize

type GlobalIndexType = usize

fn precondition(&self) -> bool

fn map( &self, idx: Self::IndexType, thread_ids: [u32; 6], ) -> (bool, Self::GlobalIndexType)

Returns the extra precondition of indexing operation and the global index. Without providing extra precondition, index will always check the OOB error with global idx.

impl<CS: ChunkScope> ScopeUniqueMap<CS> for MapLinearWithDim<2>

type IndexType = usize

type GlobalIndexType = usize

fn precondition(&self) -> bool

fn map( &self, idx: Self::IndexType, thread_ids: [u32; 6], ) -> (bool, Self::GlobalIndexType)

Returns the extra precondition of indexing operation and the global index. Without providing extra precondition, index will always check the OOB error with global idx.

impl<const N: usize> Copy for MapLinearWithDim<N>