Struct UmapConfig 

pub struct UmapConfig {
    pub n_neighbors: usize,
    pub n_epochs: usize,
    pub category_weight: f64,
    pub min_dist: f64,
    pub warm_start_anchor: f64,
    pub seed: u64,
}

Hyperparameters for UmapSphereProjection.

These are the tunable knobs exposed to the auto-tuner. Non-tunable constants (learning_rate, negative_sample_rate) stay at their canonical UMAP defaults inside [fit_projection_for_config].

Fields

n_neighbors: usize

k in the kNN graph (attractive term). Higher = more global structure.

n_epochs: usize

Adam optimization epochs. ~200 for corpora < 10k, ~400 for 50k+.

category_weight: f64

Weight on the category supervision term. 0.0 = unsupervised UMAP. Positive values pull same-category items together and push different-category items apart. 1.0–3.0 is typical.

min_dist: f64

How tightly neighbors may pack on the sphere. Larger values flatten the embedding kernel near zero, so clusters claim more territory — exactly what the territorial/cap-overlap metrics measure. 0.0 = near-maximal clumping; 0.1 is the canonical UMAP default.

warm_start_anchor: f64

Weight on an attractive pull toward each point’s PCA warm-start position; 0.0 disables. Use small values (~0.01–0.1) on sparse corpora whose kNN graphs fragment into disconnected components, to keep the components’ global arrangement from drifting under unopposed repulsion. Intentionally not a tuner axis — it is a data-pathology escape hatch, not a search dimension.

seed: u64

PRNG seed for negative sampling and tie-breaking.

Trait Implementations

impl Clone for UmapConfig

fn clone(&self) -> UmapConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UmapConfig

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

Formats the value using the given formatter.

impl Default for UmapConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UmapConfig

where UmapConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UmapConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.