Struct StochasticCci 

pub struct StochasticCci { /* private fields */ }

Stochastic CCI — the stochastic oscillator computed over the Cci instead of price.

The CCI is unbounded and spends most of its time inside ±100, which makes fixed overbought/oversold lines awkward. Running a stochastic over the CCI re-scales it to [0, 100] relative to its own recent range, turning it into a bounded, self-normalising momentum oscillator:

cci = CCI(typical price, period)
%K  = 100 * (cci - lowest(cci, period)) / (highest(cci, period) - lowest(cci, period))

The same period is used for the CCI and the stochastic lookback. When the CCI range over the window is zero (a flat market, where the CCI is pinned at 0) the oscillator returns the neutral 50. The first value lands after 2·period − 1 bars: period to seed the CCI, then period CCI values to fill the stochastic window.

Example

use wickra_core::{Candle, StochasticCci, Indicator};

let mut sc = StochasticCci::new(14).unwrap();
let mut last = None;
for i in 0..60 {
    let base = 100.0 + (f64::from(i) * 0.3).sin() * 10.0;
    let c = Candle::new(base, base + 1.0, base - 1.0, base, 1.0, i64::from(i)).unwrap();
    last = sc.update(c);
}
assert!(last.is_some());

Implementations

impl StochasticCci

pub fn new(period: usize) -> Result<Self>

Construct a Stochastic CCI with the given period (shared by the CCI and the stochastic lookback).

Errors

Returns crate::Error::PeriodZero if period == 0.

pub const fn period(&self) -> usize

Configured period.

Trait Implementations

impl Clone for StochasticCci

fn clone(&self) -> StochasticCci

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StochasticCci

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

Formats the value using the given formatter.

impl Indicator for StochasticCci

type Input = Candle

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, candle: Candle) -> 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.