Struct KSweepEntry 

pub struct KSweepEntry<F: BixverseFloat> {
    pub k: usize,
    pub stability: F,
    pub best_error: F,
    pub median_error: F,
    pub consensus_failed: bool,
    pub n_dropped: usize,
    pub n_empty_clusters: usize,
    pub n_converged: usize,
}

One row of the k sweep.

Fields

k: usize

The rank this row describes.

stability: F

Mean silhouette of the surviving components. Higher is more stable. NaN if the consensus step could not run at this k, which R reads as NA; see consensus_failed.

best_error: F

Loss of the best restart, divided by ||V||_F^2. Always populated, since it comes from the restarts rather than the consensus.

median_error: F

Median restart loss, divided by ||V||_F^2.

consensus_failed: bool

True if the density filter left fewer than k components, so the clustering never ran. The error columns are still meaningful; the stability one is not. Usually means the threshold is too tight for this k.

n_dropped: usize

Components dropped, whether collapsed or filtered out. A rising drop rate is itself a sign that k has gone past useful.

n_empty_clusters: usize

Clusters that ended up empty.

n_converged: usize

Restarts that met the HALS tolerance.

Trait Implementations

impl<F: Clone + BixverseFloat> Clone for KSweepEntry<F>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F: Debug + BixverseFloat> Debug for KSweepEntry<F>

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

Formats the value using the given formatter.