feat(seaborn): implement phase-diagram

[github-actions]

Implementation: phase-diagram - python/seaborn

Implements the python/seaborn version of phase-diagram.

File: plots/phase-diagram/implementations/python/seaborn.py

Parent Issue: #3004

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Image Description

Light render (plot-light.png): The phase diagram displays four damped harmonic oscillator trajectories spiraling inward toward the equilibrium point at the origin. The plot uses the Okabe-Ito palette with the first series in brand green (#009E73), followed by orange, blue, and reddish purple for the four initial conditions. The background is warm off-white (#FAF8F1). Title 'phase-diagram · seaborn · anyplot.ai' is rendered at the top in dark text (INK color). Axis labels 'Position (x)' and 'Velocity (dx/dt)' are clearly readable. Subtle dashed reference lines mark x=0 and y=0. Each trajectory has larger colored circles at its starting point and direction arrows indicating time evolution. The equilibrium is marked with a bold black X at the origin. The legend in the upper right shows all four initial condition labels and the equilibrium marker. All text is readable against the light background with excellent contrast.

Dark render (plot-dark.png): The same phase diagram is rendered on a warm near-black background (#1A1A17). All chromatic elements (title, axis labels, tick labels, legend frame, reference lines) have switched to light color tokens (INK=#F0EFE8, INK_SOFT=#B8B7B0) while the data colors remain identical to the light render. The four trajectory colors (#009E73, #D55E00, #0072B2, #CC79A7) are exactly the same as the light version—only the chrome has adapted. All text is clearly visible against the dark background with no dark-on-dark failures. Direction arrows, starting points, and equilibrium markers all remain visible and legible. The overall clarity and visual hierarchy are maintained between renders.

Score: 93/100

Category	Score	Max
Visual Quality	30	30
Design Excellence	17	20
Spec Compliance	15	15
Data Quality	15	15
Code Quality	10	10
Library Mastery	6	10
Total	93	100

Visual Quality (30/30)

• VQ-01: Text Legibility (8/8) — All text (title 24pt, axes 20pt, ticks 16pt, legend 14pt) is readable in both themes with proper color contrast
• VQ-02: No Overlap (6/6) — No overlapping elements; legend positioned clear of data; trajectories overlap inherently but all distinguishable by color
• VQ-03: Element Visibility (6/6) — Trajectories visible at linewidth=3; starting points s=300; equilibrium s=400; direction arrows clearly marked
• VQ-04: Color Accessibility (2/2) — Okabe-Ito palette (CVD-safe); adequate contrast; no red-green-only signal
• VQ-05: Layout & Canvas (4/4) — 16:9 landscape (4800×2700px) proportions excellent; nothing cut off; generous margins
• VQ-06: Axis Labels & Title (2/2) — Title follows spec format; axis labels descriptive with units (Position for x, Velocity/derivative for y)
• VQ-07: Palette Compliance (2/2) — First series #009E73 ✓; Okabe-Ito order followed ✓; backgrounds #FAF8F1 (light) / #1A1A17 (dark) correct ✓; both renders theme-correct ✓

Design Excellence (17/20)

• DE-01: Aesthetic Sophistication (7/8) — Professional styling via seaborn theme; Okabe-Ito palette; clear visual hierarchy (trajectories, equilibrium, starting points); direction arrows add dynamic storytelling; reference axes provide context
• DE-02: Visual Refinement (5/6) — Top/right spines removed (L-shaped frame); remaining spines colored with INK_SOFT; minimal, subtle grid (alpha=0.10); generous whitespace; legend customized with theme-aware colors
• DE-03: Data Storytelling (5/6) — Clear focal point at origin (equilibrium); direction arrows guide viewer through time evolution; four trajectories from different initial conditions tell a complete narrative about basin of attraction; visual hierarchy strongly emphasizes convergence behavior

Spec Compliance (15/15)

• SC-01: Plot Type (5/5) — Correct phase diagram showing position vs. velocity (dx/dt)
• SC-02: Required Features (4/4) — Multiple trajectories from different initial conditions ✓; fixed point (equilibrium) marked ✓; damped oscillation behavior visible ✓; direction arrows show time evolution ✓
• SC-03: Data Mapping (3/3) — X-axis correctly plots position; Y-axis correctly plots velocity; all data points accurate; axes range appropriate
• SC-04: Title & Legend (3/3) — Title format correct: 'phase-diagram · seaborn · anyplot.ai' ✓; legend labels match initial conditions ✓; equilibrium point labeled

Data Quality (15/15)

• DQ-01: Feature Coverage (6/6) — Comprehensive phase diagram visualization; multiple trajectories; equilibrium point; demonstrates damped oscillation and spiral convergence
• DQ-02: Realistic Context (5/5) — Based on damped harmonic oscillator equations; realistic physics parameters (omega=2π, zeta=0.15); correct underdamped behavior; physics-education appropriate
• DQ-03: Appropriate Scale (4/4) — Time range 0-5 seconds reasonable; amplitude/velocity values sensible; axis ranges auto-fitted and appropriate

Code Quality (10/10)

• CQ-01: KISS Structure (3/3) — No unnecessary functions/classes; straightforward implementation; linear data-generation → plotting flow
• CQ-02: Reproducibility (2/2) — Uses np.random.seed(42) for deterministic generation ✓
• CQ-03: Clean Imports (2/2) — All imports used: os (ANYPLOT_THEME), matplotlib (plotting), numpy (math), pandas (DataFrame), seaborn (styling) ✓
• CQ-04: Code Elegance (2/2) — Clean code, no fake UI/interactivity, no AR-08 violations ✓
• CQ-05: Output & API (1/1) — Saves as plot-{THEME}.png ✓; dpi=300, bbox_inches='tight'; current API ✓

Library Mastery (6/10)

• LM-01: Idiomatic Usage (4/5) — Uses sns.lineplot() for multi-trajectory visualization; sns.set_theme() for consistent styling; proper axes-level plotting; good pandas DataFrame integration
• LM-02: Distinctive Features (2/5) — Leverages seaborn's high-level styling system; however, direction arrows and scatter points use matplotlib directly; could use more distinctive seaborn features

Score Caps Applied

• None — no conditions triggered

Strengths

• Excellent visual quality across both light and dark themes with flawless theme adaptation
• Correct and complete implementation of phase diagram specification with all required features
• Proper Okabe-Ito palette usage with brand green (#009E73) as first series
• Clean, reproducible code with minimal complexity
• Professional design with thoughtful elements: direction arrows, starting points, reference lines, custom legend styling
• All typography readable at specified sizes in both themes

Weaknesses

• Library Mastery score below optimal; implementation uses seaborn primarily for styling and pandas integration, but could leverage more distinctive seaborn visualization features
• Design Excellence could be slightly elevated with additional custom refinement (current score reflects solid defaults with good customization)

Issues Found

None — implementation is production-ready.

AI Feedback for Next Attempt

N/A — APPROVED. Implementation exceeds quality expectations. All criteria met or exceeded. No repairs needed.

Verdict: APPROVED