Ui & Plot
Vulkan-native presentation without a second graphics framework.
OA Ui is the retained command layer over oa::render::Renderer. oa::Viewer presents images and video interactively; oa::plot builds composable figures and renders the same result to a semantic oa::Image for display, documentation, or headless automation.
Rust · PythonGPU compositorInteractive + headless

One renderer, semantic front ends
oa::render::Renderer
The low-level Vulkan rendering service. Ui and Plot submit retained draw commands to it; there is no separate Ui renderer.
oa::Viewer
Interactive image and video presentation with playback, scrubbing, live-source updates, and a headless path for automated runs.
oa::plot
Figures, axes, lines, scatter, bars, histograms, heatmaps, legends, labels, themes, and projected scalar-field wireframes.
oa::Image output
Figure::render produces a semantic RGBA image. save_to and show are presentation choices over the same retained figure.
Retained figures in Rust and Python
This source is extracted during documentation generation from the paired executable current gallery tutorials. The screenshots below retain the earlier gallery presentation; they are not new Rust render evidence.
1use std::f32::consts::PI;23use oa::plot::{Axes, BarStyle, FigureConfig, HeatmapStyle, LineStyle, ScatterStyle, Theme};4use oa::{Color, Engine};56// ── Style helpers ─────────────────────────────────────────────────────────────78fn line(color: Color, label: &str, width: f32, antialias_samples: u32) -> LineStyle {9 LineStyle {10 color,11 label: label.to_owned(),12 width,13 antialias_samples,14 ..Default::default()15 }16}1718fn points(color: Color, label: &str, radius: f32) -> ScatterStyle {19 ScatterStyle {20 color,21 label: label.to_owned(),22 radius,23 ..Default::default()24 }25}2627fn bars(color: Color, label: &str, gap: f32) -> BarStyle {28 BarStyle {29 color,30 label: label.to_owned(),31 gap,32 ..Default::default()33 }34}3536fn gradient(a: Color, b: Color, t: f32) -> Color {37 let t = t.clamp(0.0, 1.0);38 Color::new(39 a.r + (b.r - a.r) * t,40 a.g + (b.g - a.g) * t,41 a.b + (b.b - a.b) * t,42 a.a + (b.a - a.a) * t,43 )44}4546// ── Named colors matching the donor palette ───────────────────────────────────4748fn accent() -> Color {49 Color::new(0.24, 0.65, 1.00, 1.0)50}51fn success() -> Color {52 Color::new(0.35, 0.82, 0.54, 1.0)53}54fn purple() -> Color {55 Color::new(0.75, 0.45, 1.00, 1.0)56}57fn cyan() -> Color {58 Color::new(0.30, 0.87, 0.89, 1.0)59}60fn warning() -> Color {61 Color::new(1.00, 0.80, 0.22, 1.0)62}63fn pink() -> Color {64 Color::new(1.00, 0.55, 0.75, 1.0)65}66fn gray() -> Color {67 Color::new(0.565, 0.565, 0.565, 1.0)68}6970// ── Individual axes builders ──────────────────────────────────────────────────7172// [oa-plot-intro-begin]73fn intro_figure() -> oa::plot::Figure {74 let mut fig = oa::plot::Figure::new(FigureConfig {75 title: "oa::plot intro".to_owned(),76 rows: 1,77 cols: 2,78 width: 1280,79 height: 560,80 h_spacing: 36,81 padding: 34,82 theme: Theme::Dark,83 ..Default::default()84 });85 fig.title("One retained figure — Rust and C++ parity");8687 let steps = [0.0f32, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0];88 let train = [1.00f32, 0.78, 0.61, 0.48, 0.37, 0.29, 0.23, 0.19];89 let validation = [1.04f32, 0.83, 0.66, 0.53, 0.43, 0.35, 0.30, 0.27];90 let ideal = [0.0f32, 0.25, 0.50, 0.75, 1.0];91 let confidence = [0.10f32, 0.30, 0.50, 0.70, 0.90];92 let accuracy = [0.08f32, 0.34, 0.47, 0.74, 0.88];9394 let curves = fig.ax(0, 0);95 curves.title("training curves");96 curves.x_label("optimizer step");97 curves.y_label("cross entropy");98 curves.limits(0.0, 7.0, 0.0, 1.1);99 curves.plot_xy(&steps, &train, line(accent(), "train", 1.6, 4));100 curves.plot_xy(&steps, &validation, line(success(), "validation", 1.6, 4));101102 let quality = fig.ax(0, 1);103 quality.title("Calibration");104 quality.x_label("confidence");105 quality.y_label("observed accuracy");106 quality.limits(0.0, 1.0, 0.0, 1.0);107 quality.plot_xy(&ideal, &ideal, line(gray(), "ideal", 1.35, 4));108 quality.scatter(&confidence, &accuracy, points(cyan(), "model", 3.5));109 fig110}111// [oa-plot-intro-end]112113fn training_plot(ax: &mut Axes) {114 let n = 72usize;115 let train: Vec<f32> = (0..n)116 .map(|i| {117 let step = i as f32;118 1.55 * (-step / 18.0).exp() + 0.035 * (step * 0.52).sin() + 0.11119 })120 .collect();121 let validation: Vec<f32> = (0..n)122 .map(|i| {123 let step = i as f32;124 1.45 * (-step / 21.0).exp() + 0.045 * (step * 0.39 + 0.8).sin() + 0.17125 })126 .collect();127 ax.title("training curves");128 ax.x_label("optimizer step");129 ax.y_label("cross entropy");130 ax.plot(&train, line(accent(), "train", 1.35, 4));131 ax.plot(&validation, line(success(), "validation", 1.35, 4));132}133134fn roc_plot(ax: &mut Axes) {135 let n = 33usize;136 let rate: Vec<f32> = (0..n).map(|i| i as f32 / (n - 1) as f32).collect();137 let vision: Vec<f32> = rate138 .iter()139 .map(|&x| (1.0 - (-4.3 * x).exp()).clamp(0.0, 1.0))140 .collect();141 let fusion: Vec<f32> = rate142 .iter()143 .map(|&x| (1.0 - (-6.7 * x).exp()).clamp(0.0, 1.0))144 .collect();145 ax.title("ROC — threshold sweep");146 ax.x_label("false positive rate");147 ax.y_label("true positive rate");148 ax.limits(0.0, 1.0, 0.0, 1.0);149 ax.plot_xy(&rate, &vision, line(cyan(), "vision AUC 0.88", 1.35, 4));150 ax.plot_xy(&rate, &fusion, line(success(), "fusion AUC 0.93", 1.35, 4));151 ax.plot_xy(&rate, &rate, line(gray(), "chance", 1.35, 4));152}153154fn precision_recall_plot(ax: &mut Axes) {155 let n = 33usize;156 let recall: Vec<f32> = (0..n).map(|i| i as f32 / (n - 1) as f32).collect();157 let vision: Vec<f32> = recall158 .iter()159 .map(|&x| (0.98 - 0.40 * x.powf(1.6) - 0.025 * (x * 5.0 * PI).sin()).clamp(0.0, 1.0))160 .collect();161 let fusion: Vec<f32> = recall162 .iter()163 .map(|&x| (0.995 - 0.27 * x.powf(2.1) - 0.015 * (x * 4.0 * PI).sin()).clamp(0.0, 1.0))164 .collect();165 ax.title("Precision-recall");166 ax.x_label("recall");167 ax.y_label("precision");168 ax.limits(0.0, 1.0, 0.0, 1.0);169 ax.plot_xy(&recall, &vision, line(purple(), "vision AP 0.84", 1.35, 4));170 ax.plot_xy(&recall, &fusion, line(pink(), "fusion AP 0.91", 1.35, 4));171}172173fn score_histogram(ax: &mut Axes) {174 let scores: Vec<f32> = (0..192usize)175 .map(|i| {176 let phase = i as f32;177 let cluster = if i % 3 == 0 { 0.28 } else { 0.74 };178 (cluster + 0.12 * (phase * 1.73).sin() + 0.045 * (phase * 0.37).cos()).clamp(0.0, 1.0)179 })180 .collect();181 ax.title("confidence distribution");182 ax.x_label("model score");183 ax.y_label("samples");184 ax.histogram(&scores, 20, bars(accent(), "validation scores", 0.20));185}186187fn calibration_scatter(ax: &mut Axes) {188 let n = 24usize;189 let confidence: Vec<f32> = (0..n).map(|i| (i as f32 + 0.5) / n as f32).collect();190 let accuracy: Vec<f32> = confidence191 .iter()192 .map(|&x| (x + 0.055 * (8.0 * PI * x).sin() - 0.025).clamp(0.0, 1.0))193 .collect();194 let ideal: Vec<f32> = confidence.clone();195 ax.title("Calibration");196 ax.x_label("confidence");197 ax.y_label("observed accuracy");198 ax.limits(0.0, 1.0, 0.0, 1.0);199 ax.plot_xy(&confidence, &ideal, line(gray(), "ideal", 1.35, 4));200 ax.scatter(&confidence, &accuracy, points(cyan(), "model", 3.5));201}202203fn throughput_bars(ax: &mut Axes) {204 let throughput = [0.42f32, 0.58, 0.71, 0.86, 0.79, 0.94];205 ax.title("normalized throughput");206 ax.x_label("kernel route");207 ax.y_label("relative peak");208 ax.limits(-0.5, 5.5, 0.0, 1.0);209 ax.bar(&throughput, bars(warning(), "device routes", 0.24));210}211212fn confusion_heatmap(ax: &mut Axes) {213 let confusion = [214 42.0f32, 2.0, 0.0, 1.0, 0.0, 3.0, 37.0, 2.0, 0.0, 1.0, 0.0, 2.0, 40.0, 3.0, 0.0, 1.0, 0.0, 2.0,215 38.0, 2.0, 0.0, 1.0, 0.0, 2.0, 43.0,216 ];217 ax.title("confusion matrix");218 ax.x_label("predicted class");219 ax.y_label("reference class");220 ax.heatmap(221 &confusion,222 5,223 5,224 HeatmapStyle {225 colormap: 1,226 auto_scale: true,227 show_grid: true,228 ..Default::default()229 },230 );231 ax.grid(false);232}233234fn wireframe(235 ax: &mut Axes,236 title: &str,237 height_fn: impl Fn(f32, f32) -> f32,238 near: Color,239 far: Color,240) {241 const LINES: i32 = 13;242 const SAMPLES: i32 = 29;243 // Row sweeps.244 for row in 0..LINES {245 let v = -1.0 + 2.0 * row as f32 / (LINES - 1) as f32;246 let mut px = vec![0.0f32; SAMPLES as usize];247 let mut py = vec![0.0f32; SAMPLES as usize];248 for col in 0..SAMPLES {249 let u = -1.0 + 2.0 * col as f32 / (SAMPLES - 1) as f32;250 let z = height_fn(u, v);251 px[col as usize] = 0.50 + 0.34 * (u - v);252 py[col as usize] = 0.58 - 0.16 * (u + v) - 0.23 * z;253 }254 let t = row as f32 / (LINES - 1) as f32;255 ax.plot_xy(&px, &py, line(gradient(far, near, t), "", 1.15, 8));256 }257 // Column sweeps.258 for col in 0..LINES {259 let u = -1.0 + 2.0 * col as f32 / (LINES - 1) as f32;260 let mut px = vec![0.0f32; SAMPLES as usize];261 let mut py = vec![0.0f32; SAMPLES as usize];262 for row in 0..SAMPLES {263 let v = -1.0 + 2.0 * row as f32 / (SAMPLES - 1) as f32;264 let z = height_fn(u, v);265 px[row as usize] = 0.50 + 0.34 * (u - v);266 py[row as usize] = 0.58 - 0.16 * (u + v) - 0.23 * z;267 }268 let t = col as f32 / (LINES - 1) as f32;269 let mut col_style = line(gradient(far, near, t), "", 1.15, 8);270 col_style.color.a = 0.78;271 ax.plot_xy(&px, &py, col_style);272 }273 ax.title(title);274 ax.limits(-0.20, 1.20, 0.02, 1.08);275 ax.grid(false);276 ax.legend(false);277}278279fn loss_landscape(ax: &mut Axes) {280 wireframe(281 ax,282 "projected loss landscape",283 |x, y| {284 let bowl = 0.42 * (x * x + 0.75 * y * y);285 bowl + 0.18 * (2.7 * x).sin() * (3.1 * y).cos()286 },287 cyan(),288 purple(),289 );290}291292fn gradient_basin(ax: &mut Axes) {293 wireframe(294 ax,295 "projected optimizer basin",296 |x, y| {297 let radius = (x * x + y * y).sqrt();298 0.34 * radius + 0.17 * (9.0 * radius).cos() * (-1.8 * radius).exp()299 },300 success(),301 warning(),302 );303}304305fn gallery(theme: Theme) -> oa::plot::Figure {306 let mut fig = oa::plot::Figure::new(FigureConfig {307 title: "OA Plot gallery".to_owned(),308 rows: 3,309 cols: 3,310 width: 1600,311 height: 1050,312 h_spacing: 32,313 v_spacing: 36,314 padding: 34,315 theme,316 ..Default::default()317 });318 fig.title("OA Plot — GPU-composed ML diagnostics");319 training_plot(fig.ax(0, 0));320 roc_plot(fig.ax(0, 1));321 precision_recall_plot(fig.ax(0, 2));322 score_histogram(fig.ax(1, 0));323 calibration_scatter(fig.ax(1, 1));324 throughput_bars(fig.ax(1, 2));325 confusion_heatmap(fig.ax(2, 0));326 loss_landscape(fig.ax(2, 1));327 gradient_basin(fig.ax(2, 2));328 fig329}330331fn evaluation_figure() -> oa::plot::Figure {332 let mut fig = oa::plot::Figure::new(FigureConfig {333 title: "OA model evaluation".to_owned(),334 rows: 1,335 cols: 2,336 width: 1280,337 height: 560,338 h_spacing: 36,339 padding: 34,340 ..Default::default()341 });342 fig.title("Model evaluation — ROC and precision-recall");343 roc_plot(fig.ax(0, 0));344 precision_recall_plot(fig.ax(0, 1));345 fig346}347348fn diagnostics_figure() -> oa::plot::Figure {349 let mut fig = oa::plot::Figure::new(FigureConfig {350 title: "OA model diagnostics".to_owned(),351 rows: 2,352 cols: 2,353 width: 1200,354 height: 900,355 h_spacing: 32,356 v_spacing: 36,357 padding: 34,358 ..Default::default()359 });360 fig.title("training and evaluation diagnostics");361 training_plot(fig.ax(0, 0));362 score_histogram(fig.ax(0, 1));363 calibration_scatter(fig.ax(1, 0));364 confusion_heatmap(fig.ax(1, 1));365 fig366}367368fn landscapes_figure() -> oa::plot::Figure {369 let mut fig = oa::plot::Figure::new(FigureConfig {370 title: "OA projected landscapes".to_owned(),371 rows: 1,372 cols: 2,373 width: 1280,374 height: 560,375 h_spacing: 36,376 padding: 34,377 ..Default::default()378 });379 fig.title("scalar-field projections — explicit-X wireframes");380 loss_landscape(fig.ax(0, 0));381 gradient_basin(fig.ax(0, 1));382 fig383}384385// ── Entry point ───────────────────────────────────────────────────────────────386387fn usage(program: &str) {388 eprintln!("usage: {program} [--output DIR] [--headless]");389}390391fn main() -> anyhow::Result<()> {392 let mut output = std::path::PathBuf::from("artifact/plot");393 let mut show = true;394395 let args: Vec<String> = std::env::args().collect();396 let mut i = 1;397 while i < args.len() {398 match args[i].as_str() {399 "--headless" => {400 show = false;401 }402 "--output" if i + 1 < args.len() => {403 i += 1;404 output = std::path::PathBuf::from(&args[i]);405 }406 "--help" => {407 usage(&args[0]);408 return Ok(());409 }410 other => {411 eprintln!("unknown argument: {other}");412 usage(&args[0]);413 std::process::exit(1);414 }415 }416 i += 1;417 }418419 std::fs::create_dir_all(&output).map_err(|e| {420 eprintln!("could not create output dir: {e}");421 e422 })?;423424 let engine = if show {425 let window = oa::SdlWindow::new("OA Plot presentation probe", 1, 1)?;426 let extensions = window.required_instance_extensions()?;427 Engine::builder().instance_extensions(extensions).build()?428 } else {429 Engine::new()?430 };431432 let mut dark = gallery(Theme::Dark);433 let mut light = gallery(Theme::Light);434 let mut intro = intro_figure();435 let mut evaluation = evaluation_figure();436 let mut diagnostics = diagnostics_figure();437 let mut landscapes = landscapes_figure();438439 println!("OA Plot walkthrough artifacts:");440441 let save = |fig: &mut oa::plot::Figure, name: &str| -> anyhow::Result<()> {442 let path = output.join(name);443 fig.save_to(&engine, path.to_str().unwrap_or(name))?;444 println!(" {}", path.display());445 Ok(())446 };447448 save(&mut intro, "oa-plot-intro-dark.png")?;449 save(&mut dark, "oa-plot-gallery-dark.png")?;450 save(&mut light, "oa-plot-gallery-light.png")?;451 save(&mut evaluation, "oa-plot-evaluation-dark.png")?;452 save(&mut diagnostics, "oa-plot-diagnostics-dark.png")?;453 save(&mut landscapes, "oa-plot-landscapes-dark.png")?;454455 if show {456 dark.show(&engine)?;457 }458 Ok(())459}460
Current surface
| Layer | Contract |
|---|---|
| Figure | Fixed output size, theme, grid layout, spacing, padding, labels, render, save_to, and show |
| Axes | plot, scatter, bar, histogram, heatmap, imshow, limits, grid, legend, title, labels, caption, and border color |
| Line quality | Per-line 1×, 2×, 4×, or 8× antialias sampling; unsupported requests resolve deterministically |
| Execution | Retained CPU-side description lowered to GPU draw and compute work through the process engine |
