pub struct EnsembleNode { /* private fields */ }Expand description
Ensemble node for multi-model fusion.
This node runs multiple behaviors/models in parallel and combines their results using a configurable strategy. This is useful for:
- Combining multiple AI models for robust predictions
- Redundancy and fault tolerance
- Multi-modal sensor fusion
§Strategies
- WeightedVote: Models vote with weights, success if total > threshold
- Conservative: All models must succeed (high precision, low recall)
- Optimistic: Any model can succeed (high recall, low precision)
- Majority: More than half must succeed (balanced)
§Example
use mecha10_behavior_patterns::prelude::*;
let ensemble = EnsembleNode::new(EnsembleStrategy::WeightedVote)
.add_model(Box::new(YoloV8), 0.4)
.add_model(Box::new(YoloV10), 0.3)
.add_model(Box::new(CustomDetector), 0.3);Implementations§
Source§impl EnsembleNode
impl EnsembleNode
Sourcepub fn new(strategy: EnsembleStrategy) -> Self
pub fn new(strategy: EnsembleStrategy) -> Self
Create a new ensemble node with the given strategy.
Sourcepub fn add_model(self, behavior: BoxedBehavior, weight: f32) -> Self
pub fn add_model(self, behavior: BoxedBehavior, weight: f32) -> Self
Add a model with a weight.
Sourcepub fn add_named_model(
self,
name: impl Into<String>,
behavior: BoxedBehavior,
weight: f32,
) -> Self
pub fn add_named_model( self, name: impl Into<String>, behavior: BoxedBehavior, weight: f32, ) -> Self
Add a named model.
Sourcepub fn with_threshold(self, threshold: f32) -> Self
pub fn with_threshold(self, threshold: f32) -> Self
Set the threshold for weighted voting (default 0.5).
Sourcepub fn model_count(&self) -> usize
pub fn model_count(&self) -> usize
Get the number of models in the ensemble.
Trait Implementations§
Source§impl BehaviorNode for EnsembleNode
impl BehaviorNode for EnsembleNode
Source§fn tick<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
) -> Pin<Box<dyn Future<Output = Result<NodeStatus>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn tick<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
) -> Pin<Box<dyn Future<Output = Result<NodeStatus>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Execute one tick of the behavior. Read more
Source§fn reset<'life0, 'async_trait>(
&'life0 mut self,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn reset<'life0, 'async_trait>(
&'life0 mut self,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Reset the behavior to its initial state. Read more
Source§fn on_init<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn on_init<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Called when the behavior is first initialized. Read more
Auto Trait Implementations§
impl Freeze for EnsembleNode
impl !RefUnwindSafe for EnsembleNode
impl Send for EnsembleNode
impl Sync for EnsembleNode
impl Unpin for EnsembleNode
impl !UnwindSafe for EnsembleNode
Blanket Implementations§
Source§impl<T> BehaviorNodeExt for Twhere
T: BehaviorNode + ?Sized,
impl<T> BehaviorNodeExt for Twhere
T: BehaviorNode + ?Sized,
Source§fn run_until_complete<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
) -> Pin<Box<dyn Future<Output = Result<NodeStatus, Error>> + Send + 'async_trait>>where
'life0: 'async_trait,
'life1: 'async_trait,
Self: Send + 'async_trait,
fn run_until_complete<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
) -> Pin<Box<dyn Future<Output = Result<NodeStatus, Error>> + Send + 'async_trait>>where
'life0: 'async_trait,
'life1: 'async_trait,
Self: Send + 'async_trait,
Run this behavior until it completes (Success or Failure). Read more
Source§fn run_with_limit<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
max_ticks: usize,
) -> Pin<Box<dyn Future<Output = Result<NodeStatus, Error>> + Send + 'async_trait>>where
'life0: 'async_trait,
'life1: 'async_trait,
Self: Send + 'async_trait,
fn run_with_limit<'life0, 'life1, 'async_trait>(
&'life0 mut self,
ctx: &'life1 Context,
max_ticks: usize,
) -> Pin<Box<dyn Future<Output = Result<NodeStatus, Error>> + Send + 'async_trait>>where
'life0: 'async_trait,
'life1: 'async_trait,
Self: Send + 'async_trait,
Run this behavior with a maximum number of ticks. Read more
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more