{"spec_id":"shap-waterfall","library":"plotnine","language":"python","code":"\"\"\" anyplot.ai\nshap-waterfall: SHAP Waterfall Plot for Feature Attribution\nLibrary: plotnine 0.15.9 | Python 3.14.10\nQuality: 80/100 | Updated: 2026-11-17\n\"\"\"\n\nimport os\n\nimport pandas as pd\nfrom plotnine import (\n    aes,\n    coord_cartesian,\n    element_blank,\n    element_line,\n    element_rect,\n    element_text,\n    geom_rect,\n    geom_segment,\n    geom_text,\n    geom_vline,\n    ggplot,\n    labs,\n    scale_fill_manual,\n    scale_y_continuous,\n    theme,\n)\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\"\nGRID_COLOR = \"#C8C7C0\" if THEME == \"light\" else \"#2E2E2B\"\n\n# Imprint palette: all eight positions in canonical order\nIMPRINT_PALETTE = [\"#009E73\", \"#C475FD\", \"#4467A3\", \"#BD8233\", \"#AE3030\", \"#2ABCCD\", \"#954477\", \"#99B314\"]\n\n# Constants: semantic colors of a SHAP plot (red pushes the prediction up, blue pushes it down)\nCOLOR_POS = IMPRINT_PALETTE[4]\nCOLOR_NEG = IMPRINT_PALETTE[2]\n\n# Columns: set these to your table's column names\nFEATURE = \"Feature\"  # role: feature\nSHAP = \"SHAP Value (Feature Contribution)\"  # role: shap_value\nBASE = \"Base value\"  # role: base_value\n\n# Data: replace this block with your own table, for example df = pd.read_csv(\"shap.csv\")\n# Credit scoring model, explaining a single loan approval prediction\ndf = pd.DataFrame(\n    {\n        FEATURE: [\n            \"Annual Income\",\n            \"Credit Score\",\n            \"Debt-to-Income\",\n            \"Employment Years\",\n            \"Loan Amount\",\n            \"Payment History\",\n            \"Num Credit Lines\",\n            \"Savings Balance\",\n            \"Age\",\n            \"Recent Inquiries\",\n            \"Education Level\",\n            \"Home Ownership\",\n        ],\n        SHAP: [0.18, 0.14, -0.12, 0.09, -0.08, 0.06, -0.05, 0.05, 0.04, -0.03, 0.02, -0.01],\n        BASE: [0.34] * 12,\n    }\n)\n\n# Plot: reads only df and the constants above\nbase_value = df[BASE].iloc[0]\nfinal_value = base_value + df[SHAP].sum()\n\n# Largest |SHAP| first (top of the chart), then the cumulative chain from base to final\nd = df.reindex(df[SHAP].abs().sort_values(ascending=False, kind=\"stable\").index).reset_index(drop=True)\nn = len(d)\nd[\"start\"] = base_value + d[SHAP].cumsum().shift(1).fillna(0)\nd[\"end\"] = d[\"start\"] + d[SHAP]\nd[\"y_pos\"] = range(n, 0, -1)\nd[\"direction\"] = d[SHAP].apply(lambda v: \"Positive\" if v >= 0 else \"Negative\")\nd[\"bar_label\"] = d[SHAP].apply(lambda v: f\"{v:+.3f}\")\n\nBAR_H = 0.65\nd[\"ymin\"] = d[\"y_pos\"] - BAR_H / 2\nd[\"ymax\"] = d[\"y_pos\"] + BAR_H / 2\n\n# Dashed connectors between adjacent bars at their shared boundary\nconn = pd.DataFrame(\n    {\"x\": d[\"end\"].iloc[:-1].to_numpy(), \"y0\": d[\"ymax\"].iloc[1:].to_numpy(), \"y1\": d[\"ymin\"].iloc[:-1].to_numpy()}\n)\n\n# Labeled reference points for the base value and the final prediction\nann_base = pd.DataFrame({\"x\": [base_value], \"y\": [n + 0.85], \"label\": [f\"Base = {base_value:.2f}\"]})\nann_final = pd.DataFrame({\"x\": [final_value], \"y\": [0.15], \"label\": [f\"Pred = {final_value:.2f}\"]})\n\n# Bar labels: right of positive bar ends, left of negative ones\npos_bars = d[d[SHAP] >= 0]\nneg_bars = d[d[SHAP] < 0]\nspan = max(d[\"start\"].max(), d[\"end\"].max()) - min(d[\"start\"].min(), d[\"end\"].min())\nnudge = span * 0.015\n\nx_left = min(d[\"start\"].min(), d[\"end\"].min()) - span * 0.12\nx_right = max(d[\"start\"].max(), d[\"end\"].max()) + span * 0.2\n\nanyplot_theme = theme(\n    figure_size=(8, 4.5),\n    plot_background=element_rect(fill=PAGE_BG, color=PAGE_BG),\n    panel_background=element_rect(fill=PAGE_BG),\n    panel_grid_major_x=element_line(color=GRID_COLOR, size=0.3),\n    panel_grid_major_y=element_blank(),\n    panel_grid_minor=element_blank(),\n    panel_border=element_blank(),\n    axis_title_x=element_text(color=INK, size=10),\n    axis_title_y=element_blank(),\n    axis_text_x=element_text(color=INK_SOFT, size=8),\n    axis_text_y=element_text(color=INK, size=8),\n    axis_line_x=element_line(color=INK_SOFT),\n    axis_line_y=element_blank(),\n    axis_ticks_major_x=element_blank(),\n    axis_ticks_major_y=element_blank(),\n    plot_title=element_text(color=INK, size=12, ha=\"left\"),\n    legend_background=element_rect(fill=ELEVATED_BG, color=INK_SOFT),\n    legend_text=element_text(color=INK_SOFT, size=8),\n    legend_title=element_text(color=INK, size=9),\n    legend_position=\"right\",\n)\n\nplot = (\n    ggplot(d)\n    + geom_rect(aes(xmin=\"start\", xmax=\"end\", ymin=\"ymin\", ymax=\"ymax\", fill=\"direction\"))\n    + geom_segment(\n        data=conn, mapping=aes(x=\"x\", xend=\"x\", y=\"y0\", yend=\"y1\"), color=INK_SOFT, linetype=\"dashed\", size=0.4\n    )\n    + geom_vline(xintercept=base_value, color=INK_SOFT, linetype=\"dotted\", size=0.6)\n    + geom_vline(xintercept=final_value, color=INK_SOFT, linetype=\"dotted\", size=0.6)\n    + geom_text(\n        data=pos_bars, mapping=aes(x=\"end\", y=\"y_pos\", label=\"bar_label\"), nudge_x=nudge, ha=\"left\", color=INK, size=7\n    )\n    + geom_text(\n        data=neg_bars, mapping=aes(x=\"end\", y=\"y_pos\", label=\"bar_label\"), nudge_x=-nudge, ha=\"right\", color=INK, size=7\n    )\n    + geom_text(\n        data=ann_base,\n        mapping=aes(x=\"x\", y=\"y\", label=\"label\"),\n        nudge_x=nudge,\n        ha=\"left\",\n        va=\"bottom\",\n        color=INK_SOFT,\n        size=7.5,\n    )\n    + geom_text(\n        data=ann_final,\n        mapping=aes(x=\"x\", y=\"y\", label=\"label\"),\n        nudge_x=nudge,\n        ha=\"left\",\n        va=\"top\",\n        color=INK_SOFT,\n        size=7.5,\n    )\n    + scale_fill_manual(values={\"Positive\": COLOR_POS, \"Negative\": COLOR_NEG}, name=\"Contribution\")\n    + scale_y_continuous(breaks=d[\"y_pos\"].tolist(), labels=d[FEATURE].tolist(), expand=(0.05, 0))\n    + coord_cartesian(xlim=(x_left, x_right), ylim=(-0.2, n + 1.5))\n    + labs(x=SHAP, y=\"\", title=\"Loan Approval · shap-waterfall · python · plotnine · anyplot.ai\")\n    + anyplot_theme\n)\n\nplot.save(f\"plot-{THEME}.png\", dpi=400, width=8, height=4.5, units=\"in\")\n"}