Struct EmbeddingSpace 

pub struct EmbeddingSpace { /* private fields */ }

Metadata about an embedding space.

An embedding space defines the properties of embeddings stored within it:

• The dimension of vectors in the space
• The distance metric used for similarity search

Example

use manifoldb_vector::types::{EmbeddingName, EmbeddingSpace};
use manifoldb_vector::distance::DistanceMetric;

let name = EmbeddingName::new("text_embedding").unwrap();
let space = EmbeddingSpace::new(name, 384, DistanceMetric::Cosine);

assert_eq!(space.dimension(), 384);
assert_eq!(space.distance_metric(), DistanceMetric::Cosine);

Implementations

impl EmbeddingSpace

pub const fn new( name: EmbeddingName, dimension: usize, distance_metric: DistanceMetric, ) -> Self

Create a new embedding space.

pub fn name(&self) -> &EmbeddingName

Get the name of the embedding space.

pub fn dimension(&self) -> usize

Get the dimension of embeddings in this space.

pub fn distance_metric(&self) -> DistanceMetric

Get the distance metric used for similarity search.

pub fn to_bytes(&self) -> Result<Vec<u8>, VectorError>

Encode the embedding space to bytes.

Format:

• 1 byte: version
• 2 bytes: name length (big-endian u16)
• N bytes: name (UTF-8)
• 4 bytes: dimension (big-endian u32)
• 1 byte: distance metric

Errors

Returns an error if the name length exceeds u16::MAX or the dimension exceeds u32::MAX.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, VectorError>

Decode an embedding space from bytes.

Errors

Returns an error if the bytes are invalid or truncated.

Trait Implementations

impl Clone for EmbeddingSpace

fn clone(&self) -> EmbeddingSpace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbeddingSpace

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

Formats the value using the given formatter.

impl PartialEq for EmbeddingSpace

fn eq(&self, other: &EmbeddingSpace) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for EmbeddingSpace

impl StructuralPartialEq for EmbeddingSpace