Struct Counterattack 

pub struct Counterattack { /* private fields */ }

Counterattack — a 2-bar reversal where the second bar storms back to close right where the first bar closed. A long candle runs with the trend, then an opposite-coloured long candle opens far in the trend direction and rallies (or sells off) all the way back to the prior close — the two closes meeting forms the “counterattack line”.

long bodies   = |close − open| >= 0.5 * (high − low)   (both bars)
equal closes  = |close2 − close1| <= tol * mean(range1, range2)
bullish (+1.0): bar1 black (down), bar2 white (up), equal closes
bearish (−1.0): bar1 white (up),   bar2 black (down), equal closes

Output is +1.0 bullish, −1.0 bearish, and 0.0 when the bodies are short, the colours match, or the closes are not level. The first bar always returns 0.0 because the two-bar window is not yet filled. equal_tolerance defaults to 0.05 (TA-Lib’s CDLCOUNTERATTACK “equal” factor — 5 % of the mean bar range) and must lie in [0, 1). The body-length test uses a fixed half-range fraction rather than TA-Lib’s rolling body average, matching the geometric house style of this pattern family. Pattern-shape check only — no trend filter is applied; combine with a trend indicator for actionable signals.

Signed ±1 encoding

This detector emits the uniform candlestick sign convention shared across the pattern family — +1.0 bullish, −1.0 bearish, 0.0 no pattern — so it drops straight into a machine-learning feature matrix where the bullish and bearish variants occupy a single dimension.

Example

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

let mut indicator = Counterattack::new();
// Bullish: a long black bar, then a long white bar closing at the same level.
indicator.update(Candle::new(20.0, 20.1, 14.9, 15.0, 1.0, 0).unwrap());
let out = indicator
    .update(Candle::new(10.0, 15.1, 9.9, 15.0, 1.0, 1).unwrap());
assert_eq!(out, Some(1.0));

Implementations

impl Counterattack

pub const fn new() -> Self

Construct a Counterattack detector with the default 5 % equal-close tolerance.

pub fn with_tolerance(equal_tolerance: f64) -> Result<Self>

Construct a Counterattack detector with a custom equal-close tolerance.

equal_tolerance is the fraction of the mean bar range within which the two closes must agree and must lie in [0, 1).

pub fn equal_tolerance(&self) -> f64

Configured equal-close tolerance.

Trait Implementations

impl Clone for Counterattack

fn clone(&self) -> Counterattack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Counterattack

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

Formats the value using the given formatter.

impl Default for Counterattack

fn default() -> Self

Returns the “default value” for a type.

impl Indicator for Counterattack

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.