Struct Stc 

pub struct Stc { /* private fields */ }

Doug Schaff’s Trend Cycle — a doubly-Stochastic-smoothed MACD that produces a bounded [0, 100] reading reacting faster than MACD itself.

macd_t  = EMA(close, fast)_t − EMA(close, slow)_t
%K_t    = 100 · (macd − LL(macd, period)) / (HH(macd, period) − LL(macd, period))
%D_t    = %D_{t-1} + factor · (%K_t − %D_{t-1})           // half-EMA when factor = 0.5
%K2_t   = 100 · (%D − LL(%D, period)) / (HH(%D, period) − LL(%D, period))
STC_t   = STC_{t-1} + factor · (%K2_t − STC_{t-1})

Wickra uses factor = 0.5 and Schaff’s recommended defaults (fast = 23, slow = 50, period = 10). The stochastic stages clamp to 0 when the window range collapses (perfectly flat input), and the smoothing stages hold their previous value if the upstream stage is not yet ready — so a flat input series settles deterministically at 0 after warmup.

Example

use wickra_core::{Indicator, Stc};

let mut stc = Stc::classic();
let mut last = None;
for i in 0..200 {
    last = stc.update(100.0 + f64::from(i));
}
assert!(last.is_some());

Implementations

impl Stc

pub fn new( fast: usize, slow: usize, schaff_period: usize, factor: f64, ) -> Result<Self>

Errors

• Error::PeriodZero if any period is zero.
• Error::InvalidPeriod if fast >= slow or factor is not in (0, 1].

pub fn classic() -> Self

Schaff’s recommended defaults (fast = 23, slow = 50, period = 10, factor = 0.5).

pub const fn params(&self) -> (usize, usize, usize, f64)

Configured (fast, slow, schaff_period, factor).

Trait Implementations

impl Clone for Stc

fn clone(&self) -> Stc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stc

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

Formats the value using the given formatter.

impl Indicator for Stc

type Input = f64

Type of one input data point (typically f64 for a price, or Candle / Tick).

type Output = f64

Type of one output value.

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.

fn reset(&mut self)

Reset all internal state, leaving the indicator equivalent to a freshly constructed instance with the same parameters.

fn warmup_period(&self) -> usize

Number of inputs required before the first non-None output can be produced.

fn is_ready(&self) -> bool

Whether the indicator has emitted at least one value since the last reset.

fn name(&self) -> &'static str

Stable, human-readable indicator name. Used by chaining and diagnostics.