Struct PathSpecificEffectQuery 

pub struct PathSpecificEffectQuery {
    pub treatment: VariableId,
    pub outcome: VariableId,
    pub path_nodes: Arc<[VariableId]>,
    pub control: Intervention,
    pub active: Intervention,
    pub target_population: TargetPopulation,
    pub max_paths: usize,
    pub max_len: usize,
}

Path-specific effect / contribution query.

Prefer this over overloading MediationQuery. Path contribution attribution is available via GCM path_decompose; path-restricted natural effects identify/estimate via the ID family (path_specific.natural) and functional.effect plug-in estimation.

Fields

treatment: VariableId

Treatment / source variable.

outcome: VariableId

Outcome variable.

path_nodes: Arc<[VariableId]>

Intermediate nodes constraining the path set (empty = all directed paths).

control: Intervention

Control intervention level.

active: Intervention

Active intervention level.

target_population: TargetPopulation

Target population.

max_paths: usize

Maximum number of paths to enumerate.

max_len: usize

Maximum path length (edges).

Implementations

impl PathSpecificEffectQuery

pub fn binary(treatment: VariableId, outcome: VariableId) -> Self

Binary 0/1 treatment contrast with all directed paths and default limits.

pub fn with_path_nodes(self, nodes: impl Into<Arc<[VariableId]>>) -> Self

Restrict to paths that visit these intermediate nodes (in any order).

pub const fn with_max_paths(self, max_paths: usize) -> Self

Cap path enumeration.

pub const fn with_max_len(self, max_len: usize) -> Self

Cap path length.

pub fn with_target_population(self, population: TargetPopulation) -> Self

Set target population.

pub fn validate(&self) -> Result<(), QueryError>

Validate ids, interventions, and limits.

Errors

Treatment equals outcome, zero limits, path-node overlaps, or bad interventions.

Trait Implementations

impl Clone for PathSpecificEffectQuery

fn clone(&self) -> PathSpecificEffectQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathSpecificEffectQuery

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

Formats the value using the given formatter.

impl From<PathSpecificEffectQuery> for CausalQuery

fn from(query: PathSpecificEffectQuery) -> Self

Converts to this type from the input type.

impl PartialEq for PathSpecificEffectQuery

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PathSpecificEffectQuery