update(raincloud-basic): altair — fix orientation consistency

Fix cloud/rain orientation: cloud (half-violin) extends upward, rain (jittered points) falls downward. Updated spec to clarify absolute y-direction terms.

Author: MarkusNeusinger

plots/raincloud-basic/implementations/altair.py

@@ -1,7 +1,7 @@
-""" pyplots.ai
+"""pyplots.ai
 raincloud-basic: Basic Raincloud Plot
-Library: altair 6.0.0 | Python 3.13.11
-Quality: 90/100 | Created: 2025-12-25
+Library: altair 6.0.0 | Python 3.14
+Quality: /100 | Updated: 2026-02-14
 """
 
 import altair as alt
@@ -12,9 +12,8 @@
 # Data: Reaction times (ms) for different treatment conditions
 np.random.seed(42)
 
-# Create realistic reaction time data with different distributions
 control = np.random.normal(450, 60, 80)
-treatment_a = np.random.normal(380, 50, 80)  # Faster responses
+treatment_a = np.random.normal(380, 50, 80)
 treatment_b = np.concatenate(
     [
         np.random.normal(350, 30, 50),  # Bimodal distribution
@@ -29,34 +28,34 @@
     }
 )
 
-# Map conditions to numeric positions - HORIZONTAL: y=categories, x=values
+# Map conditions to numeric y positions (HORIZONTAL: categories on y-axis, values on x-axis)
 condition_order = ["Control", "Treatment A", "Treatment B"]
 condition_map = {c: i for i, c in enumerate(condition_order)}
 data["condition_num"] = data["condition"].map(condition_map)
 
-# Create jittered y positions for strip plot (rain BELOW the cloud)
+# Jitter positions for rain — BELOW the category baseline (negative y offset)
 np.random.seed(42)
-data["jitter"] = np.random.uniform(-0.35, -0.15, len(data))
+data["jitter"] = np.random.uniform(-0.35, -0.12, len(data))
 data["jitter_pos"] = data["condition_num"] + data["jitter"]
 
-# Half-violin (cloud) - positioned on TOP (positive y offset from center)
+# Color palette
+colors = ["#306998", "#FFD43B", "#4CAF50"]
+
+# Half-violin cloud — extends ABOVE baseline (positive y offset)
 violin = (
     alt.Chart(data)
     .transform_density(
         "reaction_time", as_=["reaction_time", "density"], groupby=["condition", "condition_num"], extent=[200, 600]
     )
-    .transform_calculate(
-        # Scale density and offset to create half-violin on TOP (positive y direction)
-        violin_pos="datum.condition_num + 0.05 + datum.density * 180"
-    )
+    .transform_calculate(violin_pos="datum.condition_num + 0.05 + datum.density * 200")
     .mark_area(orient="vertical", opacity=0.7)
     .encode(
         x=alt.X("reaction_time:Q"),
         y=alt.Y("condition_num:Q", axis=None).scale(domain=[-0.6, 2.6]),
         y2="violin_pos:Q",
         color=alt.Color(
             "condition:N",
-            scale=alt.Scale(domain=condition_order, range=["#306998", "#FFD43B", "#4CAF50"]),
+            scale=alt.Scale(domain=condition_order, range=colors),
             legend=alt.Legend(
                 title="Condition",
                 titleFontSize=20,
@@ -75,7 +74,7 @@
     )
 )
 
-# Box plot - HORIZONTAL orientation (values on x, categories on y)
+# Box plot — centered on category baseline
 boxplot = (
     alt.Chart(data)
     .transform_calculate(box_pos="datum.condition_num + 0.02")
@@ -84,40 +83,34 @@
         orient="horizontal",
         median={"color": "white", "strokeWidth": 3},
         box={"strokeWidth": 2},
-        outliers={"opacity": 0},  # Hide outliers, shown as jittered points
+        outliers={"opacity": 0},
     )
     .encode(
         x=alt.X("reaction_time:Q", title="Reaction Time (ms)", scale=alt.Scale(domain=[200, 600])),
         y=alt.Y("box_pos:Q", axis=None),
-        color=alt.Color(
-            "condition:N", scale=alt.Scale(domain=condition_order, range=["#306998", "#FFD43B", "#4CAF50"])
-        ),
+        color=alt.Color("condition:N", scale=alt.Scale(domain=condition_order, range=colors)),
     )
 )
 
-# Jittered strip plot (rain) - positioned clearly BELOW the center
+# Jittered strip — rain BELOW baseline
 strip = (
     alt.Chart(data)
-    .mark_circle(size=40, opacity=0.6)
+    .mark_circle(size=55, opacity=0.6)
     .encode(
         x=alt.X("reaction_time:Q"),
         y=alt.Y("jitter_pos:Q", axis=None),
-        color=alt.Color(
-            "condition:N", scale=alt.Scale(domain=condition_order, range=["#306998", "#FFD43B", "#4CAF50"])
-        ),
+        color=alt.Color("condition:N", scale=alt.Scale(domain=condition_order, range=colors)),
         tooltip=[
             alt.Tooltip("condition:N", title="Condition"),
             alt.Tooltip("reaction_time:Q", title="Reaction Time (ms)", format=".1f"),
         ],
     )
 )
 
-# Main chart layer with raincloud elements
-main_chart = (
-    alt.layer(violin, boxplot, strip).properties(width=1600, height=850).interactive()  # Enable zoom and pan
-)
+# Compose layers
+main_chart = alt.layer(violin, boxplot, strip).properties(width=1600, height=850).interactive()
 
-# Y-axis labels as a separate chart on the left
+# Y-axis labels
 y_axis_data = pd.DataFrame({"condition": condition_order, "y_pos": [0, 1, 2]})
 
 y_axis_labels = (
@@ -127,14 +120,14 @@
     .properties(width=120, height=850)
 )
 
-# Combine using horizontal concatenation
+# Final chart
 chart = (
     alt.hconcat(y_axis_labels, main_chart, spacing=5)
     .properties(title=alt.Title("raincloud-basic · altair · pyplots.ai", fontSize=28, anchor="middle"))
-    .configure_axis(labelFontSize=18, titleFontSize=22, gridOpacity=0.3)
+    .configure_axis(labelFontSize=18, titleFontSize=22, gridOpacity=0.4)
     .configure_view(strokeWidth=0)
 )
 
-# Save outputs
+# Save
 chart.save("plot.png", scale_factor=3.0)
 chart.save("plot.html")

plots/raincloud-basic/metadata/altair.yaml

@@ -1,16 +1,16 @@
 library: altair
 specification_id: raincloud-basic
 created: '2025-12-25T08:23:10Z'
-updated: '2025-12-25T08:25:15Z'
-generated_by: claude-opus-4-5-20251101
+updated: 2026-02-14T20:28:11+00:00
+generated_by: claude-opus-4-6
 workflow_run: 20501865366
 issue: 0
-python_version: 3.13.11
-library_version: 6.0.0
+python_version: "3.14"
+library_version: "6.0.0"
 preview_url: https://storage.googleapis.com/pyplots-images/plots/raincloud-basic/altair/plot.png
 preview_thumb: https://storage.googleapis.com/pyplots-images/plots/raincloud-basic/altair/plot_thumb.png
 preview_html: https://storage.googleapis.com/pyplots-images/plots/raincloud-basic/altair/plot.html
-quality_score: 90
+quality_score: null
 impl_tags:
   dependencies: []
   techniques:

plots/raincloud-basic/specification.md

@@ -20,10 +20,10 @@ A raincloud plot combines three visualization elements—a half-violin (the "clo
 
 ## Notes
 
-- **Required Orientation**: Use HORIZONTAL orientation with categories on y-axis and values on x-axis
-- **Critical Layout**: The "cloud" (half-violin/KDE) must be on TOP (positive y offset), boxplot in MIDDLE, and "rain" (jittered points) BELOW (negative y offset) - like rain falling from a cloud
+- **Required Orientation**: Use HORIZONTAL orientation with categories on y-axis and values on x-axis. "Above" and "below" always refer to the y-direction (screen up/down), not the x-direction
+- **Critical Layout**: For each category on the y-axis: the "cloud" (half-violin/KDE) must extend ABOVE the category baseline (upward on screen), the boxplot sits centered ON the category baseline, and "rain" (jittered points) must appear BELOW the category baseline (downward on screen) - like rain falling from a cloud
 - Clip the violin to show only half (the "cloud" portion), not a full violin
 - Use moderate jitter (0.05-0.1) to spread rain points without excessive overlap
 - Apply transparency (alpha 0.5-0.7) to jittered rain points for visibility
 - Include median and quartile markers in box plot
-- The visual metaphor must be clear: cloud above, rain falling below
+- The visual metaphor must be clear: cloud rises upward (positive y-direction), rain falls downward (negative y-direction) from each category line