Struct DictionaryScoreRoutePlan 

pub struct DictionaryScoreRoutePlan {
    pub n_rows: usize,
    pub n_items: usize,
    pub feature_dim: usize,
    pub device_min_score_elems: usize,
    pub max_tile_score_elems: usize,
    pub tile_items: usize,
    pub tile_count: usize,
    pub device_admitted: bool,
    pub peak_score_bytes: usize,
    pub dot_flops_lower_bound: u128,
}

Device admission and tile geometry for one minibatch-by-dictionary score route.

Fields

n_rows: usize

Minibatch rows scored together.

n_items: usize

Candidate atoms/blocks scored for each row.

feature_dim: usize

Dot-product width for one score.

device_min_score_elems: usize

Minimum n_rows * n_items elements required for device admission.

max_tile_score_elems: usize

Maximum n_rows * tile_items score elements held by one device launch.

tile_items: usize

Candidate items per launch tile.

tile_count: usize

Number of candidate tiles covering 0..n_items.

device_admitted: bool

True when the total route work is large enough to use the device.

peak_score_bytes: usize

Peak score-block bytes for a full tile.

dot_flops_lower_bound: u128

Lower-bound arithmetic for dispatch diagnostics: one multiply and one add per (row, item, feature) score term.

Implementations

impl DictionaryScoreRoutePlan

pub fn with_limits( n_rows: usize, n_items: usize, feature_dim: usize, device_min_score_elems: usize, max_tile_score_elems: usize, ) -> Self

Build a plan with explicit thresholds. The function is pure and allocation-free so call sites can test routing decisions without a CUDA runtime.

pub fn default_for_shape( n_rows: usize, n_items: usize, feature_dim: usize, ) -> Self

Build a plan with the library defaults used by sparse dictionary routers.

pub const fn is_degenerate(self) -> bool

True when the plan covers no route work.

Trait Implementations

impl Clone for DictionaryScoreRoutePlan

fn clone(&self) -> DictionaryScoreRoutePlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DictionaryScoreRoutePlan

impl Debug for DictionaryScoreRoutePlan

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

Formats the value using the given formatter.

impl Eq for DictionaryScoreRoutePlan

impl PartialEq for DictionaryScoreRoutePlan

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DictionaryScoreRoutePlan