Struct ProjectedPoint 

pub struct ProjectedPoint {
    pub position: SphericalPoint,
    pub certainty: f64,
    pub intensity: f64,
    pub projection_magnitude: f64,
}

A projected point on the sphere with rich attributes from the projection.

Extends the raw SphericalPoint with metadata that captures how much information was preserved (or lost) during dimensionality reduction.

Fields

position: SphericalPoint

The spherical position (r, theta, phi).

certainty: f64

How well the 3D projection captures this point’s original direction. Computed as 1 - (residual / total variance). Range [0, 1]:

• 1.0: perfect reconstruction (all variance explained by 3 PCA components)
• 0.0: the projection lost everything

intensity: f64

Semantic strength of the original embedding (pre-normalization magnitude). Higher values indicate more specific/confident embeddings.

projection_magnitude: f64

Magnitude of the 3-component PCA projection before normalization. Points near the PCA centroid have low projection magnitude and are ambiguous — they don’t strongly align with any principal direction.

Implementations

impl ProjectedPoint

pub fn new( position: SphericalPoint, certainty: f64, intensity: f64, projection_magnitude: f64, ) -> Self

pub fn from_position(position: SphericalPoint, intensity: f64) -> Self

Create a basic projected point with no metadata (legacy compat).

Trait Implementations

impl Clone for ProjectedPoint

fn clone(&self) -> ProjectedPoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ProjectedPoint

impl Debug for ProjectedPoint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProjectedPoint

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProjectedPoint

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

where __S: Serializer,

Serialize this value into the given Serde serializer.