Struct ScatterPolar 

pub struct ScatterPolar { /* private fields */ }

A structure representing a scatter polar plot.

The ScatterPolar struct facilitates the creation and customization of polar scatter plots with various options for data selection, grouping, layout configuration, and aesthetic adjustments. It supports grouping of data, customization of marker shapes, colors, sizes, line styles, and comprehensive layout customization including titles and legends.

Arguments

• data - A reference to the DataFrame containing the data to be plotted.
• theta - A string slice specifying the column name to be used for the angular coordinates (in degrees).
• r - A string slice specifying the column name to be used for the radial coordinates.
• 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.
• mode - An optional Mode specifying the drawing mode (lines, markers, or both). Defaults to markers.
• opacity - An optional f64 value specifying the opacity of the plot elements (range: 0.0 to 1.0).
• fill - An optional Fill type specifying how to fill the area under the trace.
• size - An optional usize specifying the size of the markers.
• color - An optional Rgb value specifying the color of the markers. This is used when group is not specified.
• colors - An optional vector of Rgb values specifying the colors for the markers. This is used when group is specified to differentiate between groups.
• shape - An optional Shape specifying the shape of the markers. This is used when group is not specified.
• shapes - An optional vector of Shape values specifying multiple shapes for the markers when plotting multiple groups.
• width - An optional f64 specifying the width of the lines.
• line - An optional LineStyle specifying the style of the line (e.g., solid, dashed).
• lines - An optional vector of LineStyle enums specifying the styles of lines for multiple traces.
• plot_title - An optional Text struct specifying the title of the plot.
• legend_title - An optional Text struct specifying the title of the legend.
• 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::{Legend, Line, Mode, Plot, Rgb, ScatterPolar, Shape, Text};

// Create sample data - comparing two products across multiple metrics
let angles = vec![
    0., 60., 120., 180., 240., 300., 360., // Product A
    0., 60., 120., 180., 240., 300., 360., // Product B
];
let values = vec![
    7.0, 8.5, 6.0, 5.5, 9.0, 8.0, 7.0, // Product A values
    6.0, 7.0, 8.0, 9.0, 6.5, 7.5, 6.0, // Product B values
];
let products = vec![
    "Product A", "Product A", "Product A", "Product A",
    "Product A", "Product A", "Product A",
    "Product B", "Product B", "Product B", "Product B",
    "Product B", "Product B", "Product B",
];

let dataset = DataFrame::new(vec![
    Column::new("angle".into(), angles),
    Column::new("score".into(), values),
    Column::new("product".into(), products),
])
.unwrap();

ScatterPolar::builder()
    .data(&dataset)
    .theta("angle")
    .r("score")
    .group("product")
    .mode(Mode::LinesMarkers)
    .colors(vec![
        Rgb(255, 99, 71),
        Rgb(60, 179, 113),
    ])
    .shapes(vec![Shape::Circle, Shape::Square])
    .lines(vec![Line::Solid, Line::Dash])
    .width(2.5)
    .size(8)
    .plot_title(Text::from("Product Comparison").font("Arial").size(24))
    .legend_title(Text::from("Products").font("Arial").size(14))
    .legend(&Legend::new().x(0.65).y(0.75))
    .build()
    .plot();

Implementations

impl ScatterPolar

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

Examples found in repository

examples/scatterpolar.rs (line 29)

fn basic_scatter_polar() {
    // Create sample data - wind direction and speed
    let directions = vec![0., 45., 90., 135., 180., 225., 270., 315., 360.];
    let speeds = vec![5.0, 7.5, 10.0, 8.5, 6.0, 4.5, 3.0, 2.5, 5.0];

    let dataset = DataFrame::new(vec![
        Column::new("direction".into(), directions),
        Column::new("speed".into(), speeds),
    ])
    .unwrap();

    ScatterPolar::builder()
        .data(&dataset)
        .theta("direction")
        .r("speed")
        .mode(Mode::Markers)
        .color(Rgb(65, 105, 225))
        .shape(Shape::Circle)
        .size(10)
        .plot_title(Text::from("Wind Speed by Direction").font("Arial").size(20))
        .build()
        .plot();
}

fn styled_scatter_polar() {
    // Create sample data - radar chart style
    let categories = vec![0., 72., 144., 216., 288., 360.];
    let performance = vec![8.0, 6.5, 7.0, 9.0, 5.5, 8.0];

    let dataset = DataFrame::new(vec![
        Column::new("category".into(), categories),
        Column::new("performance".into(), performance),
    ])
    .unwrap();

    ScatterPolar::builder()
        .data(&dataset)
        .theta("category")
        .r("performance")
        .mode(Mode::LinesMarkers)
        .color(Rgb(255, 0, 0))
        .shape(Shape::Diamond)
        .line(Line::Solid)
        .width(3.0)
        .size(12)
        .opacity(0.8)
        .plot_title(
            Text::from("Performance Radar Chart")
                .font("Arial")
                .size(22)
                .x(0.5),
        )
        .build()
        .plot();
}

fn grouped_scatter_polar() {
    // Create sample data - comparing two products across multiple metrics
    let angles = vec![
        0., 60., 120., 180., 240., 300., 360., // Product A
        0., 60., 120., 180., 240., 300., 360., // Product B
    ];
    let values = vec![
        7.0, 8.5, 6.0, 5.5, 9.0, 8.0, 7.0, // Product A values
        6.0, 7.0, 8.0, 9.0, 6.5, 7.5, 6.0, // Product B values
    ];
    let products = vec![
        "Product A",
        "Product A",
        "Product A",
        "Product A",
        "Product A",
        "Product A",
        "Product A",
        "Product B",
        "Product B",
        "Product B",
        "Product B",
        "Product B",
        "Product B",
        "Product B",
    ];

    let dataset = DataFrame::new(vec![
        Column::new("angle".into(), angles),
        Column::new("score".into(), values),
        Column::new("product".into(), products),
    ])
    .unwrap();

    ScatterPolar::builder()
        .data(&dataset)
        .theta("angle")
        .r("score")
        .group("product")
        .mode(Mode::LinesMarkers)
        .colors(vec![
            Rgb(255, 99, 71),  // Tomato red
            Rgb(60, 179, 113), // Medium sea green
        ])
        .shapes(vec![Shape::Circle, Shape::Square])
        .lines(vec![Line::Solid, Line::Dash])
        .width(2.5)
        .size(8)
        .plot_title(Text::from("Product Comparison").font("Arial").size(24))
        .legend_title(Text::from("Products").font("Arial").size(14))
        .legend(&Legend::new().x(0.85).y(0.95))
        .build()
        .plot();
}

fn filled_scatter_polar() {
    // Create sample data - filled area chart
    let angles: Vec<f64> = (0..=360).step_by(10).map(|x| x as f64).collect();
    let radii: Vec<f64> = angles
        .iter()
        .map(|&angle| 5.0 + 3.0 * (angle * std::f64::consts::PI / 180.0).sin())
        .collect();

    let dataset = DataFrame::new(vec![
        Column::new("angle".into(), angles),
        Column::new("radius".into(), radii),
    ])
    .unwrap();

    ScatterPolar::builder()
        .data(&dataset)
        .theta("angle")
        .r("radius")
        .mode(Mode::Lines)
        .fill(Fill::ToSelf)
        .color(Rgb(135, 206, 250))
        .line(Line::Solid)
        .width(2.0)
        .opacity(0.6)
        .plot_title(Text::from("Filled Polar Area Chart").font("Arial").size(20))
        .build()
        .plot();
}

Trait Implementations

impl Clone for ScatterPolar

fn clone(&self) -> ScatterPolar

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl PlotHelper for ScatterPolar

fn get_layout(&self) -> &LayoutPlotly

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

impl Serialize for ScatterPolar

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

where __S: Serializer,

Serialize this value into the given Serde serializer.