Struct PlatformProfile 

pub struct PlatformProfile {
    pub logical_cores: usize,
    pub physical_cores: usize,
    pub cache_line_bytes: usize,
    pub l1_cache_bytes: usize,
    pub l2_cache_bytes: usize,
    pub has_avx2: bool,
    pub has_avx512: bool,
    pub has_neon: bool,
}

Platform characteristics detected at init time.

Captures hardware topology (core counts, cache hierarchy) and SIMD capability flags for the current CPU. Used to derive optimal parallelism thresholds and tiling parameters.

Fields

logical_cores: usize

Number of logical (hardware thread) cores.

physical_cores: usize

Number of physical cores (estimated; logical/2 on x86 HT, = logical on ARM).

cache_line_bytes: usize

Cache line size in bytes (typically 64 on modern CPUs).

l1_cache_bytes: usize

Estimated L1 data cache size per core in bytes.

l2_cache_bytes: usize

Estimated L2 cache size per core in bytes.

has_avx2: bool

Whether AVX2 (256-bit SIMD) is available (x86-64 only).

has_avx512: bool

Whether AVX-512 (512-bit SIMD) is available (x86-64 only).

has_neon: bool

Whether NEON (128-bit SIMD) is available (AArch64 only).

Implementations

impl PlatformProfile

pub fn detect() -> Self

Detect current platform capabilities.

Uses std::thread::available_parallelism() for core counts and compile-time/runtime feature detection for SIMD flags. Cache sizes are estimated from typical values for the detected architecture.

pub fn global() -> &'static PlatformProfile

Get the global cached platform profile (detected once, reused).

pub fn compute_thresholds(&self) -> TunedThresholds

Compute optimal thresholds for this platform.

The logic scales parallel thresholds inversely with core count (more cores => lower threshold to engage parallelism) and sizes tiled GEMM blocks to fit in L1 cache.

pub fn global_thresholds() -> &'static TunedThresholds

Get the global cached thresholds (computed once from the global profile).

pub fn with_cores(logical: usize, physical: usize) -> Self

Construct a profile with explicit values (useful for testing).

pub fn with_cache(l1_bytes: usize, l2_bytes: usize) -> Self

Construct a profile with custom cache sizes (useful for testing).

Trait Implementations

impl Clone for PlatformProfile

fn clone(&self) -> PlatformProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PlatformProfile

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

Formats the value using the given formatter.