[scatter-shot-chart] Basketball Shot Chart

[MarkusNeusinger]

Description

A basketball shot chart overlays shooting data on a half-court diagram, showing shot locations colored by outcome (made/missed) or as a heatmap showing shooting efficiency by zone. Essential for basketball analytics and player evaluation.

Applications

• Analyzing player shooting tendencies and efficiency by court zone
• Scouting opposing players' preferred shooting locations
• Evaluating team offensive strategies
• Sports journalism and broadcast visualization

Data

• x (numeric) — horizontal court position (feet from basket)
• y (numeric) — vertical court position (feet from basket)
• made (boolean) — shot outcome (made=True, missed=False)
• shot_type (categorical) — 2-pointer, 3-pointer, free throw
• Size: 100-1000 shots per player

Notes

• Draw accurate half-court with three-point line, free throw line, paint area, basket
• Color points by made/missed (green/red) or use hexbin heatmap for shooting percentage
• Include shooting percentage annotation per zone
• Use NBA standard court dimensions (50ft × 47ft visible)

[claude]

✅ Spec ID: scatter-shot-chart

Rationale: A basketball shot chart is a scatter-style plot overlaid on a court diagram, combining spatial point data with a domain-specific background — unique among existing specs. No duplicates found.

Add label approved to begin generation.

[github-actions]

✅ Specification Ready: scatter-shot-chart

PR: #4440

---

specification.md

scatter-shot-chart: Basketball Shot Chart

Description

A basketball shot chart overlays shooting data on a half-court diagram, plotting each shot attempt as a point colored by outcome (made or missed). The court drawing includes the three-point arc, free-throw line, paint/key area, and basket, providing spatial context for analyzing shooting patterns and efficiency. Essential for basketball analytics and player evaluation.

Applications

• Analyzing a player's shooting tendencies and field-goal percentage by court zone
• Scouting opposing players to identify their preferred and weakest shooting locations
• Evaluating team offensive strategies and shot selection patterns
• Sports journalism and broadcast graphics summarizing game or season performance

Data

• x (numeric) — horizontal court position in feet from the basket center
• y (numeric) — vertical court position in feet from the basket center
• made (boolean) — shot outcome (True = made, False = missed)
• shot_type (categorical) — type of shot: "2-pointer", "3-pointer", "free-throw"
• Size: 200-500 shot attempts per player

Notes

• Draw an accurate NBA half-court outline using standard dimensions (50 ft wide x 47 ft deep): three-point arc (23.75 ft at top, 22 ft in corners), free-throw line (15 ft from backboard), paint/key area (16 ft wide), restricted area arc, and basket/backboard
• Plot each shot as a point: green for made, red for missed
• Court lines should be drawn in a neutral color (gray or black) so shot markers stand out
• The court should fill the plot area with minimal padding; axis ticks and labels are optional since the court geometry provides spatial reference
• Use a 1:1 aspect ratio so the court is not distorted
• Optionally include a legend for made/missed and shot type

---

Next: Add approved label to merge this specification to main.

---

🤖 spec-create workflow

[github-actions]

🚀 Specification Merged!

Specification: scatter-shot-chart
PR: #4440 (merged)

The specification is now in main and synced to PostgreSQL.

---

Next: Add generate:{library} labels to start generating implementations.

Available libraries: matplotlib, seaborn, plotly, bokeh, altair, plotnine, pygal, highcharts, letsplot

Or use workflow dispatch for bulk operations.

---

🤖 spec-create workflow