Struct TpoProfile 

pub struct TpoProfile { /* private fields */ }

Rolling TPO (Time Price Opportunity) Profile over the last period candles.

Where crate::VolumeProfile distributes each bar’s volume across the bins it touches, the TPO profile counts time: every period that trades at a price level contributes exactly one TPO mark there, regardless of how much volume it carried. The result highlights the prices the market spent the most time at — the market-profile bell curve. Each touched bin receives a full +1 per period (no sharing), so a wide-range bar marks every level it spans.

A window whose bars are all single-print at one price (price_high == price_low) is degenerate: every period’s mark lands in bin 0 and both edges collapse to that price.

Example

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

let mut tpo = TpoProfile::new(5, 10).unwrap();
let mut last = None;
for i in 0..10 {
    let base = 100.0 + f64::from(i);
    let candle =
        Candle::new(base, base + 2.0, base - 2.0, base, 10.0, i64::from(i)).unwrap();
    last = tpo.update(candle);
}
let profile = last.unwrap();
assert_eq!(profile.counts.len(), 10);

Implementations

impl TpoProfile

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

Construct a TPO Profile indicator.

Errors

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

pub fn classic() -> Self

Classic TPO Profile: 30-bar rolling window, 50 bins.

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

Configured (period, bin_count).

pub const fn width(&self) -> usize

How many values every emitted profile carries – the bin count fixed at construction.

Fixed for the lifetime of the indicator, so a caller can size a buffer once instead of guessing.

pub fn value(&self) -> Option<&TpoProfileOutput>

Most recent profile if available.

Trait Implementations

impl Clone for TpoProfile

fn clone(&self) -> TpoProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TpoProfile

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

Formats the value using the given formatter.

impl Indicator for TpoProfile

type Input = Candle

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

type Output = TpoProfileOutput

Type of one output value.

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

Feed one new data point into the indicator and return the freshly computed output, or None if there is no value for this input.

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.