Enum RadialStrategy 

pub enum RadialStrategy {
    Fixed(f64),
    Magnitude,
    MagnitudeTransform(Arc<dyn Fn(f64) -> f64 + Send + Sync>),
    ProjectionMagnitude,
    Certainty {
        scale: f64,
    },
    Custom(Arc<dyn Fn(&RadialContext) -> f64 + Send + Sync>),
}

Controls how the radial coordinate r is computed from an embedding.

The angular coordinates (theta, phi) always encode semantic direction. The radial coordinate is free to encode magnitude, fidelity, or a caller-defined function of any per-point signal the projection exposes via RadialContext.

Variants

Fixed(f64)

Constant radius for all projections.

Magnitude

r = L2 magnitude of the raw (pre-normalization) embedding. Encodes embedding “confidence” or specificity. Degenerates to a constant when inputs are L2-normalized — pick one of the projection-side variants below in that case.

MagnitudeTransform(Arc<dyn Fn(f64) -> f64 + Send + Sync>)

r = f(embedding_magnitude). Apply a custom transform to the pre-normalization magnitude (e.g. log scaling, clamping).

ProjectionMagnitude

r = ‖(x, y, z)‖ — how much of the input variance landed in the projected 3-vector. Universal across all four projection families. Recommended starting point for normalized embeddings.

Certainty

r = scale * certainty, where certainty ∈ [0, 1] is the projection-supplied per-point fidelity score. Higher r ⇒ this point is well-explained by the 3D projection.

Fields

scale: f64

Custom(Arc<dyn Fn(&RadialContext) -> f64 + Send + Sync>)

r = f(&context). Escape hatch for arbitrary per-point logic over any combination of the RadialContext signals.

Implementations

impl RadialStrategy

pub fn compute_rich(&self, ctx: &RadialContext) -> f64

Resolve r against the full per-point context. All four projection families construct a RadialContext inline and call this.

pub fn compute(&self, magnitude: f64) -> f64

Backward-compatible shim. Use Self::compute_rich when projection-side context is available — the new ProjectionMagnitude, Certainty, and Custom variants only do something useful there.

Trait Implementations

impl Clone for RadialStrategy

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 RadialStrategy

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

Formats the value using the given formatter.

impl Default for RadialStrategy

fn default() -> RadialStrategy

Returns the “default value” for a type.