feat(heuropt-plot): v0.1.0 — SVG visualization companion crate

Adds heuropt-plot, a tiny SVG-only plotter that takes heuropt results and emits scatter plots (pareto_front_svg) and line plots (convergence_svg). No heavy 'plotters' or 'tiny-skia' dep — hand- rolled SVG so the crate adds <100 KB to a build. Workspace setup: root Cargo.toml gains [workspace] with members = ['.', 'heuropt-plot']. heuropt-plot has its own version (0.1.0) and publishes independently against heuropt 0.7+. Adds examples/visualize.rs that wires it all up: NSGA-II on Schaffer N.1, observer closure recording per-generation hypervolume, two SVGs written to disk.
2026-05-05 15:26:22 -06:00
parent 41122b7d48
commit 8cf518200a
8 changed files with 634 additions and 0 deletions
@@ -0,0 +1,46 @@
+# heuropt-plot
+
+[![Crates.io](https://img.shields.io/crates/v/heuropt-plot.svg)](https://crates.io/crates/heuropt-plot)
+[![Documentation](https://docs.rs/heuropt-plot/badge.svg)](https://docs.rs/heuropt-plot)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE)
+
+Lightweight SVG plotting helpers for [`heuropt`](https://crates.io/crates/heuropt)
+results.
+
+Hand-rolled SVG output (no `plotters`, no `tiny-skia`, no
+heavyweight dependency) so adding `heuropt-plot` to your project
+costs ~20 KB of compiled code.
+
+## What's in the box
+
+- `pareto_front_svg` — render a 2-objective Pareto front as an SVG
+  scatter plot with axes and labels.
+- `convergence_svg` — render a "best fitness so far" trace as an
+  SVG line plot.
+
+Output is a `String` of valid SVG. Write it to a file, embed it in
+HTML, or pipe it to a browser.
+
+## Example
+
+```rust
+use heuropt::prelude::*;
+use heuropt_plot::pareto_front_svg;
+
+let space = ObjectiveSpace::new(vec![
+    Objective::minimize("f1"),
+    Objective::minimize("f2"),
+]);
+let front = vec![
+    Candidate::new((), Evaluation::new(vec![0.0, 1.0])),
+    Candidate::new((), Evaluation::new(vec![0.5, 0.5])),
+    Candidate::new((), Evaluation::new(vec![1.0, 0.0])),
+];
+
+let svg = pareto_front_svg(&front, &space, 600, 400, "Sample front");
+std::fs::write("front.svg", svg).unwrap();
+```
+
+## License
+
+MIT — see [LICENSE](../LICENSE) at the repo root.