What problem does it solve?
The plotting-agent automates the tedious, error-prone process of turning a structured plotting plan and experiment notes into publication-ready figures and captions, ensuring consistent styling, exact aspect ratios, and 300 DPI output required by LaTeX conference templates.
Core Features & Use Cases
- Plan-driven rendering: Read plotting_plan entries from workspace/outline.json and render one PNG per figure_id using data in workspace/inputs/idea.md or workspace/inputs/experimental_log.md.
- Deterministic fallback + optional backbone: Prefer PaperBanana when configured via PAPERBANANA_PATH, otherwise generate matplotlib scripts and call deterministic helpers to render plots and diagrams.
- Closed-loop refinement: Optionally run a VLM-guided critique loop (host vision required) with up to three redraw iterations and produce context-aware captions saved to workspace/figures/captions.json.
- Hard validation rules: Enforce the repository's 12 allowed aspect ratios, 300 DPI, muted academic palette, hidden top/right spines, and caption existence to avoid downstream LaTeX compile failures.
- Use Case: Convert an experiment log and outline into a set of figures and captions ready to be included in a submission PDF.
Quick Start
Render all figures from the outline and save produced PNGs and captions into workspace/figures.