elid 0.4.24

Embedding Locality IDentifier - encode embeddings into sortable string IDs for vector search without vector stores, plus fast string similarity algorithms
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! Error types for ELID embedding operations

use thiserror::Error;

/// Errors that can occur during ELID embedding operations
#[derive(Debug, Error)]
pub enum ElidError {
    /// Embedding dimension is outside the valid range for the profile
    #[error("Invalid dimension: got {got}, expected range {expected_range:?}")]
    InvalidDimension {
        /// The actual dimension provided
        got: usize,
        /// The expected dimension range (min, max)
        expected_range: (usize, usize),
    },

    /// Embedding contains NaN or Inf values
    #[error("Invalid embedding value (NaN or Inf detected)")]
    InvalidValue,

    /// Invalid base32hex encoding in ID string
    #[error("Invalid base32hex encoding")]
    InvalidEncoding,

    /// Invalid or corrupted ID header
    #[error("Invalid ID header")]
    InvalidHeader,

    /// Hamming ball radius exceeds maximum allowed value (3)
    #[error("Hamming radius too large: {0} (max 3)")]
    RadiusTooLarge(u8),

    /// Profile in ID doesn't match expected profile
    #[error("Profile mismatch: expected {expected}, got {got}")]
    ProfileMismatch {
        /// The expected profile name
        expected: String,
        /// The actual profile name found in the ID
        got: String,
    },

    /// Transform ID not found in profile configuration
    #[error("Transform not found: ID {0}")]
    TransformNotFound(u16),

    /// Profile does not support decoding back to embedding
    #[error("Decoding not supported for this profile type")]
    DecodingNotSupported,

    /// Invalid precision setting
    #[error("Invalid precision: {0}")]
    InvalidPrecision(String),

    /// Dimension projection error
    #[error("Projection error: {0}")]
    ProjectionError(String),

    /// Insufficient data in encoded payload
    #[error("Insufficient data: expected {expected} bytes, got {got}")]
    InsufficientData {
        /// Expected number of bytes
        expected: usize,
        /// Actual number of bytes found
        got: usize,
    },

    /// Invalid metadata in header
    #[error("Invalid metadata in header: {0}")]
    InvalidMetadata(String),
}