Struct HighLowVolumeNodes 

pub struct HighLowVolumeNodes { /* private fields */ }

High/Low Volume Nodes — the price levels of greatest and least acceptance in a rolling volume profile.

build a `bins`-bucket volume profile over the last `period` candles
HVN = bin centre of the bucket with the most volume
LVN = bin centre of the traded bucket with the least volume

A volume profile reveals where the market spent the most effort. A High Volume Node (HVN) is a price the market accepted and traded heavily — it acts as a magnet and as strong support/resistance. A Low Volume Node (LVN) is a price the market rejected quickly — moves tend to accelerate through LVNs and they often mark the edges between balance areas. Each candle’s volume is spread across the price bins its high-low range spans (as in VolumeProfile).

The first value lands after period candles; each update rebuilds the profile in O(period · bins). A degenerate flat window puts both nodes at the price.

Example

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

let mut indicator = HighLowVolumeNodes::new(20, 24).unwrap();
let mut last = None;
for i in 0..40 {
    let base = 100.0 + (f64::from(i) * 0.3).sin() * 5.0;
    let c = Candle::new(base, base + 1.0, base - 1.0, base, 1_000.0, 0).unwrap();
    last = indicator.update(c);
}
assert!(last.is_some());

Implementations

impl HighLowVolumeNodes

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

Construct a High/Low Volume Nodes indicator.

Errors

Returns Error::PeriodZero if period or bins is zero.

pub const fn params(&self) -> (usize, usize)

Configured (period, bins).

pub const fn value(&self) -> Option<HighLowVolumeNodesOutput>

Current value if available.

Trait Implementations

impl Clone for HighLowVolumeNodes

fn clone(&self) -> HighLowVolumeNodes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HighLowVolumeNodes

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

Formats the value using the given formatter.

impl Indicator for HighLowVolumeNodes

type Input = Candle

Type of one input data point (typically f64 for a price, or Candle / Tick).

type Output = HighLowVolumeNodesOutput

Type of one output value.

fn update(&mut self, candle: Candle) -> Option<HighLowVolumeNodesOutput>

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.