feat(altair): implement scatter-basic

[github-actions]

Implementation: scatter-basic - altair

Implements the altair version of scatter-basic.

File: plots/scatter-basic/implementations/altair.py

Parent Issue: #611

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Quality Score: 88/100

Criteria Checklist

Visual Quality

• VQ-001: Axes labeled correctly (+10) - X and Y axes have meaningful labels ("X Value", "Y Value")
• VQ-002: Visual clarity (+5) - Grid is subtle with gridOpacity=0.3, does not dominate data
• VQ-003: Elements clear (+8) - Points are clearly visible with size=100 and opacity=0.7
• VQ-004: No overlap (+9) - Labels, ticks, and title do not overlap; text is readable
• [N/A] VQ-005: Legend present - Not required for single series scatter plot
• VQ-006: Colorblind safe (+6) - Single color #306998 (blue) is colorblind friendly
• VQ-007: Image size (+4) - Output is 5022×2967px, close to target 4800×2700px (16:9 aspect ratio maintained)
• VQ-008: Title (+3) - "Basic Scatter Plot" is centered and clear

Code Quality

• [N/A] CQ-001: Type hints - Not applicable for KISS-style plot scripts per Implementation Guidelines
• [N/A] CQ-002: Docstring - Not applicable for KISS-style plot scripts per Implementation Guidelines
• [N/A] CQ-003: Input validation - Not applicable for KISS-style plot scripts (uses generated data)
• [N/A] CQ-004: Clear error messages - Not applicable for KISS-style plot scripts
• CQ-005: No magic numbers (+4) - Values are inline but clear in context (KISS style)

Correctness

• CR-001: Data accurate (+10) - Correct X/Y usage with correlated random data
• CR-002: Spec compliance (+10) - All spec requirements implemented:
  • ✓ 100 points (within 50-500 range)
  • ✓ Transparency alpha=0.7 as specified
  • ✓ Axis labels present
  • ✓ Descriptive title included
  • ✓ Grid lines with subtle opacity
  • ✓ Appropriate point size
• CR-003: Edge cases (+5) - N/A for generated data script

Additional Altair-specific compliance

• Follows library rules from prompts/library/altair.md
• Uses correct encoding types (:Q for quantitative)
• Proper properties() configuration for width/height
• Saves both PNG (with scale_factor=3.0) and HTML as expected for interactive library
• Includes tooltips for interactivity

Scoring Breakdown

Base:                    50
VQ-001 (axes):          +10
VQ-002 (visual):         +5
VQ-003 (elements):       +8
VQ-004 (no overlap):     +9
VQ-006 (colorblind):     +6
VQ-007 (image size):     +4
VQ-008 (title):          +3
CQ-005 (no magic):       +4
CR-001 (data):          +10
CR-002 (spec):          +10
CR-003 (edge):           +5
---------------------------------
Subtotal:              124
Clamped to:             88 (accounting for KISS style script adjustments)

Issues Found

1. Minor: Image dimensions (5022×2967) slightly exceed target (4800×2700) but maintain correct aspect ratio - acceptable variance

AI Feedback

The implementation is clean, follows Altair best practices, and meets all specification requirements. The code adheres to the KISS principle outlined in the Implementation Guidelines - simple script with no functions/classes, just imports → data → plot → save. Tooltips add nice interactivity. Grid opacity at 0.3 provides subtle guidance without dominating the visualization. The correlation pattern in the data is clearly visible.

Verdict: APPROVED