Enum QueryError 

#[non_exhaustive]
pub enum QueryError {
    InvalidResponse(String),
    InvalidTransport(String),
    InvalidInterference(String),
    TreatmentEqualsOutcome {
        id: VariableId,
    },
    InterventionVariableMismatch {
        expected: VariableId,
        got: VariableId,
    },
    AmbiguousInterventionTarget,
    ModifierOverlapsTreatmentOrOutcome,
    InvalidTemporalWindow {
        from: i32,
        until: i32,
    },
    NonPositiveHorizon,
    InvalidIntervention(String),
    EmptyCounterfactualOutcomes,
    EmptyAnomalyTargets,
    NonPositiveAnomalyLimit,
    EmptyMediators,
    MediatorOverlapsTreatmentOrOutcome,
    EmptyEffectModifiers,
    EmptyPopulationRows,
    EmptyPredicateName,
    DynamicPolicyHasNoTreatmentOffset,
    InvalidPopulationTimeRange {
        start: usize,
        end: usize,
    },
    EmptyAllocationOrder,
    DuplicateAllocationComponent,
    NonPositiveShapleyLimit,
    NonPositiveShapleySamples,
    NonPositiveComponentLimit,
    EmptyMechanismChangeTargets,
    InvalidSignificanceLevel,
    EmptyDistributionOutcomes,
    NonPositivePathLimit,
    PathNodeOverlapsTreatmentOrOutcome,
    ConditioningOverlapsOutcomeOrIntervention,
    PopulationRegistryRequired,
    UnknownPredicateName {
        name: Arc<str>,
    },
    UnknownDistributionRef {
        id: u32,
    },
    PopulationNeedsTreatment,
    PopulationNonBinaryTreatment,
    PopulationLengthMismatch {
        expected: usize,
        actual: usize,
    },
    PopulationRowOutOfRange {
        row: usize,
        n: usize,
    },
    PopulationEnvironmentUnsupported,
    InvalidPopulationWeights,
}

Errors from query construction or validation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidResponse(String)

Invalid continuous-response configuration.

InvalidTransport(String)

Invalid transportability configuration.

InvalidInterference(String)

Invalid randomization/interference configuration.

TreatmentEqualsOutcome

Treatment and outcome are the same variable.

Fields

id: VariableId

Shared id.

InterventionVariableMismatch

Intervention does not target the declared treatment.

Fields

expected: VariableId

Expected treatment id.

got: VariableId

Actual intervention target.

AmbiguousInterventionTarget

Intervention sequence has no unique target variable.

ModifierOverlapsTreatmentOrOutcome

Effect modifier overlaps treatment or outcome.

InvalidTemporalWindow

Sustained window has until < from.

Fields

from: i32

Window start.

until: i32

Window end.

NonPositiveHorizon

Horizon must be at least one time step.

InvalidIntervention(String)

Nested intervention failed validation.

EmptyCounterfactualOutcomes

Counterfactual query has no outcomes.

EmptyAnomalyTargets

Anomaly query has no targets.

NonPositiveAnomalyLimit

Anomaly max_units must be ≥ 1.

EmptyMediators

Mediation query has no mediators.

MediatorOverlapsTreatmentOrOutcome

Mediator overlaps treatment or outcome.

EmptyEffectModifiers

Conditional effect requires non-empty modifiers.

EmptyPopulationRows

Population selector has no rows.

EmptyPredicateName

Named crate::query::PredicateExpr has an empty registry key.

DynamicPolicyHasNoTreatmentOffset

crate::intervention::TemporalPolicy::Dynamic has no single treatment origin.

InvalidPopulationTimeRange

Time-range population has end <= start.

Fields

start: usize

Start.

end: usize

End.

EmptyAllocationOrder

Sequential allocation order is empty.

DuplicateAllocationComponent

Sequential allocation order contains the same component more than once.

NonPositiveShapleyLimit

Shapley exact component limit must be ≥ 1.

NonPositiveShapleySamples

Approximate Shapley sample / permutation count must be ≥ 1.

NonPositiveComponentLimit

Change attribution max_components must be ≥ 1.

EmptyMechanismChangeTargets

Mechanism-change query has no targets.

InvalidSignificanceLevel

Significance level must be in (0, 1).

EmptyDistributionOutcomes

Interventional distribution query has no outcomes.

NonPositivePathLimit

Path enumeration max_paths / max_len must be ≥ 1.

PathNodeOverlapsTreatmentOrOutcome

Path node overlaps treatment or outcome.

ConditioningOverlapsOutcomeOrIntervention

Distribution conditioning overlaps an outcome or intervention target.

PopulationRegistryRequired

Named / custom population requires a super::PopulationRegistry.

UnknownPredicateName

Named predicate is not bound in the registry.

Fields

name: Arc<str>

Predicate key.

UnknownDistributionRef

Custom distribution handle is not bound in the registry.

Fields

id: u32

Raw distribution id.

PopulationNeedsTreatment

Treated / untreated population requires a treatment column.

PopulationNonBinaryTreatment

Treatment column is not binary 0/1.

PopulationLengthMismatch

Keep-mask / weight length mismatch.

Fields

expected: usize

Expected length.

actual: usize

Actual length.

PopulationRowOutOfRange

Predicate row index ≥ n.

Fields

row: usize

Offending row.

n: usize

Population size.

PopulationEnvironmentUnsupported

Environment-restricted populations need multi-env data (not resolved here).

InvalidPopulationWeights

Distribution weights contain negatives or non-finite values.

Trait Implementations

impl Clone for QueryError

fn clone(&self) -> QueryError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryError

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

Formats the value using the given formatter.

impl Display for QueryError

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

Formats the value using the given formatter.

impl Eq for QueryError

impl Error for QueryError

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 PartialEq for QueryError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for QueryError