Struct Scatter3dPlot

pub struct Scatter3dPlot { /* private fields */ }

A structure representing a 3D scatter plot.

The Scatter3dPlot struct is designed to create and customize 3D scatter plots with options for data selection, grouping, layout configuration, and aesthetic adjustments. It supports visual differentiation in data groups through varied marker shapes, colors, sizes, opacity levels, and comprehensive layout customization, including titles, axis labels, and legends.

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).
• y - A string slice specifying the column name to be used for the y-axis (dependent variable).
• z - A string slice specifying the column name to be used for the z-axis, adding a third dimension to the scatter plot.
• group - An optional string slice specifying the column name used for grouping data points by category.
• opacity - An optional f64 value specifying the opacity of the plot markers (range: 0.0 to 1.0).
• size - An optional usize specifying the size of the markers.
• color - An optional Rgb value for marker color when group is not specified.
• colors - An optional vector of Rgb values specifying colors for markers when group is specified, enhancing group distinction.
• shape - An optional Shape specifying the shape of markers when group is not specified.
• shapes - An optional vector of Shape values defining multiple marker shapes for different groups.
• plot_title - An optional Text struct specifying the plot title.
• x_title - An optional Text struct for the x-axis title.
• y_title - An optional Text struct for the y-axis title.
• z_title - An optional Text struct for the z-axis title.
• legend_title - An optional Text struct specifying the legend title.
• x_axis - An optional reference to an Axis struct for custom x-axis settings.
• y_axis - An optional reference to an Axis struct for custom y-axis settings.
• z_axis - An optional reference to an Axis struct for custom z-axis settings, adding depth perspective.
• legend - An optional reference to a Legend struct for legend customization, including position and font settings.

Example

use plotlars::{Legend, Plot, Rgb, Scatter3dPlot, Shape};

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

Scatter3dPlot::builder()
    .data(&dataset)
    .x("body_mass_g")
    .y("flipper_length_mm")
    .z("bill_length_mm")
    .group("species")
    .opacity(0.25)
    .size(8)
    .colors(vec![
        Rgb(178, 34, 34),
        Rgb(65, 105, 225),
        Rgb(255, 140, 0),
    ])
    .shapes(vec![
        Shape::Circle,
        Shape::Square,
        Shape::Diamond,
    ])
    .plot_title("Scatter Plot")
    .legend(
        &Legend::new()
            .x(0.6)
    )
    .build()
    .plot();

Implementations

impl Scatter3dPlot

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

Trait Implementations

impl Clone for Scatter3dPlot

fn clone(&self) -> Scatter3dPlot

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Serialize for Scatter3dPlot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.