Struct ThreeLineBreakBars 

pub struct ThreeLineBreakBars { /* private fields */ }

Three-Line-Break bar builder using the classic close-based reversal rule.

A line-break chart draws a new line in the trend direction whenever the close makes a new extreme, and only reverses when the close breaks the extreme of the previous lines lines (three by default — hence “three-line break”). This filters minor noise: a pullback that fails to exceed the last three lines is ignored entirely, so the chart isolates meaningful reversals.

This is the bar-builder counterpart of the ThreeLineBreak indicator: the indicator reports the current line state as a streaming value, whereas this builder emits each completed line as a LineBreakBar so you can reconstruct the full line-break chart. At most one line forms per candle, so BarBuilder::update returns either an empty vector or a single bar.

Construction rules:

• The first candle seeds a reference close and prints nothing.
• The first subsequent move (up or down) draws the first line.
• In an up-trend a close above the last line’s top extends it (a new up line); a close below the lowest low of the last lines lines reverses to a down line. The down-trend is symmetric.

Example

use wickra_core::{BarBuilder, Candle, ThreeLineBreakBars};

let flat = |price: f64| Candle::new(price, price, price, price, 1.0, 0).unwrap();
let mut bars = ThreeLineBreakBars::new(3).unwrap();
bars.update(flat(10.0));           // seed
let first = bars.update(flat(11.0)); // first up line
assert_eq!(first.len(), 1);
assert_eq!(first[0].direction, 1);

Implementations

impl ThreeLineBreakBars

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

Construct a line-break builder that reverses on a break of the last lines lines (3 for the classic three-line break).

Errors

Returns Error::PeriodZero if lines == 0.

pub const fn lines(&self) -> usize

Configured number of lines a reversal must break.

pub fn tracked(&self) -> usize

Number of recent lines currently tracked for the reversal test.

Trait Implementations

impl BarBuilder for ThreeLineBreakBars

type Bar = LineBreakBar

Type of one completed bar.

fn update(&mut self, candle: Candle) -> Vec<LineBreakBar>

Feed one candle and return every bar completed on it (possibly none).

fn reset(&mut self)

Reset all internal state to the freshly-constructed configuration.

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

Stable, human-readable builder name.

fn batch(&mut self, candles: &[Candle]) -> Vec<Self::Bar>

Replay update over a slice, concatenating all completed bars. The result length is data-dependent (not the input length).

impl Clone for ThreeLineBreakBars

fn clone(&self) -> ThreeLineBreakBars

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThreeLineBreakBars

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

Formats the value using the given formatter.