Skip to content

[ridgeline-basic] Ridgeline plot for distribution comparison #539

Description

@MarkusNeusinger

Description

A ridgeline plot (also known as joy plot) showing multiple overlapping density distributions arranged vertically, allowing comparison of distributions across categories.

Applications

  • Comparing salary distributions across different job titles
  • Visualizing temperature distributions across months
  • Showing survey response distributions by demographic groups

Data

  • One categorical variable for grouping (y-axis labels)
  • One continuous variable for the distribution (x-axis)
  • Optional: color encoding for additional grouping

Notes

  • Distributions should overlap slightly for visual appeal
  • Consider transparency/alpha for overlapping areas
  • Named after Joy Division album cover artwork

Activity

  1. changed the title [-]Ridgeline plot for distribution comparison[/-] [+][ridgeline-basic] Ridgeline plot for distribution comparison[/+] on Dec 9, 2025
  2. claude commented on Dec 9, 2025

    @claude
    Contributor

    ✅ Spec Ready: ridgeline-basic

    Branch: plot/ridgeline-basic


    Analysis

    Why this spec makes sense:
    Ridgeline plots are excellent for comparing distributions across multiple categories in a compact, visually striking format. They reveal patterns that would be hard to see in side-by-side histograms or box plots, making them valuable for exploratory data analysis and presentation.

    Spec-ID reasoning:
    ridgeline-basic uses the plot type (ridgeline) as the primary identifier with basic as the variant since this is the foundational ridgeline implementation without additional modifiers like color mapping or interactivity.

    Similar existing specs:

    • histogram-basic - shows single distribution, ridgeline shows multiple distributions stacked
    • box-basic - compares distributions via summary statistics, ridgeline shows full density shapes
      These are related distribution visualization methods but ridgeline offers a unique overlapping density view.

    spec.md

    # ridgeline-basic: Ridgeline Plot
    
    ## Description
    
    A ridgeline plot (also known as joy plot) displays multiple overlapping density distributions arranged vertically, allowing effective comparison of distributions across categories. Each distribution is plotted as a filled density curve, slightly overlapping with adjacent rows to create a visually appealing layered effect. This visualization excels at revealing distribution shapes, modes, and shifts across groups.
    
    ## Applications
    
    - Comparing salary distributions across different job titles to identify compensation patterns
    - Visualizing temperature distributions across months to show seasonal climate patterns
    - Showing survey response distributions by demographic groups to understand opinion variations
    
    ## Data
    
    - `category` (categorical) - grouping variable for vertical arrangement (y-axis labels)
    - `value` (numeric, continuous) - the variable whose distribution is shown (x-axis)
    - Size: 5-20 categories, 50-500+ observations per category
    - Example: Monthly temperature readings with month as category and temperature as value
    
    ## Notes
    
    - Distributions should overlap slightly (10-30%) for visual appeal without obscuring data
    - Use semi-transparent fills (alpha 0.6-0.8) to maintain visibility of overlapping areas
    - Named after the Joy Division album cover "Unknown Pleasures" featuring pulsar radio signals
    - Consider gradient coloring from bottom to top for additional visual interest
    - Kernel density estimation (KDE) is typically used to smooth the distributions

    Next: Add approved label to start code generation.


    🤖 plot-prepare workflow

  3. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    🚀 Implementation Status

    Library Status PR Quality
    matplotlib ✅ Done - -
    seaborn ✅ Done - -
    plotnine ✅ Done - -
    plotly ✅ Done - -
    bokeh ✅ Done - -
    altair ✅ Done - -
    highcharts ✅ Done - -
    pygal ✅ Done - -
    letsplot ✅ Done - -

    ✅ All 9 libraries completed successfully!


    🤖 plot-generate workflow

  4. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ seaborn Merged

    seaborn implementation for ridgeline-basic has been merged to the feature branch.

    PR: #541


    🤖 plot-merge workflow

  5. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ seaborn Merged

    seaborn implementation for ridgeline-basic has been merged to the feature branch.

    PR: #541


    🤖 plot-merge workflow

  6. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ plotnine Merged

    plotnine implementation for ridgeline-basic has been merged to the feature branch.

    PR: #543


    🤖 plot-merge workflow

  7. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ altair Merged

    altair implementation for ridgeline-basic has been merged to the feature branch.

    PR: #544


    🤖 plot-merge workflow

  8. 4 remaining items

  9. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ plotly Merged

    plotly implementation for ridgeline-basic has been merged to the feature branch.

    PR: #546


    🤖 plot-merge workflow

  10. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ highcharts Merged

    highcharts implementation for ridgeline-basic has been merged to the feature branch.

    PR: #549


    🤖 plot-merge workflow

  11. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ highcharts Merged

    highcharts implementation for ridgeline-basic has been merged to the feature branch.

    PR: #549


    🤖 plot-merge workflow

  12. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ plotly Merged

    plotly implementation for ridgeline-basic has been merged to the feature branch.

    PR: #546


    🤖 plot-merge workflow

  13. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ matplotlib Merged

    matplotlib implementation for ridgeline-basic has been merged to the feature branch.

    PR: #542


    🤖 plot-merge workflow

  14. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ matplotlib Merged

    matplotlib implementation for ridgeline-basic has been merged to the feature branch.

    PR: #542


    🤖 plot-merge workflow

  15. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ bokeh Merged

    bokeh implementation for ridgeline-basic has been merged to the feature branch.

    PR: #547


    🤖 plot-merge workflow

  16. github-actions commented on Dec 9, 2025

    @github-actions
    Contributor

    ✅ bokeh Merged

    bokeh implementation for ridgeline-basic has been merged to the feature branch.

    PR: #547


    🤖 plot-merge workflow

  17. MarkusNeusinger commented on Dec 9, 2025

    @MarkusNeusinger
    OwnerAuthor

    ✅ Implementation Complete

    The ridgeline-basic plot has been successfully implemented!

    Results

    Library Status AI Score
    matplotlib ✅ Merged 88/100
    seaborn ✅ Merged 88/100
    plotnine ✅ Merged 88/100
    altair ✅ Merged 88/100
    plotly ✅ Merged 88/100
    bokeh ✅ Merged 88/100
    highcharts ✅ Merged 88/100
    letsplot ✅ Merged 88/100
    pygal ❌ Not feasible -

    Final PR: #550 (merged to main)

    Summary

    • 8/9 libraries implemented successfully
    • All implementations passed AI quality review (score >= 85)
    • Pygal does not support ridgeline/joyplot chart types

    🤖 Automated by plot workflows

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    approvedApproved for implementation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions