Struct Bar 

pub struct Bar {
    pub time: DateTime<Utc>,
    pub open: f64,
    pub high: f64,
    pub low: f64,
    pub close: f64,
    pub volume: f64,
    pub colors: Option<Box<BarColors>>,
    pub payload: Option<Arc<Value>>,
}

Represents a single OHLCV (Open, High, Low, Close, Volume) bar

Each bar represents a discrete time period of trading activity. A bar can also carry colors of its own and a host payload, stand for a single value (from_value), or hold a slot of the time axis without a value (whitespace).

Example

use chrono::Utc;
use egui_charts::model::Bar;

let bar = Bar::new(
    Utc::now(),
    100.0, // open
    105.0, // high
    98.0,  // low
    103.0, // close
    1000.0 // volume
);

assert!(bar.is_bullish()); // close > open

Fields

time: DateTime<Utc>

Timestamp of the bar. Read from JSON as an RFC 3339 time, or as a date alone ("2024-03-15"), which is midnight UTC of that day, the open of its day bar.

open: f64

Opening price

high: f64

Highest price during the period

low: f64

Lowest price during the period

close: f64

Closing price

volume: f64

Trading volume

colors: Option<Box<BarColors>>

Colours of this bar that replace the series’ colours, None for the series’ colours.

payload: Option<Arc<Value>>

Data of the host’s own attached to this bar. The chart does not read it; it comes back with the bar in the chart’s pointer and data events and in its bar lookups.

Implementations

impl Bar

pub fn new( time: DateTime<Utc>, open: f64, high: f64, low: f64, close: f64, volume: f64, ) -> Self

Creates a new bar

pub fn from_date( date: NaiveDate, open: f64, high: f64, low: f64, close: f64, volume: f64, ) -> Self

Creates a daily OHLCV bar from a calendar date, at midnight UTC, matching date-only JSON and CSV imports. The date is independent of the exchange’s time zone. The chart formats this UTC instant in its display time zone, which can show a different date (for example, the previous day at UTC-05:00).

Example

use chrono::NaiveDate;
use egui_charts::model::Bar;

let date = NaiveDate::from_ymd_opt(2024, 2, 29).unwrap();
let bar = Bar::from_date(date, 100.0, 105.0, 98.0, 103.0, 1000.0);
let point = Bar::from_value_on_date(date, 103.0);
let gap = Bar::whitespace_on_date(date);
assert_eq!(bar.time.to_rfc3339(), "2024-02-29T00:00:00+00:00");
assert_eq!(point.time, bar.time);
assert_eq!(gap.time, bar.time);
assert!(gap.is_whitespace());

pub fn from_value(time: DateTime<Utc>, value: f64) -> Self

A bar of a single value, such as a point of a line, area, baseline or column series: its open, high, low and close are value, its volume zero.

pub fn from_value_on_date(date: NaiveDate, value: f64) -> Self

A from_value bar on a calendar date, at midnight UTC. Date and display time zone conventions are those of from_date.

pub fn whitespace(time: DateTime<Utc>) -> Self

A bar without a value: it holds its slot on the time axis, so a gap such as a halted session stays visible and a time of another series has a slot, but nothing is drawn there and studies take it as a bar without a value. Its open, high, low, close and volume are NaN.

pub fn whitespace_on_date(date: NaiveDate) -> Self

A whitespace bar on a calendar date, at midnight UTC. Date and display time zone conventions are those of from_date.

pub fn is_whitespace(&self) -> bool

Whether this is a whitespace bar: open, high, low, close and volume are all NaN.

pub fn is_bullish(&self) -> bool

Returns true if this is a bullish bar (close > open)

pub fn is_bearish(&self) -> bool

Returns true if this is a bearish bar (close < open)

pub fn is_doji(&self, threshold: f64) -> bool

Returns true if this is a doji (open ≈ close)

Arguments

• threshold - Ratio of body to range below which it’s considered a doji

pub fn body_height(&self) -> f64

Returns the body height (absolute difference between open and close)

pub fn range(&self) -> f64

Returns the total range (high - low)

pub fn upper_wick(&self) -> f64

Returns the upper wick height

pub fn lower_wick(&self) -> f64

Returns the lower wick height

pub fn typical_price(&self) -> f64

Returns the typical price ((high + low + close) / 3)

Commonly used in technical analysis (e.g., VWAP, CCI)

pub fn weighted_close(&self) -> f64

Returns the weighted close ((high + low + close + close) / 4)

pub fn midpoint(&self) -> f64

Returns the midpoint price ((high + low) / 2)

pub fn avg_price(&self) -> f64

Returns the average price (OHLC / 4)

pub fn body_percentage(&self) -> f64

Returns the body as a percentage of the total range (0.0 to 1.0)

pub fn wick_ratio(&self) -> f64

Returns the ratio of upper wick to lower wick

Returns infinity if lower wick is zero.

pub fn change(&self) -> f64

Returns the price change (close - open)

pub fn change_percent(&self) -> f64

Returns the percentage change ((close - open) / |open| * 100), divided by the magnitude of the open so it has the sign of the change for a negative open too

pub fn body_top(&self) -> f64

Returns the top of the body (max of open and close)

pub fn body_bottom(&self) -> f64

Returns the bottom of the body (min of open and close)

Trait Implementations

impl CandlePatterns for Bar

fn is_hammer(&self) -> bool

Returns true if this is a hammer pattern

fn is_inverted_hammer(&self) -> bool

Returns true if this is an inverted hammer pattern

fn is_shooting_star(&self) -> bool

Returns true if this is a shooting star pattern

fn is_spinning_top(&self) -> bool

Returns true if this is a spinning top pattern

fn is_marubozu(&self) -> bool

Returns true if this is a marubozu (very long body, little to no wicks)

fn is_bullish_engulfing(&self, prev: &Bar) -> bool

Returns true if current bar engulfs the previous bar (bullish engulfing)

fn is_bearish_engulfing(&self, prev: &Bar) -> bool

Returns true if current bar engulfs the previous bar (bearish engulfing)

fn is_morning_star(&self, prev1: &Bar, prev2: &Bar) -> bool

Returns true if this forms a morning star pattern with two previous bars

fn is_evening_star(&self, prev1: &Bar, prev2: &Bar) -> bool

Returns true if this forms an evening star pattern with two previous bars

impl Clone for Bar

fn clone(&self) -> Bar

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Bar

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Bar

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Bar

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

Formats the value using the given formatter.

impl From<MetricPoint> for Bar

fn from(point: MetricPoint) -> Self

Converts to this type from the input type.

impl FromIterator<Bar> for BarData

fn from_iter<I: IntoIterator<Item = Bar>>(iter: I) -> Self

Creates a value from an iterator.

impl PartialEq for Bar

fn eq(&self, other: &Bar) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Bar

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Bar