Struct DirectionChanges 

pub struct DirectionChanges { /* private fields */ }

Direction Changes — count of close-over-close reversals in the last period bars.

A reversal occurs when consecutive bar moves change sign: an up move followed by a down move, or vice versa. Requires 3 closes to detect the first reversal.

Interpretation:

• High count: choppy, mean-reverting market (many direction flips).
• Low count: trending market (sustained directional moves).
• Maximum possible: period - 1 (every bar reverses direction).

Returns SignalValue::Unavailable until period + 1 closes have been seen.

Example

use fin_primitives::signals::indicators::DirectionChanges;
use fin_primitives::signals::Signal;
let dc = DirectionChanges::new("dc_10", 10).unwrap();
assert_eq!(dc.period(), 10);

Implementations

impl DirectionChanges

pub fn new(name: impl Into<String>, period: usize) -> Result<Self, FinError>

Constructs a new DirectionChanges.

Errors

Returns FinError::InvalidPeriod if period < 2.

Trait Implementations

impl Signal for DirectionChanges

fn name(&self) -> &str

Returns the name of this signal (unique within a pipeline).

fn period(&self) -> usize

Returns the number of bars required before the signal produces a value.

fn is_ready(&self) -> bool

Returns true if the signal has accumulated enough bars to produce a value.

fn update(&mut self, bar: &BarInput) -> Result<SignalValue, FinError>

Updates the signal with a BarInput and returns the current value.

fn reset(&mut self)

Resets the signal to its initial state as if no bars had been seen.

fn update_bar(&mut self, bar: &OhlcvBar) -> Result<SignalValue, FinError>

Convenience wrapper: converts bar to BarInput and calls Self::update.

fn warm_up(&mut self, bars: &[BarInput]) -> Result<SignalValue, FinError>

Feed a slice of historical bars to prime the indicator in one call.