pub struct LinRegChannel { /* private fields */ }Expand description
Linear Regression Channel: rolling least-squares line with ±k·σ bands
sized by the residuals about the fitted line.
fit y = a + b·x by OLS over the last `period` closes
residual_i = y_i − (a + b · x_i)
sigma = sqrt( Σ residual_i² / period ) // population stddev
middle = a + b · (period − 1) // endpoint of the line
upper = middle + multiplier · sigma
lower = middle − multiplier · sigmaWhere BollingerBands measures dispersion about
the mean, the LinReg Channel measures it about the trend: detrended
residuals, so a steady drift up or down does not bias the band width. The
resulting envelope tracks the trend without flaring on momentum bursts —
breakouts are statistically meaningful in the direction of trend, not just
in absolute price.
§Example
use wickra_core::{Indicator, LinRegChannel};
let mut indicator = LinRegChannel::new(20, 2.0).unwrap();
let mut last = None;
for i in 0..40 {
last = indicator.update(100.0 + f64::from(i));
}
assert!(last.is_some());Implementations§
Source§impl LinRegChannel
impl LinRegChannel
Sourcepub fn new(period: usize, multiplier: f64) -> Result<Self>
pub fn new(period: usize, multiplier: f64) -> Result<Self>
§Errors
Returns Error::InvalidPeriod if period < 2 and
Error::NonPositiveMultiplier if multiplier is not strictly
positive and finite.
Sourcepub const fn multiplier(&self) -> f64
pub const fn multiplier(&self) -> f64
Configured multiplier.
Trait Implementations§
Source§impl Clone for LinRegChannel
impl Clone for LinRegChannel
Source§fn clone(&self) -> LinRegChannel
fn clone(&self) -> LinRegChannel
Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source. Read moreSource§impl Debug for LinRegChannel
impl Debug for LinRegChannel
Source§impl Indicator for LinRegChannel
impl Indicator for LinRegChannel
Source§type Output = LinRegChannelOutput
type Output = LinRegChannelOutput
Type of one output value.
Source§fn update(&mut self, value: f64) -> Option<LinRegChannelOutput>
fn update(&mut self, value: f64) -> Option<LinRegChannelOutput>
Feed one new data point into the indicator and return the freshly computed
output, or
None if the indicator is still warming up.Source§fn reset(&mut self)
fn reset(&mut self)
Reset all internal state, leaving the indicator equivalent to a freshly
constructed instance with the same parameters.
Source§fn warmup_period(&self) -> usize
fn warmup_period(&self) -> usize
Number of inputs required before the first non-
None output can be produced.Auto Trait Implementations§
impl Freeze for LinRegChannel
impl RefUnwindSafe for LinRegChannel
impl Send for LinRegChannel
impl Sync for LinRegChannel
impl Unpin for LinRegChannel
impl UnsafeUnpin for LinRegChannel
impl UnwindSafe for LinRegChannel
Blanket Implementations§
Source§impl<T> BatchExt for Twhere
T: Indicator,
impl<T> BatchExt for Twhere
T: Indicator,
Source§fn batch(&mut self, inputs: &[Self::Input]) -> Vec<Option<Self::Output>>
fn batch(&mut self, inputs: &[Self::Input]) -> Vec<Option<Self::Output>>
Run the indicator over a slice of inputs in order, returning one output (or
None during warmup) per input.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> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
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