Struct WeightRegionCatalog 

pub struct WeightRegionCatalog { /* private fields */ }

Validated expert-region catalog over a WeightRef in a WeightStore.

A pageable catalog guarantees that each expert is represented by one overflow-checked external byte range. The quantization metadata is retained so a kernel can decode one range without inspecting or materializing peers.

Implementations

impl WeightRegionCatalog

pub fn classify(weight: &WeightRef, layout: ExpertTensorLayout) -> Self

Classify a weight using an explicit model/package layout descriptor.

Invalid or non-expert-major layouts produce a non-pageable catalog rather than failing model load; callers must fall back to the resident path.

pub fn for_mapped_tensor_view( dtype: DataType, dims: &[usize], tensor_len: usize, layout: ExpertTensorLayout, ) -> Self

Build relative expert ranges for a tensor view that the caller has already established aliases an external mmap initializer.

This is the kernel-boundary counterpart to classify: it cannot re-borrow through WeightStore, but applies the same shape, layout, quantization, overflow, and isize::MAX validation.

pub fn pageability(&self) -> &Pageability

pub fn is_pageable(&self) -> bool

pub fn layout(&self) -> &ExpertTensorLayout

pub fn dtype(&self) -> DataType

pub fn path(&self) -> Option<&Path>

External-data path that supplied this catalog, when it is externally backed.

pub fn tensor_offset(&self) -> usize

Absolute byte offset of the tensor in its external-data mapping.

pub fn tensor_len(&self) -> usize

Canonical tensor byte length validated by this catalog.

pub fn mapped_bytes(&self) -> usize

pub fn region(&self, expert: usize) -> Option<&ExpertWeightRegion>

pub fn relative_range(&self, expert: usize) -> Option<Range<usize>>

pub fn expert_bytes<'a>( &self, store: &'a WeightStore, expert: usize, ) -> Option<&'a [u8]>

Borrow one expert directly from the live read-only mmap.

Trait Implementations

impl Clone for WeightRegionCatalog

fn clone(&self) -> WeightRegionCatalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WeightRegionCatalog

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

Formats the value using the given formatter.

impl Eq for WeightRegionCatalog

impl PartialEq for WeightRegionCatalog

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WeightRegionCatalog