Struct ContourPlot

pub struct ContourPlot { /* private fields */ }

A structure representing a contour plot.

The ContourPlot struct enables the creation of contour visualizations that display level curves of a three‑dimensional surface on a two‑dimensional plane. It offers extensive configuration options for contour styling, color scaling, axis appearance, legends, and annotations. Users can fine‑tune the contour interval, choose from predefined color palettes, reverse or hide the color scale, and set custom titles for both the plot and its axes in order to improve the readability of complex surfaces.

Arguments

• data - A reference to the DataFrame containing the data to be plotted.
• x - A string slice specifying the column name for x‑axis values.
• y - A string slice specifying the column name for y‑axis values.
• z - A string slice specifying the column name for z‑axis values whose magnitude determines each contour line.
• color_bar - An optional reference to a ColorBar struct for customizing the color bar appearance.
• color_scale - An optional Palette enum for specifying the color palette (e.g., Palette::Viridis).
• reverse_scale - An optional boolean to reverse the color scale direction.
• show_scale - An optional boolean to display the color scale on the plot.
• contours - An optional reference to a Contours struct for configuring the contour interval, size, and coloring.
• plot_title - An optional Text struct for setting the title of the plot.
• x_title - An optional Text struct for labeling the x‑axis.
• y_title - An optional Text struct for labeling the y‑axis.
• x_axis - An optional reference to an Axis struct for customizing x‑axis appearance.
• y_axis - An optional reference to an Axis struct for customizing y‑axis appearance.

Example

use polars::prelude::*;
use plotlars::{Plot, Coloring, Contours, ContourPlot, Palette};

let dataset = df!(
        "x" => &[0.0, 0.0, 0.0, 2.5, 2.5, 2.5, 5.0, 5.0, 5.0],
        "y" => &[0.0, 7.5, 15.0, 0.0, 7.5, 15.0, 0.0, 7.5, 15.0],
        "z" => &[0.0, 5.0, 10.0, 5.0, 2.5, 5.0, 10.0, 0.0, 0.0],
    )
    .unwrap();

ContourPlot::builder()
    .data(&dataset)
    .x("x")
    .y("y")
    .z("z")
    .color_scale(Palette::Viridis)
    .reverse_scale(true)
    .coloring(Coloring::Fill)
    .show_lines(false)
    .plot_title(
        Text::from("Contour Plot")
            .font("Arial")
            .size(18)
    )
    .build()
    .plot();

Implementations

impl ContourPlot

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

Trait Implementations

impl Clone for ContourPlot

fn clone(&self) -> ContourPlot

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Serialize for ContourPlot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.