Struct BarData 

pub struct BarData {
    pub bars: Vec<Bar>,
}

Container for multiple bars with utility methods

This container provides common operations over bar collections.

Example

use egui_charts::model::BarData;

let data = BarData::new();
assert!(data.is_empty());

Fields

bars: Vec<Bar>

Bars in caller-supplied order; construction does not sort or validate them.

Implementations

impl BarData

pub fn new() -> Self

Creates a new empty BarData

pub fn with_capacity(capacity: usize) -> Self

Creates BarData with pre-allocated capacity

pub fn from_bars(bars: Vec<Bar>) -> Self

Creates BarData from a vector of bars

pub fn push(&mut self, bar: Bar)

Adds a bar to the dataset

pub fn len(&self) -> usize

Returns the number of bars

pub fn is_empty(&self) -> bool

Returns true if there are no bars

pub fn clear(&mut self)

Clear all bars

pub fn first(&self) -> Option<&Bar>

Get the first bar

pub fn last(&self) -> Option<&Bar>

Get the last bar

pub fn get(&self, index: usize) -> Option<&Bar>

Get a bar by index

pub fn get_mut(&mut self, index: usize) -> Option<&mut Bar>

Get a mutable reference to a bar by index

pub fn iter(&self) -> impl Iterator<Item = &Bar>

Iterate over bars

pub fn min_price(&self) -> Option<f64>

Returns the min price (low) across all bars.

Non-finite values are skipped; None when no finite value remains.

pub fn max_price(&self) -> Option<f64>

Returns the max price (high) across all bars.

Non-finite values are skipped; None when no finite value remains.

pub fn price_range(&self) -> Option<(f64, f64)>

Returns the price range (max_high - min_low)

pub fn max_volume(&self) -> Option<f64>

Returns the max volume across all bars.

Non-finite values are skipped; None when no finite value remains.

pub fn total_volume(&self) -> f64

Returns the total volume across all bars

pub fn avg_volume(&self) -> Option<f64>

Returns the average volume across all bars

pub fn to_heikin_ashi(&self) -> Self

Converts regular OHLC bars to Heikin-Ashi bars

Heikin-Ashi is a Japanese candlestick technique that filters out market noise and highlights trends more clearly than traditional candlesticks.

Formula

• HA Close = (Open + High + Low + Close) / 4
• HA Open = (Previous HA Open + Previous HA Close) / 2
• HA High = Max(High, HA Open, HA Close)
• HA Low = Min(Low, HA Open, HA Close)

pub fn to_regular(&self) -> Self

Returns a clone of the bar data (for regular candlesticks)

This method exists for API consistency when switching between chart types.

pub fn slice(&self, start: usize, end: usize) -> &[Bar]

Get a slice of bars within an index range

impl BarData

pub fn from_csv(path: &str) -> Result<Self, Box<dyn Error + Send + Sync>>

Loads bars from a CSV file

Format

CSV format: ts,open,high,low,close,volume. The header row is required (any case, spaces around names ignored) and the columns must be in this order. Timestamps are in “YYYY-MM-DD HH:MM:SS” format (UTC), optionally with a fraction of a second, such as “2024-03-15 10:00:00.250”, or a date alone, “2024-03-15”, for midnight UTC of that day, the open of its day bar. A row of NaN values is a whitespace bar.

Example

use egui_charts::model::BarData;

let data = BarData::from_csv("data.csv").expect("Failed to load CSV");

pub fn to_csv(&self, path: &str) -> Result<(), Box<dyn Error + Send + Sync>>

Exports bars to a CSV file

Format

CSV format: ts,open,high,low,close,volume Timestamps are in “YYYY-MM-DD HH:MM:SS” format (UTC), with the fraction of a second when the bar’s time has one, such as “2024-03-15 10:00:00.250”

Example

use egui_charts::model::BarData;

let data = BarData::new();
data.to_csv("output.csv").expect("Failed to export CSV");

pub fn to_csv_string(&self) -> Result<String, Box<dyn Error + Send + Sync>>

Exports bars to a CSV string in memory

Format

CSV format: ts,open,high,low,close,volume Timestamps are in “YYYY-MM-DD HH:MM:SS” format (UTC), with the fraction of a second when the bar’s time has one, such as “2024-03-15 10:00:00.250”

Example

use egui_charts::model::BarData;

let data = BarData::new();
let csv = data.to_csv_string().expect("Failed to export CSV");
assert!(csv.starts_with("ts,"));

pub fn to_csv_with_indicators( &self, indicators: &[(String, Vec<f64>)], ) -> Result<String, Box<dyn Error + Send + Sync>>

Exports bars to a CSV string with indicator values alongside bar data

Format

CSV format: ts,open,high,low,close,volume,indicator_1,indicator_2,… Timestamps are in “YYYY-MM-DD HH:MM:SS” format (UTC), with the fraction of a second when the bar’s time has one, such as “2024-03-15 10:00:00.250”

Each indicator is a (name, values) pair where values is aligned to the bar data by index. Missing values (e.g. SMA warmup period) are empty strings.

Example

use egui_charts::model::BarData;

let data = BarData::new();
let indicators: Vec<(String, Vec<f64>)> = vec![
    ("SMA_20".to_string(), vec![]),
];
let csv = data.to_csv_with_indicators(&indicators)
    .expect("Failed to export CSV with indicators");
assert!(csv.starts_with("ts,"));

pub fn to_json(&self, path: &str) -> Result<(), Box<dyn Error + Send + Sync>>

Exports bars to a JSON file

Format

JSON array of bar objects with full ISO 8601 timestamp

Example

use egui_charts::model::BarData;

let data = BarData::new();
data.to_json("output.json").expect("Failed to export JSON");

pub fn to_json_string(&self) -> Result<String, Box<dyn Error + Send + Sync>>

Returns JSON string representation of the bars

Example

use egui_charts::model::BarData;

let data = BarData::new();
let json = data.to_json_string().expect("Failed to serialize");

pub fn from_json_string( json: &str, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Load bars from a JSON string

Example

use egui_charts::model::BarData;

let json = "[]";
let data = std::thread::spawn(move || BarData::from_json_string(json))
    .join().expect("Worker panicked").expect("Failed to parse");

pub fn from_json(path: &str) -> Result<Self, Box<dyn Error + Send + Sync>>

Load bars from a JSON file

Example

use egui_charts::model::BarData;

let data = BarData::from_json("data.json").expect("Failed to load");

Trait Implementations

impl Clone for BarData

fn clone(&self) -> BarData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BarData

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

Formats the value using the given formatter.

impl Default for BarData

fn default() -> BarData

Returns the “default value” for a type.

impl FromIterator<Bar> for BarData

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

Creates a value from an iterator.

impl Index<usize> for BarData

type Output = Bar

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for BarData

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl IntoIterator for BarData

type Item = Bar

The type of the elements being iterated over.

type IntoIter = IntoIter<Bar>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a BarData

type Item = &'a Bar

The type of the elements being iterated over.

type IntoIter = Iter<'a, Bar>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.