Struct ResidentSizingPolicy 

pub struct ResidentSizingPolicy { /* private fields */ }

Shared worker-grid sizing policy for megakernel dispatch.

This is the host-side policy surface for persistent worker counts, workgroup width, slot padding, and backend grid geometry.

Implementations

impl ResidentSizingPolicy

pub const fn standard() -> Self

Standard megakernel sizing policy used by built-in dispatch paths.

pub const fn from_scheduling(scheduling: SchedulingPolicy) -> Self

Build from a shared backend-neutral scheduling policy.

pub const fn default_worker_count(&self) -> u32

Default persistent worker workgroup count.

pub const fn worker_workgroup_size( &self, worker_count: u32, max_workgroup_size_x: u32, ) -> u32

Clamp a requested worker count into the legal workgroup x dimension.

pub const fn padded_slot_count( &self, slot_count: u32, workgroup_size_x: u32, ) -> u32

Round a logical slot count up to a whole worker workgroup.

pub const fn dispatch_grid_for( &self, worker_count: u32, queue_len: u32, max_workgroup_size_x: u32, ) -> [u32; 3]

Compute the backend dispatch grid for a logical queue length.

pub const fn default_worker_groups_from_limits( &self, max_compute_workgroups_per_dimension: u32, max_compute_invocations_per_workgroup: u32, ) -> u32

Compute a persistent-worker ceiling from adapter limits.

pub fn calculate_optimal_grid( &self, request: ResidentGridRequest, limits: ResidentGridLimits, ) -> Result<ResidentGridPlan, BackendError>

Resolve worker groups, workgroup width, slot padding, and dispatch grid.

Errors

Returns BackendError when adapter limits are malformed.

pub fn geometry_from_slots( &self, slot_count: u32, worker_count: u32, max_workgroup_size_x: u32, ) -> ResidentLaunchGeometry

Build geometry for an already-sized ring.

Trait Implementations

impl Clone for ResidentSizingPolicy

fn clone(&self) -> ResidentSizingPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ResidentSizingPolicy

impl Debug for ResidentSizingPolicy

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

Formats the value using the given formatter.

impl Default for ResidentSizingPolicy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ResidentSizingPolicy

impl Hash for ResidentSizingPolicy

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 ResidentSizingPolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ResidentSizingPolicy