pub struct GeneralizedDema { /* private fields */ }Expand description
Generalized DEMA — the building block of Tillson’s T3,
exposed on its own.
GD = (1 + v) · EMA(price) − v · EMA(EMA(price))where both EMAs share the same period and v ∈ [0, 1] is the volume
factor. v controls how much of the second-order lag correction is
applied:
v = 0collapses GD to a plainEma(no correction).v = 1recovers the standardDema2·EMA − EMA(EMA).- intermediate values (Tillson uses
0.7) trade a little lag reduction for less overshoot than DEMA.
Because the coefficients (1 + v) and −v always sum to 1, a constant
series maps to itself. The first output lands after 2·period − 1 inputs —
EMA1 seeds at period, then EMA2 needs another period − 1 of EMA1’s
outputs to seed, exactly like DEMA.
§Example
use wickra_core::{Indicator, GeneralizedDema};
let mut indicator = GeneralizedDema::new(5, 0.7).unwrap();
let mut last = None;
for i in 0..80 {
last = indicator.update(100.0 + f64::from(i));
}
assert!(last.is_some());Implementations§
Source§impl GeneralizedDema
impl GeneralizedDema
Sourcepub fn new(period: usize, v: f64) -> Result<Self>
pub fn new(period: usize, v: f64) -> Result<Self>
Construct a generalized DEMA with the given period and volume factor
v.
§Errors
Returns Error::PeriodZero if period == 0, or
Error::InvalidPeriod if v is non-finite or outside [0.0, 1.0].
Sourcepub const fn volume_factor(&self) -> f64
pub const fn volume_factor(&self) -> f64
Configured volume factor v.
Trait Implementations§
Source§impl Clone for GeneralizedDema
impl Clone for GeneralizedDema
Source§fn clone(&self) -> GeneralizedDema
fn clone(&self) -> GeneralizedDema
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 GeneralizedDema
impl Debug for GeneralizedDema
Source§impl Indicator for GeneralizedDema
impl Indicator for GeneralizedDema
Source§fn update(&mut self, input: f64) -> Option<f64>
fn update(&mut self, input: f64) -> Option<f64>
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 GeneralizedDema
impl RefUnwindSafe for GeneralizedDema
impl Send for GeneralizedDema
impl Sync for GeneralizedDema
impl Unpin for GeneralizedDema
impl UnsafeUnpin for GeneralizedDema
impl UnwindSafe for GeneralizedDema
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