Struct PiercingDarkCloud 

pub struct PiercingDarkCloud { /* private fields */ }

Piercing Line / Dark Cloud Cover — a 2-bar reversal pattern.

Piercing Line (bullish, +1.0):

prev_red & curr_green
  & curr.open <  prev.low
  & curr.close > (prev.open + prev.close) / 2
  & curr.close <  prev.open

Dark Cloud Cover (bearish, −1.0):

prev_green & curr_red
  & curr.open >  prev.high
  & curr.close < (prev.open + prev.close) / 2
  & curr.close >  prev.open

Output is +1.0 for a Piercing Line, −1.0 for a Dark Cloud Cover, and 0.0 otherwise. The first bar always returns 0.0. Pattern-shape check only — no trend filter is applied; combine with a trend indicator for actionable signals.

Signed ±1 encoding

This detector already 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 of the pattern occupy a single dimension.

Example

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

let mut indicator = PiercingDarkCloud::new();
indicator.update(Candle::new(12.0, 12.5, 10.0, 10.0, 1.0, 0).unwrap());
// Open below prev low, close above midpoint (11) but below prev open (12).
let out = indicator
    .update(Candle::new(9.8, 11.8, 9.5, 11.5, 1.0, 1).unwrap());
assert_eq!(out, Some(1.0));

Implementations

impl PiercingDarkCloud

pub const fn new() -> Self

Construct a new Piercing Line / Dark Cloud Cover detector.

Trait Implementations

impl Clone for PiercingDarkCloud

fn clone(&self) -> PiercingDarkCloud

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PiercingDarkCloud

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

Formats the value using the given formatter.

impl Default for PiercingDarkCloud

fn default() -> PiercingDarkCloud

Returns the “default value” for a type.

impl Indicator for PiercingDarkCloud

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.