Struct PcaProjection 

pub struct PcaProjection { /* private fields */ }

Corpus-fitted projection via spherical PCA.

Finds the 3 principal directions of maximum angular variance in the embedding space, then projects new embeddings onto them. This preserves angular (cosine similarity) relationships as faithfully as possible in 3 dimensions.

Fitting: O(N·n·k·iters) where N=corpus size, n=dimension, k=3. Projection: O(n) per embedding.

Implementations

impl PcaProjection

pub fn fit(embeddings: &[Embedding], radial: RadialStrategy) -> Self

pub fn fit_default(embeddings: &[Embedding]) -> Self

pub fn with_volumetric(self, enabled: bool) -> Self

Enable volumetric mode: r comes from the PCA projection magnitude instead of the embedding magnitude. Points distribute through the full 3D volume rather than clustering on the sphere surface.

pub fn explained_variance_ratio(&self) -> f64

The fraction of total variance captured by the top-3 PCA components. A global quality metric for the projection — higher means less information lost.

Trait Implementations

impl Clone for PcaProjection

fn clone(&self) -> PcaProjection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Projection for PcaProjection

fn project(&self, embedding: &Embedding) -> SphericalPoint

fn project_rich(&self, embedding: &Embedding) -> ProjectedPoint

Project with rich metadata: certainty, intensity, projection magnitude.

fn dimensionality(&self) -> usize