{"spec_id":"shap-waterfall","library":"altair","language":"python","code":"\"\"\" anyplot.ai\nshap-waterfall: SHAP Waterfall Plot for Feature Attribution\nLibrary: altair 6.3.0 | Python 3.14.10\nQuality: 82/100 | Updated: 2026-11-13\n\"\"\"\n\nimport os\n\nimport altair as alt\nimport numpy as np\nimport pandas as pd\nfrom PIL import Image\n\n\n# Theme tokens\nTHEME = os.getenv(\"ANYPLOT_THEME\", \"light\")\nPAGE_BG = \"#FAF8F1\" if THEME == \"light\" else \"#1A1A17\"\nELEVATED_BG = \"#FFFDF6\" if THEME == \"light\" else \"#242420\"\nINK = \"#1A1A17\" if THEME == \"light\" else \"#F0EFE8\"\nINK_SOFT = \"#4A4A44\" if THEME == \"light\" else \"#B8B7B0\"\n\n# Imprint palette: all eight positions in canonical order\nIMPRINT_PALETTE = [\"#009E73\", \"#C475FD\", \"#4467A3\", \"#BD8233\", \"#AE3030\", \"#2ABCCD\", \"#954477\", \"#99B314\"]\n\n# Constants\nPOS_COLOR = IMPRINT_PALETTE[4]  # red: pushes the prediction up (semantic, the spec asks for red)\nNEG_COLOR = IMPRINT_PALETTE[2]  # blue: pushes the prediction down\nPOSITIVE, NEGATIVE = \"positive\", \"negative\"\n\n# Columns: set these to your table's column names\nFEATURE = \"Feature\"  # role: feature\nSHAP_VALUE = \"SHAP value\"  # role: shap_value\nBASE_VALUE = \"Base value\"  # role: base_value\n\n# Data: replace this block with your own table, for example df = pd.read_csv(\"shap.csv\")\n# Loan application: individual credit default prediction, one row per feature\ndf = pd.DataFrame(\n    {\n        FEATURE: [\n            \"Debt-to-Income Ratio\",\n            \"Credit Score\",\n            \"Annual Income\",\n            \"Late Payments (Count)\",\n            \"Home Ownership\",\n            \"Employment Length\",\n            \"Savings Balance\",\n            \"Loan Amount\",\n            \"Credit Utilization\",\n            \"Credit Age (Years)\",\n            \"Open Accounts\",\n            \"Recent Inquiries\",\n        ],\n        SHAP_VALUE: [0.21, 0.17, -0.14, 0.13, -0.09, 0.08, -0.06, 0.05, -0.04, -0.03, 0.02, -0.01],\n        BASE_VALUE: [0.32] * 12,\n    }\n)\n\n# Plot: reads only df and the constants above\nESCAPE = str.maketrans({\".\": \"\\\\.\", \"[\": \"\\\\[\", \"]\": \"\\\\]\", \":\": \"\\\\:\"})\nF, S = FEATURE.translate(ESCAPE), SHAP_VALUE.translate(ESCAPE)\nDIRECTION, START, END, LABEL = \"Direction\", \"From\", \"To\", \"Label\"\n\n# Largest absolute contribution at the top, then stack cumulatively from the base value\nbase_value = df[BASE_VALUE].iloc[0]\ndata = df.reindex(df[SHAP_VALUE].abs().sort_values(ascending=False, kind=\"stable\").index).reset_index(drop=True)\ndata[END] = base_value + data[SHAP_VALUE].cumsum()\ndata[START] = data[END] - data[SHAP_VALUE]\ndata[DIRECTION] = np.where(data[SHAP_VALUE] > 0, POSITIVE, NEGATIVE)\ndata[LABEL] = data[SHAP_VALUE].map(\"{:+.2f}\".format)\nfinal_value = data[END].iloc[-1]\norder = data[FEATURE].tolist()\ntop_feature = order[0]\n\nx_pad = 0.07\nx_scale = alt.Scale(domain=[data[[START, END]].min().min() - x_pad, data[[START, END]].max().max() + x_pad])\nx_enc = alt.X(f\"{START}:Q\", scale=x_scale, axis=alt.Axis(title=\"Probability of default\", format=\".2f\"))\ny_enc = alt.Y(F, type=\"nominal\", sort=order, axis=alt.Axis(title=None, labelLimit=260))\ndir_scale = alt.Scale(domain=[POSITIVE, NEGATIVE], range=[POS_COLOR, NEG_COLOR])\n\nbars = (\n    alt.Chart(data)\n    .mark_bar(opacity=0.9)\n    .encode(\n        x=x_enc,\n        x2=END,\n        y=y_enc,\n        color=alt.Color(\n            f\"{DIRECTION}:N\",\n            scale=dir_scale,\n            legend=alt.Legend(title=\"SHAP direction\", orient=\"bottom-right\", offset=6),\n        ),\n        tooltip=[\n            alt.Tooltip(F, type=\"nominal\", title=FEATURE),\n            alt.Tooltip(S, type=\"quantitative\", title=SHAP_VALUE, format=\"+.3f\"),\n            alt.Tooltip(f\"{START}:Q\", title=\"From\", format=\".3f\"),\n            alt.Tooltip(f\"{END}:Q\", title=\"To\", format=\".3f\"),\n        ],\n    )\n)\n\n# SHAP value labels beside the bar end: right of positive bars, left of negative ones\nlabels = alt.Chart(data).encode(\n    x=alt.X(f\"{END}:Q\", scale=x_scale),\n    y=y_enc,\n    text=f\"{LABEL}:N\",\n    color=alt.Color(f\"{DIRECTION}:N\", scale=dir_scale, legend=None),\n)\ntext_pos = labels.transform_filter(alt.datum[DIRECTION] == POSITIVE).mark_text(\n    align=\"left\", dx=5, fontSize=10, fontWeight=\"bold\"\n)\ntext_neg = labels.transform_filter(alt.datum[DIRECTION] == NEGATIVE).mark_text(\n    align=\"right\", dx=-5, fontSize=10, fontWeight=\"bold\"\n)\n\n\ndef reference(value, text, dash, width, weight):\n    \"\"\"Reference rule at value plus its label above the top row.\"\"\"\n    frame = pd.DataFrame({\"x\": [value], FEATURE: [top_feature], \"text\": [text]})\n    rule = (\n        alt.Chart(frame)\n        .mark_rule(strokeDash=dash, strokeWidth=width, opacity=0.6)\n        .encode(x=alt.X(\"x:Q\", scale=x_scale), color=alt.value(INK if weight == \"bold\" else INK_SOFT))\n    )\n    note = (\n        alt.Chart(frame)\n        .mark_text(align=\"center\", dy=-22, fontSize=10, fontWeight=weight)\n        .encode(\n            x=alt.X(\"x:Q\", scale=x_scale),\n            y=y_enc,\n            text=\"text:N\",\n            color=alt.value(INK if weight == \"bold\" else INK_SOFT),\n        )\n    )\n    return rule, note\n\n\nbase_rule, base_note = reference(base_value, f\"Base = {base_value:.2f}\", [4, 3], 1, \"normal\")\nfinal_rule, final_note = reference(final_value, f\"Prediction = {final_value:.2f}\", [], 1.5, \"bold\")\n\nchart = (\n    alt.layer(base_rule, final_rule, bars, text_pos, text_neg, base_note, final_note)\n    .properties(\n        width=620,\n        height=340,\n        padding={\"left\": 0, \"right\": 0, \"top\": 12, \"bottom\": 0},\n        title=alt.Title(\"Credit Default Risk · shap-waterfall · python · altair · anyplot.ai\", fontSize=16),\n        background=PAGE_BG,\n    )\n    .configure_view(fill=PAGE_BG, stroke=None)\n    .configure_axis(\n        domainColor=INK_SOFT,\n        tickColor=INK_SOFT,\n        gridColor=INK,\n        gridOpacity=0.10,\n        labelColor=INK_SOFT,\n        titleColor=INK,\n        labelFontSize=10,\n        titleFontSize=12,\n    )\n    .configure_title(color=INK)\n    .configure_legend(\n        fillColor=ELEVATED_BG,\n        strokeColor=INK_SOFT,\n        labelColor=INK_SOFT,\n        titleColor=INK,\n        labelFontSize=10,\n        titleFontSize=10,\n        padding=6,\n    )\n)\n\n# Save\nchart.save(f\"plot-{THEME}.png\", scale_factor=4.0)\nchart.save(f\"plot-{THEME}.html\")\n\n# Pad (never crop) to the exact landscape canvas\nTARGET_W, TARGET_H = 3200, 1800\nimg = Image.open(f\"plot-{THEME}.png\").convert(\"RGB\")\nw, h = img.size\nif w > TARGET_W or h > TARGET_H:\n    raise SystemExit(f\"altair produced {w}x{h}, exceeds {TARGET_W}x{TARGET_H}; shrink width/height\")\ncanvas = Image.new(\"RGB\", (TARGET_W, TARGET_H), PAGE_BG)\ncanvas.paste(img, ((TARGET_W - w) // 2, (TARGET_H - h) // 2))\ncanvas.save(f\"plot-{THEME}.png\")\n"}