plotly.yaml

library: plotly
specification_id: bar-basic
created: 2025-12-13 23:14:18+00:00
updated: '2026-02-14T14:55:26Z'
generated_by: claude-opus-4-6
workflow_run: 20199224291
issue: 612
python_version: '3.14'
library_version: 6.5.2
preview_url: https://storage.googleapis.com/pyplots-images/plots/bar-basic/plotly/plot.png
preview_thumb: https://storage.googleapis.com/pyplots-images/plots/bar-basic/plotly/plot_thumb.png
preview_html: https://storage.googleapis.com/pyplots-images/plots/bar-basic/plotly/plot.html
quality_score: 92
impl_tags:
  dependencies: []
  techniques:
  - annotations
  - html-export
  patterns: []
  dataprep: []
  styling:
  - edge-highlighting
  - grid-styling
review:
  strengths:
  - 'Excellent data storytelling with the Top seller annotation providing contextual
    insight (17% ahead of #2) and the average reference line giving statistical context'
  - All font sizes explicitly set and well-calibrated for 4800x2700 output — perfectly
    readable
  - Clean, idiomatic Plotly code with good use of library-specific features (hovertemplate,
    texttemplate, add_hline with annotation)
  - Thoughtful visual hierarchy with subtle darker shade for top performer and minimal
    bar outlines
  - Dual output (PNG + interactive HTML) leverages Plotly interactive strengths
  weaknesses:
  - The Top seller annotation box overlaps/crowds the $45,200 value label on the Electronics
    bar, creating visual clutter at the most important data point
  - The color contrast between the highlighted top bar (#1A4971) and regular bars
    (#306998) is quite subtle — could be more visually distinct to reinforce the storytelling
  - The average line annotation is pushed to the far right margin — could be positioned
    more prominently
  improvements: []
  verdict: APPROVED
  image_description: 'The plot displays a vertical bar chart titled "bar-basic · plotly
    · pyplots.ai" centered at the top. Eight bars represent product sales by department,
    sorted in descending order from left to right: Electronics ($45,200), Clothing
    ($38,700), Home & Garden ($31,500), Sports ($27,800), Books ($24,300), Toys ($21,600),
    Automotive ($18,900), and Health ($15,400). Dollar-formatted value labels appear
    above each bar. The top-performing Electronics bar is rendered in a slightly darker
    navy blue (#1A4971) while the remaining bars use a medium blue (#306998). A "Top
    seller / 17% ahead of #2" annotation with an arrow points to the Electronics bar.
    A dotted horizontal reference line marks the average at $27,925 with a label on
    the far right. The background is white with very subtle horizontal gridlines.
    The x-axis is labeled "Product Category" and the y-axis "Sales ($)" with dollar-formatted
    tick marks. Overall layout is clean and well-proportioned.'
  criteria_checklist:
    visual_quality:
      score: 28
      max: 30
      items:
      - id: VQ-01
        name: Text Legibility
        score: 8
        max: 8
        passed: true
        comment: 'All font sizes explicitly set: title 28pt, axis labels 22pt, tick
          labels 18pt, bar text 20pt. All perfectly readable at 4800x2700.'
      - id: VQ-02
        name: No Overlap
        score: 4
        max: 6
        passed: false
        comment: The Top seller annotation box and the $45,200 value label on the
          Electronics bar create visual clutter; the annotation arrow and value text
          compete for the same space.
      - id: VQ-03
        name: Element Visibility
        score: 6
        max: 6
        passed: true
        comment: Bars well-sized with appropriate bargap (0.3), all elements clearly
          visible.
      - id: VQ-04
        name: Color Accessibility
        score: 4
        max: 4
        passed: true
        comment: Single-hue blue palette is inherently colorblind-safe. No red-green
          differentiation.
      - id: VQ-05
        name: Layout Balance
        score: 4
        max: 4
        passed: true
        comment: Good canvas utilization with balanced margins. Plot fills appropriate
          portion of canvas.
      - id: VQ-06
        name: Axis Labels & Title
        score: 2
        max: 2
        passed: true
        comment: Product Category and Sales ($) are descriptive with units.
    design_excellence:
      score: 16
      max: 20
      items:
      - id: DE-01
        name: Aesthetic Sophistication
        score: 6
        max: 8
        passed: true
        comment: Custom color palette with intentional hierarchy, subtle bar outlines,
          clean plotly_white template. Clearly above defaults, strong design.
      - id: DE-02
        name: Visual Refinement
        score: 5
        max: 6
        passed: true
        comment: Subtle gridlines (rgba 0.07), clean template, generous whitespace,
          polished margins. Average line label pushed to far right edge.
      - id: DE-03
        name: Data Storytelling
        score: 5
        max: 6
        passed: true
        comment: 'Top seller annotation with contextual insight (17% ahead of #2),
          average reference line for context. Good narrative elements.'
    spec_compliance:
      score: 15
      max: 15
      items:
      - id: SC-01
        name: Plot Type
        score: 5
        max: 5
        passed: true
        comment: Correct vertical bar chart.
      - id: SC-02
        name: Required Features
        score: 4
        max: 4
        passed: true
        comment: Consistent bar widths, value labels above bars, single color with
          highlight, adequate spacing. All spec notes addressed.
      - id: SC-03
        name: Data Mapping
        score: 3
        max: 3
        passed: true
        comment: Categories on x-axis, values on y-axis, correct mapping.
      - id: SC-04
        name: Title & Legend
        score: 3
        max: 3
        passed: true
        comment: Title format bar-basic · plotly · pyplots.ai correct. No legend needed
          for single series.
    data_quality:
      score: 14
      max: 15
      items:
      - id: DQ-01
        name: Feature Coverage
        score: 5
        max: 6
        passed: true
        comment: 8 categories with clear variation, sorted descending. Good range
          ($15K-$45K). Could show more extreme variation.
      - id: DQ-02
        name: Realistic Context
        score: 5
        max: 5
        passed: true
        comment: Product sales by department is a real, neutral business scenario.
      - id: DQ-03
        name: Appropriate Scale
        score: 4
        max: 4
        passed: true
        comment: Sales figures $15K-$45K are realistic for department-level retail
          sales.
    code_quality:
      score: 10
      max: 10
      items:
      - id: CQ-01
        name: KISS Structure
        score: 3
        max: 3
        passed: true
        comment: 'Clean flat structure: import, data, figure, annotation, layout,
          save.'
      - id: CQ-02
        name: Reproducibility
        score: 2
        max: 2
        passed: true
        comment: Deterministic hardcoded data, no randomness needed.
      - id: CQ-03
        name: Clean Imports
        score: 2
        max: 2
        passed: true
        comment: Only plotly.graph_objects imported and used.
      - id: CQ-04
        name: Code Elegance
        score: 2
        max: 2
        passed: true
        comment: Clean, well-organized, appropriate complexity.
      - id: CQ-05
        name: Output & API
        score: 1
        max: 1
        passed: true
        comment: Saves as plot.png (1600x900, scale=3) and plot.html. No deprecated
          APIs.
    library_mastery:
      score: 9
      max: 10
      items:
      - id: LM-01
        name: Idiomatic Usage
        score: 5
        max: 5
        passed: true
        comment: 'Expert use of graph_objects API: go.Bar, add_trace, update_layout,
          add_annotation, add_hline with annotation dict.'
      - id: LM-02
        name: Distinctive Features
        score: 4
        max: 5
        passed: true
        comment: 'Uses Plotly-specific features: hovertemplate, texttemplate, add_hline
          with embedded annotation, dual output (PNG + HTML).'