Struct RandomRotation 

pub struct RandomRotation {
    pub dim: usize,
    pub matrix: Vec<f32>,
    /* private fields */
}

A random (approximately) orthogonal rotation.

Build once, apply many times. The default constructor random yields a Haar-uniform D×D matrix for backward compatibility; hadamard opts in to the O(D log D) HD-HD-HD variant.

Fields

dim: usize

matrix: Vec<f32>

Kept for backward compatibility with snapshots that accessed the raw matrix. Populated only for HaarDense; empty for Hadamard.

Implementations

impl RandomRotation

pub fn random(dim: usize, seed: u64) -> Self

Sample a Haar-uniform orthogonal matrix of size dim × dim.

Backward-compatible default: existing callers that expect a dense matrix under self.matrix keep working unchanged.

pub fn hadamard(dim: usize, seed: u64) -> Self

Construct a randomised Hadamard rotation D₁·H·D₂·H·D₃.

Stores only 3 × padded_dim ±1 entries — no matrix materialised. padded_dim is the next power of two ≥ dim; for dyadic dim it equals dim.

pub fn kind(&self) -> RandomRotationKind

Which construction backs this rotation.

pub fn apply(&self, v: &[f32]) -> Vec<f32>

Apply the rotation: out = P · v (length must equal dim).

pub fn apply_into(&self, v: &[f32], out: &mut [f32])

In-place variant that writes into a caller-provided buffer. Callers doing many rotations (hot query path) should reuse one Vec<f32> instead of allocating per call — saves one malloc per query in the ANN index’s encode_query_packed path.

pub fn bytes(&self) -> usize

Memory usage in bytes of the rotation’s internal storage.

Trait Implementations

impl Clone for RandomRotation

fn clone(&self) -> RandomRotation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'de> Deserialize<'de> for RandomRotation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RandomRotation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.