Struct PieChart 

pub struct PieChart { /* private fields */ }

A structure representing a pie chart.

The PieChart struct allows for the creation and customization of pie charts, supporting features such as labels, hole size for donut-style charts, slice pulling, rotation, and customizable plot titles. It is ideal for visualizing proportions and distributions in categorical data.

Arguments

• data - A reference to the DataFrame containing the data to be plotted.
• labels - A string slice specifying the column name to be used for slice labels.
• hole - An optional f64 value specifying the size of the hole in the center of the pie chart. A value of 0.0 creates a full pie chart, while a value closer to 1.0 creates a thinner ring.
• pull - An optional f64 value specifying the fraction by which each slice should be pulled out from the center.
• rotation - An optional f64 value specifying the starting angle (in degrees) of the first slice.
• plot_title - An optional Text struct specifying the title of the plot.

Example

Basic Pie Chart with Customization

use polars::prelude::*;
use plotlars::{PieChart, Plot, Text};

let dataset = LazyCsvReader::new(PlPath::new("data/penguins.csv"))
    .finish()
    .unwrap()
    .select([
        col("species"),
    ])
    .collect()
    .unwrap();

PieChart::builder()
    .data(&dataset)
    .labels("species")
    .hole(0.4)
    .pull(0.01)
    .rotation(20.0)
    .plot_title(
        Text::from("Pie Chart")
            .font("Arial")
            .size(18)
    )
    .build()
    .plot();

Implementations

impl PieChart

pub fn builder<'f1, 'f2>() -> PieChartBuilder<'f1, 'f2>

Examples found in repository

examples/piechart.rs (line 13)

fn main() {
    let dataset = LazyCsvReader::new(PlPath::new("data/penguins.csv"))
        .finish()
        .unwrap()
        .select([col("species")])
        .collect()
        .unwrap();

    PieChart::builder()
        .data(&dataset)
        .labels("species")
        .hole(0.4)
        .pull(0.01)
        .rotation(20.0)
        .plot_title(Text::from("Pie Chart").font("Arial").size(18))
        .build()
        .plot();
}

Trait Implementations

impl Clone for PieChart

fn clone(&self) -> PieChart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl PlotHelper for PieChart

fn get_layout(&self) -> &LayoutPlotly

fn get_traces(&self) -> &Vec<Box<dyn Trace + 'static>>

impl Serialize for PieChart

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

where __S: Serializer,

Serialize this value into the given Serde serializer.