{"spec_id":"shap-waterfall","library":"matplotlib","language":"python","code":"\"\"\" anyplot.ai\nshap-waterfall: SHAP Waterfall Plot for Feature Attribution\nLibrary: matplotlib 3.11.2 | Python 3.14.10\nQuality: 86/100 | Updated: 2026-11-12\n\"\"\"\n\nimport os\n\nimport matplotlib.patches as mpatches\nimport matplotlib.pyplot as plt\nimport numpy as np\nimport pandas as pd\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\"\nINK_MUTED = \"#6B6A63\" if THEME == \"light\" else \"#A8A79F\"\n\n# Imprint palette (full list, canonical order)\nIMPRINT_PALETTE = [\"#009E73\", \"#C475FD\", \"#4467A3\", \"#BD8233\", \"#AE3030\", \"#2ABCCD\", \"#954477\", \"#99B314\"]\n\n# Constants\nCOLOR_POS = \"#AE3030\"  # Imprint red: positive SHAP (pushes prediction up)\nCOLOR_NEG = \"#4467A3\"  # Imprint blue: negative SHAP (pushes prediction down)\nLABEL_SHARE = 0.11  # a bar shorter than this share of the largest |SHAP| carries its label outside\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 E[f(x)]\"  # role: base_value\n\n# Data: replace this block with your own table, for example df = pd.read_csv(\"shap.csv\")\n# Credit loan approval model, one applicant's explanation; the base value repeats on every row\ndf = pd.DataFrame(\n    {\n        FEATURE: [\n            \"Monthly Income\",\n            \"Debt-to-Income Ratio\",\n            \"Credit Score\",\n            \"Employment Duration\",\n            \"Prior Defaults\",\n            \"Loan Amount\",\n            \"Age\",\n            \"Open Credit Lines\",\n            \"Savings Balance\",\n            \"Recent Inquiries\",\n        ],\n        SHAP_VALUE: [0.24, -0.18, 0.15, 0.12, -0.10, -0.08, 0.06, 0.04, 0.03, -0.02],\n        BASE_VALUE: [0.42] * 10,\n    }\n)\n\n# Plot: reads only df and the constants above\n# Largest |SHAP| at the top; matplotlib draws y from the bottom, so sort ascending\n# A feature without a SHAP value has no segment in the chain, so it is skipped\ntable = df.dropna(subset=[SHAP_VALUE])\ntable = table.reindex(table[SHAP_VALUE].abs().sort_values(kind=\"stable\").index).reset_index(drop=True)\nshap_values = table[SHAP_VALUE].to_numpy(dtype=float)\nbase_value = float(df[BASE_VALUE].dropna().iloc[0])\nfinal_value = base_value + float(shap_values.sum())\nn = len(table)\ny_pos = np.arange(n)\n\n# Running totals from the bottom bar upwards, starting at the base value\ncum_after = base_value + np.cumsum(shap_values)\ncum_before = cum_after - shap_values\nbar_lefts = np.minimum(cum_before, cum_after)\nbar_widths = np.abs(shap_values)\nbar_colors = [COLOR_POS if sv >= 0 else COLOR_NEG for sv in shap_values]\n\ntitle = \"Credit Approval · shap-waterfall · python · matplotlib · anyplot.ai\"\ntitle_fontsize = max(8, round(12 * 67 / len(title))) if len(title) > 67 else 12\n\nfig, ax = plt.subplots(figsize=(8, 4.5), dpi=400, facecolor=PAGE_BG)\nax.set_facecolor(PAGE_BG)\nax.set_axisbelow(True)\n\nax.barh(y_pos, bar_widths, left=bar_lefts, color=bar_colors, height=0.55, edgecolor=PAGE_BG, linewidth=0.8, zorder=3)\n\n# Connectors: a dotted segment at each running total, bridging the gap to the next bar\nfor i in range(n - 1):\n    ax.plot(\n        [cum_after[i], cum_after[i]],\n        [y_pos[i] + 0.32, y_pos[i + 1] - 0.32],\n        color=INK_MUTED,\n        linewidth=0.7,\n        linestyle=\"dotted\",\n        alpha=0.7,\n        zorder=2,\n    )\n\n# Reference lines for base value and final prediction\nax.axvline(base_value, color=INK_MUTED, linewidth=0.8, linestyle=\"--\", alpha=0.6)\nax.axvline(final_value, color=INK_SOFT, linewidth=1.0, linestyle=\"--\", alpha=0.7)\n\n# SHAP value labels: inside wide bars, beside narrow ones\nx_span = float(max(cum_after.max(), cum_before.max()) - bar_lefts.min())\nlabel_gap = 0.012 * x_span\nlabel_threshold = LABEL_SHARE * bar_widths.max()\nfor i, (sv, left, width) in enumerate(zip(shap_values, bar_lefts, bar_widths, strict=True)):\n    txt = f\"+{sv:.2f}\" if sv > 0 else f\"{sv:.2f}\"\n    if width >= label_threshold:\n        ax.text(\n            left + width / 2,\n            y_pos[i],\n            txt,\n            ha=\"center\",\n            va=\"center\",\n            fontsize=7,\n            fontweight=\"bold\",\n            color=\"white\",\n            zorder=5,\n        )\n    else:\n        positive = sv > 0\n        ax.text(\n            left + width + label_gap if positive else left - label_gap,\n            y_pos[i],\n            txt,\n            ha=\"left\" if positive else \"right\",\n            va=\"center\",\n            fontsize=7,\n            fontweight=\"bold\",\n            color=COLOR_POS if positive else COLOR_NEG,\n            zorder=5,\n        )\n\n# Annotations for base value and final prediction above the top bar\ntop_y = n + 0.08\nax.text(\n    base_value,\n    top_y,\n    f\"E[f(x)] = {base_value:.2f}\",\n    ha=\"center\",\n    va=\"bottom\",\n    fontsize=7,\n    color=INK_MUTED,\n    bbox={\n        \"facecolor\": ELEVATED_BG,\n        \"edgecolor\": INK_MUTED,\n        \"boxstyle\": \"round,pad=0.35\",\n        \"alpha\": 0.9,\n        \"linewidth\": 0.6,\n    },\n)\nax.text(\n    final_value,\n    top_y,\n    f\"f(x) = {final_value:.2f}\",\n    ha=\"center\",\n    va=\"bottom\",\n    fontsize=7,\n    fontweight=\"bold\",\n    color=INK,\n    bbox={\n        \"facecolor\": ELEVATED_BG,\n        \"edgecolor\": INK_SOFT,\n        \"boxstyle\": \"round,pad=0.35\",\n        \"alpha\": 0.9,\n        \"linewidth\": 0.6,\n    },\n)\n\n# Style\nax.set_yticks(y_pos, table[FEATURE])\nax.set_xlabel(\"Loan Approval Probability\", fontsize=10, color=INK)\nax.set_title(title, fontsize=title_fontsize, fontweight=\"medium\", color=INK)\n\nall_x = np.concatenate([bar_lefts, bar_lefts + bar_widths, [base_value, final_value]])\nax.set_xlim(all_x.min() - 0.1 * x_span, all_x.max() + 0.15 * x_span)\nax.set_ylim(-0.6, n + 0.9)\n\nax.tick_params(axis=\"x\", labelsize=8, colors=INK_SOFT)\nax.tick_params(axis=\"y\", labelsize=8, colors=INK_SOFT, length=0)\n\nax.spines[\"top\"].set_visible(False)\nax.spines[\"right\"].set_visible(False)\nax.spines[\"left\"].set_visible(False)\nax.spines[\"bottom\"].set_color(INK_SOFT)\n\nax.xaxis.grid(True, alpha=0.10, linewidth=0.5, color=INK)\n\n# Legend\npos_patch = mpatches.Patch(color=COLOR_POS, label=\"Positive contribution\")\nneg_patch = mpatches.Patch(color=COLOR_NEG, label=\"Negative contribution\")\nleg = ax.legend(handles=[pos_patch, neg_patch], fontsize=8, loc=\"lower right\", frameon=True)\nleg.get_frame().set_facecolor(ELEVATED_BG)\nleg.get_frame().set_edgecolor(INK_SOFT)\nplt.setp(leg.get_texts(), color=INK_SOFT)\n\nplt.tight_layout()\nplt.savefig(f\"plot-{THEME}.png\", dpi=400, facecolor=PAGE_BG)\n"}