{"spec_id":"shap-waterfall","library":"seaborn","language":"python","code":"\"\"\" anyplot.ai\nshap-waterfall: SHAP Waterfall Plot for Feature Attribution\nLibrary: seaborn 0.13.2 | Python 3.14.10\nQuality: 84/100 | Updated: 2026-11-13\n\"\"\"\n\nimport os\nimport sys\n\n\n# Prevent self-import: remove this script's directory from sys.path\n_script_dir = os.path.dirname(os.path.abspath(__file__))\nif _script_dir in sys.path:\n    sys.path.remove(_script_dir)\n\nimport matplotlib.patches as mpatches\nimport matplotlib.pyplot as plt\nimport numpy as np\nimport pandas as pd\nimport seaborn as sns\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: positive SHAP uses position 5 (red), negative uses position 3 (blue)\nIMPRINT_PALETTE = [\"#009E73\", \"#C475FD\", \"#4467A3\", \"#BD8233\", \"#AE3030\", \"#2ABCCD\", \"#954477\", \"#99B314\"]\nCOLOR_POS = IMPRINT_PALETTE[4]  # raises the prediction\nCOLOR_NEG = IMPRINT_PALETTE[2]  # lowers the prediction\n\nsns.set_theme(\n    style=\"ticks\",\n    rc={\n        \"figure.facecolor\": PAGE_BG,\n        \"axes.facecolor\": PAGE_BG,\n        \"axes.edgecolor\": INK_SOFT,\n        \"axes.labelcolor\": INK,\n        \"text.color\": INK,\n        \"xtick.color\": INK_SOFT,\n        \"ytick.color\": INK_SOFT,\n        \"grid.color\": INK,\n        \"grid.alpha\": 0.10,\n        \"legend.facecolor\": ELEVATED_BG,\n        \"legend.edgecolor\": INK_SOFT,\n    },\n)\n\n# Columns: set these to your table's column names\nFEATURE = \"Feature\"  # role: feature\nSHAP = \"SHAP value\"  # role: shap_value\nBASE = \"Base value (default probability)\"  # 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 predicting loan default probability for a single applicant.\ndf = pd.DataFrame(\n    {\n        FEATURE: [\n            \"Late Payment Count\",\n            \"Credit Score\",\n            \"Debt-to-Income Ratio\",\n            \"Loan Amount\",\n            \"Monthly Income\",\n            \"Employment Years\",\n            \"Public Records\",\n            \"Savings Balance\",\n            \"Account Age\",\n            \"Credit Lines\",\n        ],\n        SHAP: [0.24, -0.18, 0.16, 0.11, -0.10, -0.07, 0.06, -0.05, -0.04, 0.03],\n        BASE: 0.32,\n    }\n)\n\n# Plot\n# Largest |SHAP| at the top; the chain is built from the smallest feature upward\ntable = df.reindex(df[SHAP].abs().sort_values(ascending=False, kind=\"stable\").index)\ntable = table.iloc[::-1].reset_index(drop=True)\nn = len(table)\nbase_value = table[BASE].iloc[0]\nshap_btt = table[SHAP].to_numpy()\nrunning = np.concatenate([[base_value], base_value + np.nancumsum(shap_btt)])\nstarts_btt, ends_btt = running[:-1], running[1:]\nfinal_value = running[-1]\n\nbar_lefts = np.minimum(starts_btt, ends_btt)\nbar_widths = np.abs(shap_btt)\nbar_colors = [COLOR_POS if v >= 0 else COLOR_NEG for v in shap_btt]\ny_pos = np.arange(n)\ndominant = int(np.nanargmax(bar_widths))\n\nfig, ax = plt.subplots(figsize=(8, 4.5), dpi=400, facecolor=PAGE_BG)\nax.set_facecolor(PAGE_BG)\n\n# Waterfall bars; the dominant feature gets a thicker edge as focal emphasis\nfor i, (yi, left, width, color) in enumerate(zip(y_pos, bar_lefts, bar_widths, bar_colors, strict=True)):\n    ax.barh(\n        yi,\n        width,\n        left=left,\n        color=color,\n        height=0.55,\n        zorder=3,\n        edgecolor=INK_SOFT if i == dominant else PAGE_BG,\n        linewidth=0.75 if i == dominant else 0.25,\n    )\n\n# Dotted connectors at the cumulative junctions between adjacent bars\nfor j in range(n - 1):\n    cx = ends_btt[j]\n    ax.plot([cx, cx], [j + 0.30, j + 0.70], color=INK_SOFT, linewidth=0.5, linestyle=\":\", zorder=2, alpha=0.65)\n\n# Connector dots (seaborn scatterplot) mark the running total at each junction\nconnector_df = pd.DataFrame({\"running\": ends_btt[:-1], \"position\": np.arange(n - 1) + 0.5})\nsns.scatterplot(data=connector_df, x=\"running\", y=\"position\", ax=ax, color=INK_SOFT, s=12, zorder=5, alpha=0.75)\nax.set_ylabel(\"\")\n\n# SHAP value labels beside bars\nfor yi, left, width, shap in zip(y_pos, bar_lefts, bar_widths, shap_btt, strict=True):\n    if shap >= 0:\n        ax.text(\n            left + width,\n            yi,\n            f\"  +{shap:.2f}\",\n            ha=\"left\",\n            va=\"center\",\n            color=COLOR_POS,\n            fontsize=8,\n            fontweight=\"bold\",\n            zorder=4,\n        )\n    else:\n        ax.text(\n            left, yi, f\"{shap:.2f}  \", ha=\"right\", va=\"center\", color=COLOR_NEG, fontsize=8, fontweight=\"bold\", zorder=4\n        )\n\n# Reference lines for the base value and the final prediction\nax.axvline(base_value, color=INK_SOFT, linewidth=0.75, linestyle=\"--\", zorder=1, alpha=0.85)\nax.axvline(final_value, color=INK, linewidth=1.0, linestyle=\"-\", zorder=1, alpha=0.90)\nax.text(base_value, -0.75, f\"E[f(x)] = {base_value:.2f}\", ha=\"center\", va=\"center\", fontsize=8, color=INK_SOFT)\nax.text(\n    final_value,\n    n - 0.5,\n    f\"  f(x) = {final_value:.2f}\",\n    ha=\"left\",\n    va=\"center\",\n    fontsize=8,\n    color=INK,\n    fontweight=\"bold\",\n)\n\n# Axes: the dominant feature's label is bold\nax.set_yticks(y_pos)\nax.set_yticklabels(table[FEATURE], fontsize=8)\nax.get_yticklabels()[dominant].set_fontweight(\"bold\")\nax.tick_params(axis=\"y\", length=0)\nax.tick_params(axis=\"x\", labelsize=8, colors=INK_SOFT)\nax.set_xlabel(\"Model Output (Default Probability)\", fontsize=10, color=INK)\n\nax.xaxis.grid(True, alpha=0.10, linewidth=0.4, color=INK, zorder=0)\nax.set_axisbelow(True)\n\nsns.despine(ax=ax, left=True, top=True, right=True)\nax.spines[\"bottom\"].set_color(INK_SOFT)\n\nax.legend(\n    handles=[\n        mpatches.Patch(color=COLOR_POS, label=\"Positive SHAP  (↑ prediction)\"),\n        mpatches.Patch(color=COLOR_NEG, label=\"Negative SHAP  (↓ prediction)\"),\n    ],\n    loc=\"lower right\",\n    fontsize=8,\n    framealpha=0.9,\n    facecolor=ELEVATED_BG,\n    edgecolor=INK_SOFT,\n)\n\nx_all = running\nax.set_xlim(np.nanmin(x_all) - 0.06, np.nanmax(x_all) + 0.16)\nax.set_ylim(-1.0, n)\n\ntitle = \"Credit Default Prediction · shap-waterfall · python · seaborn · anyplot.ai\"\ntitle_fontsize = round(12 * (67 / len(title) if len(title) > 67 else 1.0))\nax.set_title(title, fontsize=title_fontsize, fontweight=\"medium\", color=INK, pad=8)\n\nfig.subplots_adjust(left=0.17, right=0.97, top=0.92, bottom=0.14)\nplt.savefig(f\"plot-{THEME}.png\", dpi=400, facecolor=PAGE_BG)\n"}