Struct HretObserver 

pub struct HretObserver { /* private fields */ }

Stateful HRET observer for grouped residual fusion.

The observer keeps exponentially weighted absolute residual envelopes for each channel and group, then combines channel and group trust into convex fusion weights.

Implementations

impl HretObserver

pub fn new( m: usize, g: usize, group_mapping: Vec<usize>, rho: f64, rho_g: Vec<f64>, beta_k: Vec<f64>, beta_g: Vec<f64>, k_k: Vec<Vec<f64>>, ) -> Result<Self, HretError>

Constructs a new observer and validates all dimensions and scalar parameters.

k_k is the fusion gain matrix with shape (p, m), where m is the number of channels and p is the correction dimension.

pub fn update(&mut self, residuals: Vec<f64>) -> Result<HretUpdate, HretError>

Applies one HRET update for the provided channel residuals.

Returns the fused correction, normalized channel weights, updated channel envelopes, and updated group envelopes.

pub fn reset_envelopes(&mut self)

Resets the stored channel and group envelope state to zero.

pub fn channel_count(&self) -> usize

Returns the configured number of residual channels.

pub fn group_count(&self) -> usize

Returns the configured number of groups.

pub fn group_mapping_vec(&self) -> Vec<usize>

Returns the channel-to-group mapping as a plain vector.

Trait Implementations

impl Clone for HretObserver

fn clone(&self) -> HretObserver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HretObserver

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

Formats the value using the given formatter.

impl IntoPy<Py<PyAny>> for HretObserver

fn into_py(self, py: Python<'_>) -> PyObject

Performs the conversion.

impl PyClass for HretObserver

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for HretObserver

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<HretObserver>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn doc(py: Python<'_>) -> PyResult<&'static CStr>

Rendered class doc

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyClassNewTextSignature<HretObserver> for PyClassImplCollector<HretObserver>

fn new_text_signature(self) -> Option<&'static str>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a HretObserver

type Holder = Option<PyRef<'py, HretObserver>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'a mut Self::Holder, ) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a mut HretObserver

type Holder = Option<PyRefMut<'py, HretObserver>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'a mut Self::Holder, ) -> PyResult<Self>

impl PyMethods<HretObserver> for PyClassImplCollector<HretObserver>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for HretObserver

const NAME: &'static str = "HretObserver"

Class name.

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object_bound(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of_bound(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of_bound(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl DerefToPyAny for HretObserver