Enum PipelineError 

pub enum PipelineError {
    LengthMismatch {
        cat: usize,
        emb: usize,
    },
    TooFewEmbeddings(usize),
    Projection(ProjectionError),
    UnknownCategory(String),
    UnknownId(String),
    AllTrialsFailed {
        failures: Vec<(PipelineConfig, String)>,
    },
    InvalidSearchSpace(String),
    InvalidInput(String),
}

Reasons a pipeline build or query can fail.

Variants

LengthMismatch

categories and embeddings had different lengths — they must match one-to-one.

Fields

cat: usize

emb: usize

TooFewEmbeddings(usize)

Fewer than 3 embeddings — not enough to fit a 3D projection.

Projection(ProjectionError)

Projection fit rejected the input. Wraps ProjectionError — empty corpus, dim-too-low, inconsistent dim, invalid sigma, etc.

UnknownCategory(String)

A category-keyed query referenced a name that doesn’t exist in the pipeline. Previously these paths silently returned empty results / None, which callers couldn’t distinguish from “category exists but is disconnected on the graph”.

UnknownId(String)

A concept-path query referenced an id that doesn’t exist in the pipeline.

AllTrialsFailed

Every crate::tuner::auto_tune trial failed a downstream validator (e.g. every candidate config was rejected by the pipeline builder). The attached failures list carries the (config, error) pairs the tuner observed — callers should inspect them to find the real cause; the outer error is just a roll-up saying “none of the trials produced a scorable pipeline”.

Fields

failures: Vec<(PipelineConfig, String)>

InvalidSearchSpace(String)

auto_tune was called with a malformed SearchSpace or SearchStrategy — empty axis, budget too small for the strategy to make progress, etc. Surfaced upfront so every search mode (Grid, Random, Bayesian) fails at the same boundary instead of panicking mid-trial or rolling up into AllTrialsFailed { failures: [] }.

InvalidInput(String)

Input validation failed before any projection or pipeline work was attempted (e.g. empty corpus, ragged embeddings, mismatched lengths detected during corpus feature extraction).

Trait Implementations

impl Clone for PipelineError

fn clone(&self) -> PipelineError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PipelineError

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

Formats the value using the given formatter.

impl Display for PipelineError

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

Formats the value using the given formatter.

impl Error for PipelineError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ProjectionError> for PipelineError

fn from(source: ProjectionError) -> Self

Converts to this type from the input type.