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.

Backend Support

Backend	Supported
Plotly	Yes
Plotters	–

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.
• facet - An optional string slice specifying the column name to be used for faceting (creating multiple subplots).
• facet_config - An optional reference to a FacetConfig struct for customizing facet behavior (grid dimensions, scales, gaps, etc.).
• 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 plotlars::{Legend, Line, Mode, Plot, Rgb, ScatterPolar, Shape, Text};
use polars::prelude::*;

let dataset = LazyCsvReader::new(PlRefPath::new("data/product_comparison_polar.csv"))
    .finish()
    .unwrap()
    .collect()
    .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("Scatter Polar Plot")
            .font("Arial")
            .size(24)
    )
    .legend_title(
        Text::from("Products")
            .font("Arial")
            .size(14)
    )
    .legend(
        &Legend::new()
            .x(0.85)
            .y(0.95)
    )
    .build()
    .plot();

Implementations

impl ScatterPolar

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

impl ScatterPolar

pub fn try_new( data: &DataFrame, theta: &str, r: &str, group: Option<&str>, sort_groups_by: Option<fn(&str, &str) -> Ordering>, facet: Option<&str>, facet_config: Option<&FacetConfig>, mode: Option<Mode>, opacity: Option<f64>, fill: Option<Fill>, size: Option<usize>, color: Option<Rgb>, colors: Option<Vec<Rgb>>, shape: Option<Shape>, shapes: Option<Vec<Shape>>, width: Option<f64>, line: Option<LineStyle>, lines: Option<Vec<LineStyle>>, plot_title: Option<Text>, legend_title: Option<Text>, legend: Option<&Legend>, ) -> Result<Self, PlotlarsError>

pub fn try_builder<'f1, 'f2, 'f3, 'f4, 'f5, 'f6, 'f7>() -> ScatterPolarTryBuilder<'f1, 'f2, 'f3, 'f4, 'f5, 'f6, 'f7>

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 Plot for ScatterPolar

fn ir_traces(&self) -> &[TraceIR]

fn ir_layout(&self) -> &LayoutIR