Struct RandomForestMultiOutput 

pub struct RandomForestMultiOutput<S = Untrained> { /* private fields */ }

Random Forest Multi-Output Extension

A random forest that can handle multiple output variables simultaneously. This implementation creates multiple multi-target regression trees and averages their predictions for robust multi-output regression.

Mathematical Foundation

The random forest combines multiple multi-target regression trees:

• Each tree is trained on a bootstrap sample of the data
• Each tree considers only a random subset of features at each split
• Final prediction is the average of all tree predictions
• Feature importance is averaged across all trees

Examples

use sklears_multioutput::RandomForestMultiOutput;
use sklears_core::traits::{Predict, Fit};
// Use SciRS2-Core for arrays and random number generation (SciRS2 Policy)
use scirs2_core::ndarray::array;

let X = array![[1.0, 2.0], [2.0, 3.0], [3.0, 1.0], [4.0, 4.0]];
let y = array![[1.5, 2.5], [2.5, 3.5], [3.5, 1.5], [4.5, 4.5]];

let forest = RandomForestMultiOutput::new()
    .n_estimators(10)
    .max_depth(Some(3));
let trained_forest = forest.fit(&X.view(), &y).unwrap();
let predictions = trained_forest.predict(&X.view()).unwrap();

Implementations

impl RandomForestMultiOutput<Untrained>

pub fn new() -> Self

Create a new RandomForestMultiOutput instance

pub fn n_estimators(self, n_estimators: usize) -> Self

Set the number of trees in the forest

pub fn max_depth(self, max_depth: Option<usize>) -> Self

Set the maximum depth of the trees

pub fn min_samples_split(self, min_samples_split: usize) -> Self

Set the minimum number of samples required to split an internal node

pub fn min_samples_leaf(self, min_samples_leaf: usize) -> Self

Set the minimum number of samples required to be at a leaf node

pub fn max_features(self, max_features: Option<usize>) -> Self

Set the number of features to consider when looking for the best split

pub fn bootstrap(self, bootstrap: bool) -> Self

Set whether to use bootstrap samples when building trees

pub fn random_state(self, random_state: Option<u64>) -> Self

Set the random state for reproducible results

pub fn get_n_estimators(&self) -> usize

Get the number of trees in the forest

pub fn get_max_depth(&self) -> Option<usize>

Get the maximum depth of the trees

pub fn get_min_samples_split(&self) -> usize

Get the minimum number of samples required to split an internal node

pub fn get_min_samples_leaf(&self) -> usize

Get the minimum number of samples required to be at a leaf node

pub fn get_max_features(&self) -> Option<usize>

Get the maximum number of features to consider when looking for the best split

pub fn get_bootstrap(&self) -> bool

Get whether bootstrap samples are used when building trees

pub fn get_random_state(&self) -> Option<u64>

Get the random state

impl RandomForestMultiOutput<RandomForestMultiOutputTrained>

pub fn feature_importances(&self) -> &Array1<Float>

Get the feature importances averaged across all trees

pub fn n_estimators(&self) -> usize

Get the number of estimators (trees)

pub fn n_features(&self) -> usize

Get the number of features

pub fn n_targets(&self) -> usize

Get the number of targets

pub fn predict(&self, X: &ArrayView2<'_, Float>) -> SklResult<Array2<Float>>

Predict using the forest (average of all tree predictions)

Trait Implementations

impl<S: Clone> Clone for RandomForestMultiOutput<S>

fn clone(&self) -> RandomForestMultiOutput<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug> Debug for RandomForestMultiOutput<S>

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

Formats the value using the given formatter.

impl Default for RandomForestMultiOutput<Untrained>

fn default() -> Self

Returns the “default value” for a type.

impl Estimator for RandomForestMultiOutput<Untrained>

type Config = ()

Configuration type for the estimator

type Error = SklearsError

Error type for the estimator

type Float = f64

The numeric type used by this estimator

fn config(&self) -> &Self::Config

Get estimator configuration

fn validate_config(&self) -> Result<(), SklearsError>

Validate estimator configuration with detailed error context

fn check_compatibility( &self, n_samples: usize, n_features: usize, ) -> Result<(), SklearsError>

Check if estimator is compatible with given data dimensions

fn metadata(&self) -> EstimatorMetadata

Get estimator metadata

impl Fit<ArrayBase<ViewRepr<&f64>, Dim<[usize; 2]>>, ArrayBase<OwnedRepr<f64>, Dim<[usize; 2]>>> for RandomForestMultiOutput<Untrained>

type Fitted = RandomForestMultiOutput<RandomForestMultiOutputTrained>

The fitted model type

fn fit( self, X: &ArrayView2<'_, Float>, y: &Array2<Float>, ) -> SklResult<Self::Fitted>

Fit the model to the provided data with validation

fn fit_with_validation( self, x: &X, y: &Y, _x_val: Option<&X>, _y_val: Option<&Y>, ) -> Result<(Self::Fitted, FitMetrics), SklearsError>

where Self: Sized,

Fit with custom validation and early stopping