Struct Histogram 

pub struct Histogram { /* private fields */ }

A structure representing a histogram.

The Histogram struct facilitates the creation and customization of histograms with various options for data selection, layout configuration, and aesthetic adjustments. It supports grouping of data, opacity settings, and customizable markers and colors.

Arguments

• data - A reference to the DataFrame containing the data to be plotted.
• x - A string slice specifying the column name to be used for the x-axis (independent variable).
• group - An optional string slice specifying the column name to be used for grouping data points.
• sort_groups_by - Optional comparator fn(&str, &str) -> std::cmp::Ordering to control group ordering. Groups are sorted lexically by default.
• opacity - An optional f64 value specifying the opacity of the plot markers (range: 0.0 to 1.0).
• color - An optional Rgb value specifying the color of the markers to be used for the plot. This is used when group is not specified.
• colors - An optional vector of Rgb values specifying the colors to be used for the plot. This is used when group is specified to differentiate between groups.
• 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.
• legend_title - An optional Text struct specifying the title of the legend.
• 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.
• legend - An optional reference to a Legend struct for customizing the legend of the plot (e.g., positioning, font, etc.).

Example

use polars::prelude::*;
use plotlars::{Axis, Histogram, Legend, Plot, Rgb, Text, TickDirection};

let dataset = LazyCsvReader::new(PlPath::new("data/penguins.csv"))
    .finish()
    .unwrap()
    .select([
        col("species"),
        col("sex").alias("gender"),
        col("flipper_length_mm").cast(DataType::Int16),
        col("body_mass_g").cast(DataType::Int16),
    ])
    .collect()
    .unwrap();

let axis = Axis::new()
    .show_line(true)
    .show_grid(true)
    .value_thousands(true)
    .tick_direction(TickDirection::OutSide);

Histogram::builder()
    .data(&dataset)
    .x("body_mass_g")
    .group("species")
    .opacity(0.5)
    .colors(vec![
        Rgb(255, 165, 0),
        Rgb(147, 112, 219),
        Rgb(46, 139, 87),
    ])
    .plot_title(
        Text::from("Histogram")
            .font("Arial")
            .size(18)
    )
    .x_title(
        Text::from("body mass (g)")
            .font("Arial")
            .size(15)
    )
    .y_title(
        Text::from("count")
            .font("Arial")
            .size(15)
    )
    .legend_title(
        Text::from("species")
            .font("Arial")
            .size(15)
    )
    .x_axis(&axis)
    .y_axis(&axis)
    .legend(
        &Legend::new()
            .x(0.9)
    )
    .build()
    .plot();

Implementations

impl Histogram

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

Examples found in repository

examples/histogram.rs (line 24)

fn main() {
    let dataset = LazyCsvReader::new(PlPath::new("data/penguins.csv"))
        .finish()
        .unwrap()
        .select([
            col("species"),
            col("sex").alias("gender"),
            col("flipper_length_mm").cast(DataType::Int16),
            col("body_mass_g").cast(DataType::Int16),
        ])
        .collect()
        .unwrap();

    let axis = Axis::new()
        .show_line(true)
        .show_grid(true)
        .value_thousands(true)
        .tick_direction(TickDirection::OutSide);

    Histogram::builder()
        .data(&dataset)
        .x("body_mass_g")
        .group("species")
        .opacity(0.5)
        .colors(vec![Rgb(255, 165, 0), Rgb(147, 112, 219), Rgb(46, 139, 87)])
        .plot_title(Text::from("Histogram").font("Arial").size(18))
        .x_title(Text::from("body mass (g)").font("Arial").size(15))
        .y_title(Text::from("count").font("Arial").size(15))
        .legend_title(Text::from("species").font("Arial").size(15))
        .x_axis(&axis)
        .y_axis(&axis)
        .legend(&Legend::new().x(0.9))
        .build()
        .plot();
}

Trait Implementations

impl Clone for Histogram

fn clone(&self) -> Histogram

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Serialize for Histogram

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

where __S: Serializer,

Serialize this value into the given Serde serializer.