Struct SubplotGrid 

pub struct SubplotGrid { /* private fields */ }

A structure representing a subplot grid layout.

The SubplotGrid struct facilitates the creation of multi-plot layouts arranged in a grid configuration. Plots are automatically arranged in rows and columns in row-major order (left-to-right, top-to-bottom). Each subplot retains its own title, axis labels, and legend, providing flexibility for displaying multiple related visualizations in a single figure.

Features

• Automatic grid layout with configurable rows and columns
• Individual subplot titles (extracted from plot titles)
• Independent axis labels for each subplot
• Configurable horizontal and vertical spacing
• Overall figure title
• Sparse grid support (fewer plots than grid capacity)

Implementations

impl SubplotGrid

pub fn regular<'f1, 'f2>() -> SubplotGridRegularBuilder<'f1, 'f2>

Creates a subplot grid layout.

Arranges plots in a row * column grid with automatic positioning. Plots are placed in row-major order (left-to-right, top-to-bottom). Each subplot retains its individual title (from the plot’s plot_title), axis labels, and legend.

Arguments

• plots - Vector of plot references to arrange in the grid. Plots are positioned in row-major order.
• rows - Number of rows in the grid (default: 1).
• cols - Number of columns in the grid (default: 1).
• title - Overall title for the entire subplot figure (optional).
• h_gap - Horizontal spacing between columns (range: 0.0 to 1.0, default: 0.1).
• v_gap - Vertical spacing between rows (range: 0.0 to 1.0, default: 0.1).

Examples found in repository

examples/plotly_subplot_grid.rs (line 128)

fn regular_grid_example() {
    let dataset1 = CsvReader::new("data/animal_statistics.csv")
        .finish()
        .unwrap();

    let plot1 = BarPlot::builder()
        .data(&dataset1)
        .labels("animal")
        .values("value")
        .orientation(Orientation::Vertical)
        .group("gender")
        .sort_groups_by(|a, b| a.len().cmp(&b.len()))
        .error("error")
        .colors(vec![Rgb(255, 127, 80), Rgb(64, 224, 208)])
        .plot_title(Text::from("Bar Plot").x(-0.05).y(1.35).size(14))
        .y_title(Text::from("value").x(-0.055).y(0.76))
        .x_title(Text::from("animal").x(0.97).y(-0.2))
        .legend(
            &Legend::new()
                .orientation(Orientation::Horizontal)
                .x(0.4)
                .y(1.2),
        )
        .build();

    let dataset2 = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .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)
        .tick_direction(TickDirection::OutSide)
        .value_thousands(true);

    let plot2 = ScatterPlot::builder()
        .data(&dataset2)
        .x("body_mass_g")
        .y("flipper_length_mm")
        .group("species")
        .sort_groups_by(|a, b| {
            if a.len() == b.len() {
                a.cmp(b)
            } else {
                a.len().cmp(&b.len())
            }
        })
        .opacity(0.5)
        .size(12)
        .colors(vec![Rgb(178, 34, 34), Rgb(65, 105, 225), Rgb(255, 140, 0)])
        .shapes(vec![Shape::Circle, Shape::Square, Shape::Diamond])
        .plot_title(Text::from("Scatter Plot").x(-0.075).y(1.35).size(14))
        .x_title(Text::from("body mass (g)").y(-0.4))
        .y_title(Text::from("flipper length (mm)").x(-0.078).y(0.5))
        .legend_title("species")
        .x_axis(&axis.clone().value_range(2500.0, 6500.0))
        .y_axis(&axis.clone().value_range(170.0, 240.0))
        .legend(&Legend::new().x(0.98).y(0.95))
        .build();

    let dataset3 = CsvReader::new("data/debilt_2023_temps.csv")
        .has_header(true)
        .try_parse_dates(true)
        .finish()
        .unwrap()
        .lazy()
        .with_columns(vec![
            (col("tavg") / lit(10)).alias("avg"),
            (col("tmin") / lit(10)).alias("min"),
            (col("tmax") / lit(10)).alias("max"),
        ])
        .collect()
        .unwrap();

    let plot3 = TimeSeriesPlot::builder()
        .data(&dataset3)
        .x("date")
        .y("avg")
        .additional_series(vec!["min", "max"])
        .colors(vec![Rgb(128, 128, 128), Rgb(0, 122, 255), Rgb(255, 128, 0)])
        .lines(vec![Line::Solid, Line::Dot, Line::Dot])
        .plot_title(Text::from("Time Series Plot").x(-0.05).y(1.35).size(14))
        .y_title(Text::from("temperature (ºC)").x(-0.055).y(0.6))
        .legend(&Legend::new().x(0.9).y(1.25))
        .build();

    let plot4 = BoxPlot::builder()
        .data(&dataset2)
        .labels("species")
        .values("body_mass_g")
        .orientation(Orientation::Vertical)
        .group("gender")
        .box_points(true)
        .point_offset(-1.5)
        .jitter(0.01)
        .opacity(0.1)
        .colors(vec![Rgb(0, 191, 255), Rgb(57, 255, 20), Rgb(255, 105, 180)])
        .plot_title(Text::from("Box Plot").x(-0.075).y(1.35).size(14))
        .x_title(Text::from("species").y(-0.3))
        .y_title(Text::from("body mass (g)").x(-0.08).y(0.5))
        .legend_title(Text::from("gender").size(12))
        .y_axis(&Axis::new().value_thousands(true))
        .legend(&Legend::new().x(1.0))
        .build();

    SubplotGrid::regular()
        .plots(vec![&plot1, &plot2, &plot3, &plot4])
        .rows(2)
        .cols(2)
        .v_gap(0.4)
        .title(
            Text::from("Regular Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

fn irregular_grid_example() {
    let dataset1 = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .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);

    let plot1 = Histogram::builder()
        .data(&dataset1)
        .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").x(0.0).y(1.35).size(14))
        .x_title(Text::from("body mass (g)").x(0.94).y(-0.35))
        .y_title(Text::from("count").x(-0.062).y(0.83))
        .x_axis(&axis)
        .y_axis(&axis)
        .legend_title(Text::from("species"))
        .legend(&Legend::new().x(0.87).y(1.2))
        .build();

    let dataset2 = CsvReader::new("data/stock_prices.csv").finish().unwrap();

    let increasing = Direction::new()
        .line_color(Rgb(0, 200, 100))
        .line_width(0.5);

    let decreasing = Direction::new()
        .line_color(Rgb(200, 50, 50))
        .line_width(0.5);

    let plot2 = CandlestickPlot::builder()
        .data(&dataset2)
        .dates("date")
        .open("open")
        .high("high")
        .low("low")
        .close("close")
        .increasing(&increasing)
        .decreasing(&decreasing)
        .whisker_width(0.1)
        .plot_title(Text::from("Candlestick").x(0.0).y(1.35).size(14))
        .y_title(Text::from("price ($)").x(-0.06).y(0.76))
        .y_axis(&Axis::new().show_axis(true).show_grid(true))
        .build();

    let dataset3 = CsvReader::new("data/heatmap.csv").finish().unwrap();

    let plot3 = HeatMap::builder()
        .data(&dataset3)
        .x("x")
        .y("y")
        .z("z")
        .color_bar(
            &ColorBar::new()
                .value_exponent(ValueExponent::None)
                .separate_thousands(true)
                .tick_length(5)
                .tick_step(5000.0),
        )
        .plot_title(Text::from("Heat Map").x(0.0).y(1.35).size(14))
        .color_scale(Palette::Viridis)
        .build();

    SubplotGrid::irregular()
        .plots(vec![
            (&plot1, 0, 0, 1, 1),
            (&plot2, 0, 1, 1, 1),
            (&plot3, 1, 0, 1, 2),
        ])
        .rows(2)
        .cols(2)
        .v_gap(0.35)
        .h_gap(0.05)
        .title(
            Text::from("Irregular Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

fn mixed_grid_example() {
    // 2D cartesian scatter (baseline)
    let penguins = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .select([
            col("species"),
            col("bill_length_mm"),
            col("flipper_length_mm"),
            col("body_mass_g"),
        ])
        .collect()
        .unwrap();

    let scatter_2d = ScatterPlot::builder()
        .data(&penguins)
        .x("bill_length_mm")
        .y("flipper_length_mm")
        .group("species")
        .opacity(0.65)
        .size(10)
        .plot_title(Text::from("Penguins 2D").y(1.3))
        .build();

    // 3D scene subplot
    let scatter_3d = Scatter3dPlot::builder()
        .data(&penguins)
        .x("bill_length_mm")
        .y("flipper_length_mm")
        .z("body_mass_g")
        .group("species")
        .opacity(0.35)
        .size(6)
        .plot_title(Text::from("Penguins 3D").y(1.45))
        .build();

    // Polar subplot
    let polar_df = CsvReader::new("data/product_comparison_polar.csv")
        .finish()
        .unwrap();

    let polar = ScatterPolar::builder()
        .data(&polar_df)
        .theta("angle")
        .r("score")
        .group("product")
        .mode(Mode::LinesMarkers)
        .size(10)
        .plot_title(Text::from("Product Comparison (Polar)").y(1.5).x(0.72))
        .legend(&Legend::new().x(0.8))
        .build();

    // Domain-based subplot (Sankey)
    let sankey_df = CsvReader::new("data/energy_transition.csv")
        .finish()
        .unwrap();

    let sankey = SankeyDiagram::builder()
        .data(&sankey_df)
        .sources("source")
        .targets("target")
        .values("value")
        .orientation(Orientation::Horizontal)
        .arrangement(Arrangement::Freeform)
        .plot_title(Text::from("Energy Flow").y(1.2))
        .build();

    // Mapbox subplot
    let map_df = CsvReader::new("data/cities.csv").finish().unwrap();

    let scatter_map = ScatterMap::builder()
        .data(&map_df)
        .latitude("latitude")
        .longitude("longitude")
        .group("city")
        .zoom(4)
        .center([50.0, 5.0])
        .opacity(0.8)
        .plot_title(Text::from("Cities (Mapbox)").y(1.2))
        .build();

    // Geo subplot
    let geo_df = CsvReader::new("data/world_cities.csv").finish().unwrap();

    let scatter_geo = ScatterGeo::builder()
        .data(&geo_df)
        .lat("lat")
        .lon("lon")
        .group("continent")
        .mode(Mode::Markers)
        .size(10)
        .color(Rgb(255, 140, 0))
        .shape(Shape::Circle)
        .plot_title(Text::from("Global Cities (Geo)").x(0.65).y(1.2))
        .legend(&Legend::new().x(0.8))
        .build();

    SubplotGrid::regular()
        .plots(vec![
            &scatter_2d,
            &scatter_3d,
            &polar,
            &sankey,
            &scatter_map,
            &scatter_geo,
        ])
        .rows(2)
        .cols(3)
        .h_gap(0.12)
        .v_gap(0.22)
        .title(
            Text::from("Mixed Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

examples/plotly_dimensions.rs (line 136)

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

    let temperature_dataset = CsvReader::new("data/debilt_2023_temps.csv")
        .has_header(true)
        .try_parse_dates(true)
        .finish()
        .unwrap()
        .lazy()
        .with_columns(vec![
            (col("tavg") / lit(10)).alias("tavg"),
            (col("tmin") / lit(10)).alias("tmin"),
            (col("tmax") / lit(10)).alias("tmax"),
        ])
        .collect()
        .unwrap();

    let animals_dataset = CsvReader::new("data/animal_statistics.csv")
        .finish()
        .unwrap();

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

    let plot1 = TimeSeriesPlot::builder()
        .data(&temperature_dataset)
        .x("date")
        .y("tavg")
        .additional_series(vec!["tmin", "tmax"])
        .colors(vec![Rgb(128, 128, 128), Rgb(0, 122, 255), Rgb(255, 128, 0)])
        .lines(vec![Line::Solid, Line::Dot, Line::Dot])
        .plot_title(
            Text::from("De Bilt Temperature 2023")
                .font("Arial Black")
                .size(16),
        )
        .y_title(Text::from("temperature (°C)").size(13).x(-0.08))
        // .legend_title(Text::from("Measure").size(12))
        .legend(&Legend::new().x(0.1).y(0.9))
        .build();

    let plot2 = ScatterPlot::builder()
        .data(&penguins_dataset)
        .x("body_mass_g")
        .y("flipper_length_mm")
        .group("species")
        .sort_groups_by(|a, b| {
            if a.len() == b.len() {
                a.cmp(b)
            } else {
                a.len().cmp(&b.len())
            }
        })
        .opacity(0.6)
        .size(10)
        .colors(vec![Rgb(178, 34, 34), Rgb(65, 105, 225), Rgb(255, 140, 0)])
        .shapes(vec![Shape::Circle, Shape::Square, Shape::Diamond])
        .plot_title(
            Text::from("Penguin Morphology")
                .font("Arial Black")
                .size(16),
        )
        .x_title(Text::from("body mass (g)").size(13))
        .y_title(Text::from("flipper length (mm)").size(13).x(-0.11))
        .legend_title(Text::from("Species").size(12))
        .x_axis(&axis.clone().value_range(2500.0, 6500.0))
        .y_axis(&axis.clone().value_range(170.0, 240.0))
        .legend(&Legend::new().x(0.85).y(0.4))
        .build();

    let plot3 = BarPlot::builder()
        .data(&animals_dataset)
        .labels("animal")
        .values("value")
        .orientation(Orientation::Vertical)
        .group("gender")
        .sort_groups_by(|a, b| a.len().cmp(&b.len()))
        .error("error")
        .colors(vec![Rgb(255, 127, 80), Rgb(64, 224, 208)])
        .plot_title(Text::from("Animal Statistics").font("Arial Black").size(16))
        .x_title(Text::from("animal").size(13))
        .y_title(Text::from("value").size(13))
        .legend_title(Text::from("Gender").size(12))
        .legend(
            &Legend::new()
                .orientation(Orientation::Horizontal)
                .x(0.35)
                .y(0.9),
        )
        .build();

    let plot4 = BoxPlot::builder()
        .data(&penguins_dataset)
        .labels("species")
        .values("body_mass_g")
        .orientation(Orientation::Vertical)
        .group("gender")
        .box_points(true)
        .point_offset(-1.5)
        .jitter(0.01)
        .opacity(0.15)
        .colors(vec![Rgb(0, 191, 255), Rgb(57, 255, 20), Rgb(255, 105, 180)])
        .plot_title(
            Text::from("Body Mass Distribution")
                .font("Arial Black")
                .size(16),
        )
        .x_title(Text::from("species").size(13))
        .y_title(Text::from("body mass (g)").size(13).x(-0.12))
        .legend_title(Text::from("Gender").size(12))
        .y_axis(&Axis::new().value_thousands(true))
        .legend(&Legend::new().x(0.85).y(0.9))
        .build();

    let dimensions = Dimensions::new().width(1400).height(850).auto_size(false);

    SubplotGrid::regular()
        .plots(vec![&plot1, &plot2, &plot3, &plot4])
        .rows(2)
        .cols(2)
        .v_gap(0.3)
        .h_gap(0.2)
        .dimensions(&dimensions)
        .title(
            Text::from("Scientific Data Visualization Dashboard")
                .size(26)
                .font("Arial Black"),
        )
        .build()
        .plot();
}

pub fn irregular<'f1, 'f2>() -> SubplotGridIrregularBuilder<'f1, 'f2>

Creates an irregular grid subplot layout with custom row/column spanning.

Allows plots to span multiple rows and/or columns, enabling dashboard-style layouts and asymmetric grid arrangements. Each plot explicitly specifies its position and span.

Arguments

• plots - Vector of tuples (plot, row, col, rowspan, colspan) where:
  • plot: Reference to the plot
  • row: Starting row (0-indexed)
  • col: Starting column (0-indexed)
  • rowspan: Number of rows to span (minimum 1)
  • colspan: Number of columns to span (minimum 1)
• rows - Total number of rows in the grid (default: 1).
• cols - Total number of columns in the grid (default: 1).
• title - Overall title for the subplot figure (optional).
• h_gap - Horizontal spacing between columns (range: 0.0 to 1.0, default: 0.1).
• v_gap - Vertical spacing between rows (range: 0.0 to 1.0, default: 0.1).

Examples found in repository

examples/plotly_subplot_grid.rs (line 221)

fn irregular_grid_example() {
    let dataset1 = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .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);

    let plot1 = Histogram::builder()
        .data(&dataset1)
        .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").x(0.0).y(1.35).size(14))
        .x_title(Text::from("body mass (g)").x(0.94).y(-0.35))
        .y_title(Text::from("count").x(-0.062).y(0.83))
        .x_axis(&axis)
        .y_axis(&axis)
        .legend_title(Text::from("species"))
        .legend(&Legend::new().x(0.87).y(1.2))
        .build();

    let dataset2 = CsvReader::new("data/stock_prices.csv").finish().unwrap();

    let increasing = Direction::new()
        .line_color(Rgb(0, 200, 100))
        .line_width(0.5);

    let decreasing = Direction::new()
        .line_color(Rgb(200, 50, 50))
        .line_width(0.5);

    let plot2 = CandlestickPlot::builder()
        .data(&dataset2)
        .dates("date")
        .open("open")
        .high("high")
        .low("low")
        .close("close")
        .increasing(&increasing)
        .decreasing(&decreasing)
        .whisker_width(0.1)
        .plot_title(Text::from("Candlestick").x(0.0).y(1.35).size(14))
        .y_title(Text::from("price ($)").x(-0.06).y(0.76))
        .y_axis(&Axis::new().show_axis(true).show_grid(true))
        .build();

    let dataset3 = CsvReader::new("data/heatmap.csv").finish().unwrap();

    let plot3 = HeatMap::builder()
        .data(&dataset3)
        .x("x")
        .y("y")
        .z("z")
        .color_bar(
            &ColorBar::new()
                .value_exponent(ValueExponent::None)
                .separate_thousands(true)
                .tick_length(5)
                .tick_step(5000.0),
        )
        .plot_title(Text::from("Heat Map").x(0.0).y(1.35).size(14))
        .color_scale(Palette::Viridis)
        .build();

    SubplotGrid::irregular()
        .plots(vec![
            (&plot1, 0, 0, 1, 1),
            (&plot2, 0, 1, 1, 1),
            (&plot3, 1, 0, 1, 2),
        ])
        .rows(2)
        .cols(2)
        .v_gap(0.35)
        .h_gap(0.05)
        .title(
            Text::from("Irregular Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

impl SubplotGrid

pub fn plot(&self)

Display the subplot grid in the default browser or Jupyter notebook.

Examples found in repository

examples/plotly_subplot_grid.rs (line 140)

fn regular_grid_example() {
    let dataset1 = CsvReader::new("data/animal_statistics.csv")
        .finish()
        .unwrap();

    let plot1 = BarPlot::builder()
        .data(&dataset1)
        .labels("animal")
        .values("value")
        .orientation(Orientation::Vertical)
        .group("gender")
        .sort_groups_by(|a, b| a.len().cmp(&b.len()))
        .error("error")
        .colors(vec![Rgb(255, 127, 80), Rgb(64, 224, 208)])
        .plot_title(Text::from("Bar Plot").x(-0.05).y(1.35).size(14))
        .y_title(Text::from("value").x(-0.055).y(0.76))
        .x_title(Text::from("animal").x(0.97).y(-0.2))
        .legend(
            &Legend::new()
                .orientation(Orientation::Horizontal)
                .x(0.4)
                .y(1.2),
        )
        .build();

    let dataset2 = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .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)
        .tick_direction(TickDirection::OutSide)
        .value_thousands(true);

    let plot2 = ScatterPlot::builder()
        .data(&dataset2)
        .x("body_mass_g")
        .y("flipper_length_mm")
        .group("species")
        .sort_groups_by(|a, b| {
            if a.len() == b.len() {
                a.cmp(b)
            } else {
                a.len().cmp(&b.len())
            }
        })
        .opacity(0.5)
        .size(12)
        .colors(vec![Rgb(178, 34, 34), Rgb(65, 105, 225), Rgb(255, 140, 0)])
        .shapes(vec![Shape::Circle, Shape::Square, Shape::Diamond])
        .plot_title(Text::from("Scatter Plot").x(-0.075).y(1.35).size(14))
        .x_title(Text::from("body mass (g)").y(-0.4))
        .y_title(Text::from("flipper length (mm)").x(-0.078).y(0.5))
        .legend_title("species")
        .x_axis(&axis.clone().value_range(2500.0, 6500.0))
        .y_axis(&axis.clone().value_range(170.0, 240.0))
        .legend(&Legend::new().x(0.98).y(0.95))
        .build();

    let dataset3 = CsvReader::new("data/debilt_2023_temps.csv")
        .has_header(true)
        .try_parse_dates(true)
        .finish()
        .unwrap()
        .lazy()
        .with_columns(vec![
            (col("tavg") / lit(10)).alias("avg"),
            (col("tmin") / lit(10)).alias("min"),
            (col("tmax") / lit(10)).alias("max"),
        ])
        .collect()
        .unwrap();

    let plot3 = TimeSeriesPlot::builder()
        .data(&dataset3)
        .x("date")
        .y("avg")
        .additional_series(vec!["min", "max"])
        .colors(vec![Rgb(128, 128, 128), Rgb(0, 122, 255), Rgb(255, 128, 0)])
        .lines(vec![Line::Solid, Line::Dot, Line::Dot])
        .plot_title(Text::from("Time Series Plot").x(-0.05).y(1.35).size(14))
        .y_title(Text::from("temperature (ºC)").x(-0.055).y(0.6))
        .legend(&Legend::new().x(0.9).y(1.25))
        .build();

    let plot4 = BoxPlot::builder()
        .data(&dataset2)
        .labels("species")
        .values("body_mass_g")
        .orientation(Orientation::Vertical)
        .group("gender")
        .box_points(true)
        .point_offset(-1.5)
        .jitter(0.01)
        .opacity(0.1)
        .colors(vec![Rgb(0, 191, 255), Rgb(57, 255, 20), Rgb(255, 105, 180)])
        .plot_title(Text::from("Box Plot").x(-0.075).y(1.35).size(14))
        .x_title(Text::from("species").y(-0.3))
        .y_title(Text::from("body mass (g)").x(-0.08).y(0.5))
        .legend_title(Text::from("gender").size(12))
        .y_axis(&Axis::new().value_thousands(true))
        .legend(&Legend::new().x(1.0))
        .build();

    SubplotGrid::regular()
        .plots(vec![&plot1, &plot2, &plot3, &plot4])
        .rows(2)
        .cols(2)
        .v_gap(0.4)
        .title(
            Text::from("Regular Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

fn irregular_grid_example() {
    let dataset1 = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .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);

    let plot1 = Histogram::builder()
        .data(&dataset1)
        .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").x(0.0).y(1.35).size(14))
        .x_title(Text::from("body mass (g)").x(0.94).y(-0.35))
        .y_title(Text::from("count").x(-0.062).y(0.83))
        .x_axis(&axis)
        .y_axis(&axis)
        .legend_title(Text::from("species"))
        .legend(&Legend::new().x(0.87).y(1.2))
        .build();

    let dataset2 = CsvReader::new("data/stock_prices.csv").finish().unwrap();

    let increasing = Direction::new()
        .line_color(Rgb(0, 200, 100))
        .line_width(0.5);

    let decreasing = Direction::new()
        .line_color(Rgb(200, 50, 50))
        .line_width(0.5);

    let plot2 = CandlestickPlot::builder()
        .data(&dataset2)
        .dates("date")
        .open("open")
        .high("high")
        .low("low")
        .close("close")
        .increasing(&increasing)
        .decreasing(&decreasing)
        .whisker_width(0.1)
        .plot_title(Text::from("Candlestick").x(0.0).y(1.35).size(14))
        .y_title(Text::from("price ($)").x(-0.06).y(0.76))
        .y_axis(&Axis::new().show_axis(true).show_grid(true))
        .build();

    let dataset3 = CsvReader::new("data/heatmap.csv").finish().unwrap();

    let plot3 = HeatMap::builder()
        .data(&dataset3)
        .x("x")
        .y("y")
        .z("z")
        .color_bar(
            &ColorBar::new()
                .value_exponent(ValueExponent::None)
                .separate_thousands(true)
                .tick_length(5)
                .tick_step(5000.0),
        )
        .plot_title(Text::from("Heat Map").x(0.0).y(1.35).size(14))
        .color_scale(Palette::Viridis)
        .build();

    SubplotGrid::irregular()
        .plots(vec![
            (&plot1, 0, 0, 1, 1),
            (&plot2, 0, 1, 1, 1),
            (&plot3, 1, 0, 1, 2),
        ])
        .rows(2)
        .cols(2)
        .v_gap(0.35)
        .h_gap(0.05)
        .title(
            Text::from("Irregular Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

fn mixed_grid_example() {
    // 2D cartesian scatter (baseline)
    let penguins = CsvReader::new("data/penguins.csv")
        .finish()
        .unwrap()
        .lazy()
        .select([
            col("species"),
            col("bill_length_mm"),
            col("flipper_length_mm"),
            col("body_mass_g"),
        ])
        .collect()
        .unwrap();

    let scatter_2d = ScatterPlot::builder()
        .data(&penguins)
        .x("bill_length_mm")
        .y("flipper_length_mm")
        .group("species")
        .opacity(0.65)
        .size(10)
        .plot_title(Text::from("Penguins 2D").y(1.3))
        .build();

    // 3D scene subplot
    let scatter_3d = Scatter3dPlot::builder()
        .data(&penguins)
        .x("bill_length_mm")
        .y("flipper_length_mm")
        .z("body_mass_g")
        .group("species")
        .opacity(0.35)
        .size(6)
        .plot_title(Text::from("Penguins 3D").y(1.45))
        .build();

    // Polar subplot
    let polar_df = CsvReader::new("data/product_comparison_polar.csv")
        .finish()
        .unwrap();

    let polar = ScatterPolar::builder()
        .data(&polar_df)
        .theta("angle")
        .r("score")
        .group("product")
        .mode(Mode::LinesMarkers)
        .size(10)
        .plot_title(Text::from("Product Comparison (Polar)").y(1.5).x(0.72))
        .legend(&Legend::new().x(0.8))
        .build();

    // Domain-based subplot (Sankey)
    let sankey_df = CsvReader::new("data/energy_transition.csv")
        .finish()
        .unwrap();

    let sankey = SankeyDiagram::builder()
        .data(&sankey_df)
        .sources("source")
        .targets("target")
        .values("value")
        .orientation(Orientation::Horizontal)
        .arrangement(Arrangement::Freeform)
        .plot_title(Text::from("Energy Flow").y(1.2))
        .build();

    // Mapbox subplot
    let map_df = CsvReader::new("data/cities.csv").finish().unwrap();

    let scatter_map = ScatterMap::builder()
        .data(&map_df)
        .latitude("latitude")
        .longitude("longitude")
        .group("city")
        .zoom(4)
        .center([50.0, 5.0])
        .opacity(0.8)
        .plot_title(Text::from("Cities (Mapbox)").y(1.2))
        .build();

    // Geo subplot
    let geo_df = CsvReader::new("data/world_cities.csv").finish().unwrap();

    let scatter_geo = ScatterGeo::builder()
        .data(&geo_df)
        .lat("lat")
        .lon("lon")
        .group("continent")
        .mode(Mode::Markers)
        .size(10)
        .color(Rgb(255, 140, 0))
        .shape(Shape::Circle)
        .plot_title(Text::from("Global Cities (Geo)").x(0.65).y(1.2))
        .legend(&Legend::new().x(0.8))
        .build();

    SubplotGrid::regular()
        .plots(vec![
            &scatter_2d,
            &scatter_3d,
            &polar,
            &sankey,
            &scatter_map,
            &scatter_geo,
        ])
        .rows(2)
        .cols(3)
        .h_gap(0.12)
        .v_gap(0.22)
        .title(
            Text::from("Mixed Subplot Grid")
                .size(16)
                .font("Arial Black")
                .y(0.95),
        )
        .build()
        .plot();
}

examples/plotly_dimensions.rs (line 149)

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

    let temperature_dataset = CsvReader::new("data/debilt_2023_temps.csv")
        .has_header(true)
        .try_parse_dates(true)
        .finish()
        .unwrap()
        .lazy()
        .with_columns(vec![
            (col("tavg") / lit(10)).alias("tavg"),
            (col("tmin") / lit(10)).alias("tmin"),
            (col("tmax") / lit(10)).alias("tmax"),
        ])
        .collect()
        .unwrap();

    let animals_dataset = CsvReader::new("data/animal_statistics.csv")
        .finish()
        .unwrap();

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

    let plot1 = TimeSeriesPlot::builder()
        .data(&temperature_dataset)
        .x("date")
        .y("tavg")
        .additional_series(vec!["tmin", "tmax"])
        .colors(vec![Rgb(128, 128, 128), Rgb(0, 122, 255), Rgb(255, 128, 0)])
        .lines(vec![Line::Solid, Line::Dot, Line::Dot])
        .plot_title(
            Text::from("De Bilt Temperature 2023")
                .font("Arial Black")
                .size(16),
        )
        .y_title(Text::from("temperature (°C)").size(13).x(-0.08))
        // .legend_title(Text::from("Measure").size(12))
        .legend(&Legend::new().x(0.1).y(0.9))
        .build();

    let plot2 = ScatterPlot::builder()
        .data(&penguins_dataset)
        .x("body_mass_g")
        .y("flipper_length_mm")
        .group("species")
        .sort_groups_by(|a, b| {
            if a.len() == b.len() {
                a.cmp(b)
            } else {
                a.len().cmp(&b.len())
            }
        })
        .opacity(0.6)
        .size(10)
        .colors(vec![Rgb(178, 34, 34), Rgb(65, 105, 225), Rgb(255, 140, 0)])
        .shapes(vec![Shape::Circle, Shape::Square, Shape::Diamond])
        .plot_title(
            Text::from("Penguin Morphology")
                .font("Arial Black")
                .size(16),
        )
        .x_title(Text::from("body mass (g)").size(13))
        .y_title(Text::from("flipper length (mm)").size(13).x(-0.11))
        .legend_title(Text::from("Species").size(12))
        .x_axis(&axis.clone().value_range(2500.0, 6500.0))
        .y_axis(&axis.clone().value_range(170.0, 240.0))
        .legend(&Legend::new().x(0.85).y(0.4))
        .build();

    let plot3 = BarPlot::builder()
        .data(&animals_dataset)
        .labels("animal")
        .values("value")
        .orientation(Orientation::Vertical)
        .group("gender")
        .sort_groups_by(|a, b| a.len().cmp(&b.len()))
        .error("error")
        .colors(vec![Rgb(255, 127, 80), Rgb(64, 224, 208)])
        .plot_title(Text::from("Animal Statistics").font("Arial Black").size(16))
        .x_title(Text::from("animal").size(13))
        .y_title(Text::from("value").size(13))
        .legend_title(Text::from("Gender").size(12))
        .legend(
            &Legend::new()
                .orientation(Orientation::Horizontal)
                .x(0.35)
                .y(0.9),
        )
        .build();

    let plot4 = BoxPlot::builder()
        .data(&penguins_dataset)
        .labels("species")
        .values("body_mass_g")
        .orientation(Orientation::Vertical)
        .group("gender")
        .box_points(true)
        .point_offset(-1.5)
        .jitter(0.01)
        .opacity(0.15)
        .colors(vec![Rgb(0, 191, 255), Rgb(57, 255, 20), Rgb(255, 105, 180)])
        .plot_title(
            Text::from("Body Mass Distribution")
                .font("Arial Black")
                .size(16),
        )
        .x_title(Text::from("species").size(13))
        .y_title(Text::from("body mass (g)").size(13).x(-0.12))
        .legend_title(Text::from("Gender").size(12))
        .y_axis(&Axis::new().value_thousands(true))
        .legend(&Legend::new().x(0.85).y(0.9))
        .build();

    let dimensions = Dimensions::new().width(1400).height(850).auto_size(false);

    SubplotGrid::regular()
        .plots(vec![&plot1, &plot2, &plot3, &plot4])
        .rows(2)
        .cols(2)
        .v_gap(0.3)
        .h_gap(0.2)
        .dimensions(&dimensions)
        .title(
            Text::from("Scientific Data Visualization Dashboard")
                .size(26)
                .font("Arial Black"),
        )
        .build()
        .plot();
}

pub fn write_html(&self, path: impl Into<String>)

Write the subplot grid to an HTML file.

pub fn to_json(&self) -> Result<String, Error>

Serialize the subplot grid to a JSON string.

pub fn to_html(&self) -> String

Render the subplot grid as a standalone HTML string.

pub fn to_inline_html(&self, plot_div_id: Option<&str>) -> String

Render the subplot grid as an inline HTML snippet (no DOCTYPE/head).

Trait Implementations

impl Clone for SubplotGrid

fn clone(&self) -> SubplotGrid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Serialize for SubplotGrid

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.