Struct Direction

pub struct Direction { /* private fields */ }

A structure representing the styling for candlestick directions (increasing/decreasing).

The Direction struct allows customization of how candlestick lines appear when the closing price is higher (increasing) or lower (decreasing) than the opening price. This includes setting the line color and width for the candlesticks.

Note: Fill color is not currently supported by the underlying plotly library.

Example

use plotlars::{CandlestickPlot, Direction, Plot, Rgb};
use polars::prelude::*;

let dates = vec!["2024-01-01", "2024-01-02", "2024-01-03"];
let open_prices = vec![100.0, 102.5, 101.0];
let high_prices = vec![103.0, 104.0, 103.5];
let low_prices = vec![99.0, 101.5, 100.0];
let close_prices = vec![102.5, 101.0, 103.5];

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

let increasing = Direction::new()
    .line_color(Rgb(0, 150, 255))
    .line_width(2.0);

let decreasing = Direction::new()
    .line_color(Rgb(200, 0, 100))
    .line_width(2.0);

CandlestickPlot::builder()
    .data(&stock_data)
    .dates("date")
    .open("open")
    .high("high")
    .low("low")
    .close("close")
    .increasing(&increasing)
    .decreasing(&decreasing)
    .build()
    .plot();

Implementations

impl Direction

pub fn new() -> Self

Creates a new Direction instance with default settings.

Returns

A new Direction instance with no customizations applied.

pub fn line_color(self, color: Rgb) -> Self

Sets the line color for the candlestick outline and wicks.

Arguments

• color - An Rgb color for the candlestick lines.

Returns

The modified Direction instance for method chaining.

pub fn line_width(self, width: f64) -> Self

Sets the line width for the candlestick outline and wicks.

Arguments

• width - The width of the candlestick lines in pixels.

Returns

The modified Direction instance for method chaining.

Trait Implementations

impl Clone for Direction

fn clone(&self) -> Direction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Direction

fn default() -> Direction

Returns the “default value” for a type.