Struct KMeans 

pub struct KMeans { /* private fields */ }

K-Means clustering kernel.

Implements Lloyd’s algorithm with K-Means++ initialization.

Implementations

impl KMeans

pub fn new() -> Self

Create a new K-Means kernel.

pub fn initialize(&self, data: DataMatrix, k: usize)

Initialize the kernel with data and k for Ring mode operations.

pub fn assign_step(&self) -> f64

Perform one E-step (assignment) on internal state. Returns the total inertia (sum of squared distances).

pub fn update_step(&self) -> f64

Perform one M-step (centroid update) on internal state. Returns the maximum centroid shift.

pub fn query_point(&self, point: &[f64]) -> (usize, f64)

Query the nearest cluster for a point.

pub fn current_iteration(&self) -> u32

Get current iteration count.

pub fn current_inertia(&self) -> f64

Get current inertia.

pub fn compute( data: &DataMatrix, k: usize, max_iterations: u32, tolerance: f64, ) -> ClusteringResult

Run K-Means clustering.

Arguments

• data - Input data matrix (n_samples x n_features)
• k - Number of clusters
• max_iterations - Maximum number of iterations
• tolerance - Convergence threshold for centroid movement

impl KMeans

K-Means batch kernel implementation.

pub async fn cluster_batch(&self, input: KMeansInput) -> Result<KMeansOutput>

Execute K-Means clustering as a batch operation.

Convenience method for batch clustering.

Trait Implementations

impl BatchKernel<KMeansInput, KMeansOutput> for KMeans

fn execute<'life0, 'async_trait>( &'life0 self, input: KMeansInput, ) -> Pin<Box<dyn Future<Output = Result<KMeansOutput>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the kernel with the given input.

fn validate_input(&self, _input: &I) -> Result<(), KernelError>

Validate the input before execution.

fn execute_with_context<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 ExecutionContext, input: I, ) -> Pin<Box<dyn Future<Output = Result<O, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, I: 'async_trait, Self: Sync + 'async_trait,

Execute the kernel with execution context.

fn execute_with_timeout<'life0, 'async_trait>( &'life0 self, input: I, timeout: Duration, ) -> Pin<Box<dyn Future<Output = Result<O, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, I: 'async_trait, Self: Sync + 'async_trait,

Execute the kernel with a timeout.

impl Clone for KMeans

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KMeans

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

Formats the value using the given formatter.

impl Default for KMeans

fn default() -> Self

Returns the “default value” for a type.

impl GpuKernel for KMeans

fn metadata(&self) -> &KernelMetadata

Returns the kernel metadata.

fn validate(&self) -> Result<(), KernelError>

Validate kernel configuration.

fn id(&self) -> &str

Returns the kernel ID.

fn requires_gpu_native(&self) -> bool

Returns true if this kernel requires GPU-native execution.

fn health_check(&self) -> HealthStatus

Perform a health check on this kernel.

fn shutdown(&self) -> Result<(), KernelError>

Graceful shutdown of the kernel.

fn refresh_config(&mut self, _config: &KernelConfig) -> Result<(), KernelError>

Refresh kernel configuration at runtime.

impl RingKernelHandler<K2KCentroidBroadcast, K2KCentroidBroadcastAck> for KMeans

RingKernelHandler for K2K centroid broadcast.

Receives new centroids broadcast from coordinator.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: K2KCentroidBroadcast, ) -> Pin<Box<dyn Future<Output = Result<K2KCentroidBroadcastAck>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn ring_shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

fn handle_secure<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 mut SecureRingContext<'life2, 'life3>, msg: M, ) -> Pin<Box<dyn Future<Output = Result<R, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, M: 'async_trait, R: 'async_trait, Self: Sync + 'async_trait,

Handle a message with security context.

impl RingKernelHandler<K2KKMeansSync, K2KKMeansSyncResponse> for KMeans

RingKernelHandler for K2K iteration sync.

Synchronizes distributed KMeans workers after each iteration. In a single-instance setting, validates iteration state and returns convergence status.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: K2KKMeansSync, ) -> Pin<Box<dyn Future<Output = Result<K2KKMeansSyncResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn ring_shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

fn handle_secure<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 mut SecureRingContext<'life2, 'life3>, msg: M, ) -> Pin<Box<dyn Future<Output = Result<R, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, M: 'async_trait, R: 'async_trait, Self: Sync + 'async_trait,

Handle a message with security context.

impl RingKernelHandler<K2KPartialCentroid, K2KCentroidAggregation> for KMeans

RingKernelHandler for K2K partial centroid updates.

Aggregates partial centroid contributions from distributed workers.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: K2KPartialCentroid, ) -> Pin<Box<dyn Future<Output = Result<K2KCentroidAggregation>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn ring_shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

fn handle_secure<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 mut SecureRingContext<'life2, 'life3>, msg: M, ) -> Pin<Box<dyn Future<Output = Result<R, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, M: 'async_trait, R: 'async_trait, Self: Sync + 'async_trait,

Handle a message with security context.

impl RingKernelHandler<KMeansAssignRing, KMeansAssignResponse> for KMeans

RingKernelHandler for KMeans assignment step (E-step).

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: KMeansAssignRing, ) -> Pin<Box<dyn Future<Output = Result<KMeansAssignResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn ring_shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

fn handle_secure<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 mut SecureRingContext<'life2, 'life3>, msg: M, ) -> Pin<Box<dyn Future<Output = Result<R, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, M: 'async_trait, R: 'async_trait, Self: Sync + 'async_trait,

Handle a message with security context.

impl RingKernelHandler<KMeansQueryRing, KMeansQueryResponse> for KMeans

RingKernelHandler for point queries.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: KMeansQueryRing, ) -> Pin<Box<dyn Future<Output = Result<KMeansQueryResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn ring_shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

fn handle_secure<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 mut SecureRingContext<'life2, 'life3>, msg: M, ) -> Pin<Box<dyn Future<Output = Result<R, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, M: 'async_trait, R: 'async_trait, Self: Sync + 'async_trait,

Handle a message with security context.

impl RingKernelHandler<KMeansUpdateRing, KMeansUpdateResponse> for KMeans

RingKernelHandler for KMeans update step (M-step).

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: KMeansUpdateRing, ) -> Pin<Box<dyn Future<Output = Result<KMeansUpdateResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn ring_shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

fn handle_secure<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 mut SecureRingContext<'life2, 'life3>, msg: M, ) -> Pin<Box<dyn Future<Output = Result<R, KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, M: 'async_trait, R: 'async_trait, Self: Sync + 'async_trait,

Handle a message with security context.