Crate gpui_px 

gpui-px - High-level charting API for GPUI

Plotly Express-style API built on top of d3rs primitives.

Chart Types

Scatter Charts

Use scatter() for:

• Displaying individual data points with x,y coordinates
• Exploring correlations between two continuous variables
• Identifying outliers or clusters in data
• Showing distributions in 2D space

Line Charts

Use line() for:

• Time series or sequential data
• Showing trends over continuous domains
• Connecting related data points with smooth or linear interpolation
• Comparing multiple series over the same range

Bar Charts

Use bar() for:

• Categorical data with discrete categories
• Comparing values across different groups
• Displaying counts or aggregated metrics
• Visualizing rankings or distributions by category

Heatmaps

Use heatmap() for:

• Visualizing 2D scalar fields with color
• Spectrograms, correlation matrices, geographic data
• Supports log scale axes and multiple color scales

Contour Charts (Filled)

Use contour() for:

• Filled bands between threshold values
• Topographic-style visualizations
• Density estimation results

Isoline Charts (Unfilled)

Use isoline() for:

• Unfilled contour lines at specific levels
• Elevation or pressure maps
• Level curves of scalar fields

Coordinate System

All charts use standard mathematical coordinates:

• Y-axis: 0 at bottom, increases upward
• X-axis: 0 at left, increases rightward

Color Format

For 1D charts (scatter, line, bar, isoline), color parameters accept 24-bit RGB hex values in format 0xRRGGBB:

• 0x1f77b4 - Plotly blue (default)
• 0xff7f0e - Plotly orange
• 0x2ca02c - Plotly green
• 0xd62728 - Plotly red

For 2D charts (heatmap, contour), use ColorScale:

• ColorScale::Viridis - perceptually uniform (default)
• ColorScale::Plasma - perceptually uniform
• ColorScale::Inferno - perceptually uniform
• ColorScale::Magma - perceptually uniform
• ColorScale::Heat - diverging (blue → white → red)
• ColorScale::Coolwarm - diverging
• ColorScale::Greys - sequential grayscale
• ColorScale::custom(|t| ...) - custom function

Logarithmic Scales

All chart types support logarithmic axis scaling via the ScaleType enum:

Scatter Charts

• Both X and Y axes can be logarithmic independently
• Use .x_scale(ScaleType::Log) and .y_scale(ScaleType::Log)
• Ideal for power-law relationships and data spanning multiple orders of magnitude

Line Charts

• Both X and Y axes can be logarithmic independently
• Perfect for frequency response plots (audio engineering)
• Example: frequency axis from 20 Hz to 20 kHz

Bar Charts

• Only Y-axis (values) can be logarithmic
• X-axis is categorical (always linear)
• Use .y_scale(ScaleType::Log) for values spanning magnitudes

Heatmaps, Contours, and Isolines

• Both X and Y axes support logarithmic scaling
• Use .x_scale(ScaleType::Log) and .y_scale(ScaleType::Log)

Important: Logarithmic scales require all values to be positive. Zero or negative values will cause validation errors.

Example

use gpui_px::{scatter, line, bar, heatmap, contour, isoline, ColorScale, ScaleType};

// Scatter plot in 3 lines
let chart = scatter(&x_data, &y_data)
    .title("My Chart")
    .build()?;

// Scatter plot with logarithmic scales
let chart = scatter(&x_data, &y_data)
    .x_scale(ScaleType::Log)
    .y_scale(ScaleType::Log)
    .build()?;

// Line chart with custom color
let chart = line(&x_data, &y_data)
    .color(0x1f77b4)  // Plotly blue
    .build()?;

// Frequency response plot with log frequency axis
let chart = line(&frequency, &magnitude_db)
    .x_scale(ScaleType::Log)
    .build()?;

// Bar chart
let chart = bar(&categories, &values)
    .build()?;

// Heatmap with log scale x-axis
let z = vec![1.0; 12]; // 3x4 grid
let chart = heatmap(&z, 3, 4)
    .x(&[20.0, 200.0, 2000.0])
    .x_scale(ScaleType::Log)
    .color_scale(ColorScale::Inferno)
    .build()?;

// Contour plot with custom thresholds
let chart = contour(&z, 3, 4)
    .thresholds(vec![0.0, 0.5, 1.0, 1.5])
    .color_scale(ColorScale::Viridis)
    .build()?;

// Isoline plot
let chart = isoline(&z, 3, 4)
    .levels(vec![0.5, 1.0, 1.5])
    .color(0x333333)
    .stroke_width(1.5)
    .build()?;

Structs

BarChart

Bar chart builder.

ContourChart

Contour chart builder (filled bands between thresholds).

D3Color

RGB color with alpha channel and interpolation support

HeatmapChart

Heatmap chart builder.

IsolineChart

Isoline chart builder (unfilled contour lines).

LineChart

Line chart builder.

ScatterChart

Scatter chart builder.

Enums

ChartError

Errors that can occur when building or rendering charts.

ColorScale

Color scale for 2D visualizations (heatmaps, contours).

CurveType

Curve interpolation types

ScaleType

Scale type for axis transformations.

Functions

bar

Create a bar chart from categories and values.

contour

Create a contour chart (filled bands) from z data with grid dimensions.

heatmap

Create a heatmap chart from z data with grid dimensions.

isoline

Create an isoline chart (unfilled contour lines) from z data with grid dimensions.

line

Create a line chart from x and y data.

scatter

Create a scatter chart from x and y data.