Struct OhlcPlot 

pub struct OhlcPlot { /* private fields */ }

A structure representing an OHLC (Open-High-Low-Close) financial chart.

The OhlcPlot struct facilitates the creation and customization of OHLC charts commonly used for visualizing financial data such as stock prices. It supports multiple OHLC series, custom styling for increasing/decreasing values, hover information, and comprehensive layout customization including range selectors and sliders for interactive time navigation.

Arguments

• data - A reference to the DataFrame containing the data to be plotted.
• dates - A string slice specifying the column name for dates/timestamps.
• open - A string slice specifying the column name for opening values.
• high - A string slice specifying the column name for high values.
• low - A string slice specifying the column name for low values.
• close - A string slice specifying the column name for closing values.
• tick_width - An optional f64 specifying the width of the open/close ticks (0-1 range).
• plot_title - An optional Text struct specifying the title of the plot.
• x_title - An optional Text struct specifying the title of the x-axis.
• y_title - An optional Text struct specifying the title of the y-axis.
• x_axis - An optional reference to an Axis struct for customizing the x-axis.
• y_axis - An optional reference to an Axis struct for customizing the y-axis.

Examples

use plotlars::{Axis, OhlcPlot, Plot};
use polars::prelude::*;

let dates = vec![
    "2024-01-01", "2024-01-02", "2024-01-03", "2024-01-04", "2024-01-05",
];

let open_prices = vec![100.0, 102.5, 101.0, 103.5, 105.0];
let high_prices = vec![103.0, 104.0, 103.5, 106.0, 107.5];
let low_prices = vec![99.0, 101.5, 100.0, 102.5, 104.0];
let close_prices = vec![102.5, 101.0, 103.5, 105.0, 104.5];

let stock_data = df! {
    "date" => dates,
    "open" => open_prices,
    "high" => high_prices,
    "low" => low_prices,
    "close" => close_prices,
}
.unwrap();

OhlcPlot::builder()
    .data(&stock_data)
    .dates("date")
    .open("open")
    .high("high")
    .low("low")
    .close("close")
    .plot_title("Stock Price - Custom Axes")
    .y_title("Price ($)")
    .y_axis(&Axis::new().show_axis(true))
    .build()
    .plot();

Implementations

impl OhlcPlot

pub fn builder<'f1, 'f2, 'f3, 'f4, 'f5, 'f6, 'f7, 'f8>() -> OhlcPlotBuilder<'f1, 'f2, 'f3, 'f4, 'f5, 'f6, 'f7, 'f8>

Examples found in repository

examples/ohlc.rs (line 58)

fn main() {
    // Create sample OHLC data
    let dates = vec![
        "2024-01-01",
        "2024-01-02",
        "2024-01-03",
        "2024-01-04",
        "2024-01-05",
        "2024-01-08",
        "2024-01-09",
        "2024-01-10",
        "2024-01-11",
        "2024-01-12",
        "2024-01-15",
        "2024-01-16",
        "2024-01-17",
        "2024-01-18",
        "2024-01-19",
        "2024-01-22",
        "2024-01-23",
        "2024-01-24",
        "2024-01-25",
        "2024-01-26",
    ];

    let open_prices = vec![
        100.0, 102.5, 101.0, 103.5, 105.0, 104.5, 106.0, 105.5, 107.0, 108.5, 108.0, 110.0, 109.5,
        111.0, 112.5, 112.0, 113.5, 113.0, 114.5, 115.0,
    ];

    let high_prices = vec![
        103.0, 104.0, 103.5, 106.0, 107.5, 107.0, 108.5, 108.0, 109.5, 111.0, 110.5, 112.5, 112.0,
        113.5, 115.0, 114.5, 116.0, 115.5, 117.0, 117.5,
    ];

    let low_prices = vec![
        99.0, 101.5, 100.0, 102.5, 104.0, 103.5, 105.0, 104.5, 106.0, 107.5, 107.0, 109.0, 108.5,
        110.0, 111.5, 111.0, 112.5, 112.0, 113.5, 114.0,
    ];

    let close_prices = vec![
        102.5, 101.0, 103.5, 105.0, 104.5, 106.0, 105.5, 107.0, 108.5, 108.0, 110.0, 109.5, 111.0,
        112.5, 112.0, 113.5, 113.0, 114.5, 115.0, 116.5,
    ];

    let stock_data = df! {
        "date" => dates,
        "open" => open_prices,
        "high" => high_prices,
        "low" => low_prices,
        "close" => close_prices,
    }
    .unwrap();

    OhlcPlot::builder()
        .data(&stock_data)
        .dates("date")
        .open("open")
        .high("high")
        .low("low")
        .close("close")
        .plot_title("Stock Price")
        .y_title("Price ($)")
        .y_axis(&Axis::new().show_axis(true))
        .build()
        .plot();
}

Trait Implementations

impl Clone for OhlcPlot

fn clone(&self) -> OhlcPlot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Serialize for OhlcPlot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.