Struct EuOccupancyAdvisor 

pub struct EuOccupancyAdvisor { /* private fields */ }

Recommends a workgroup size from an EU-utilisation fraction.

When EUs are already busy (high utilisation) a smaller workgroup reduces per-launch pressure and improves overlap; when EUs are idle a larger workgroup maximises throughput. The advisor clamps recommendations to the device’s [min, max] workgroup-size envelope and to powers of two (Intel sub-group sizes are 8/16/32, so workgroup sizes are typically power-of-two multiples).

Implementations

impl EuOccupancyAdvisor

pub fn new(eu_count: u32, min_wg: u32, max_wg: u32) -> LevelZeroResult<Self>

Create an advisor for a device with eu_count execution units and a workgroup-size envelope of [min_wg, max_wg] (both powers of two).

pub fn eu_count(&self) -> u32

The device EU count.

pub fn recommend_workgroup_size(&self, utilisation: f64) -> u32

Recommend a workgroup size given the current EU-utilisation fraction.

utilisation is clamped to [0, 1]. At full idle (0.0) the advisor returns max_wg; at full saturation (1.0) it returns min_wg; intermediate utilisations interpolate geometrically (halving per quartile of busy-ness) and snap down to the nearest power of two within the envelope.

pub fn estimated_resident_workgroups( &self, workgroup_size: u32, subgroup_size: u32, ) -> u32

Estimate the number of concurrent workgroups the device can host for a given workgroup size, assuming one sub-group of subgroup_size per EU thread. This feeds the dispatch grid sizing.

Trait Implementations

impl Clone for EuOccupancyAdvisor

fn clone(&self) -> EuOccupancyAdvisor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EuOccupancyAdvisor

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

Formats the value using the given formatter.