SHAP Files

Highlights

• Python 3.15.0rc2 support: SHAP now builds and runs tests against Python 3.15 pre-releases, including Python 3.15.0rc2. By @CloseChoice in https://github.com/shap/shap/pull/5143
• Migration away from Numba and llvmlite: core utilities have been migrated to nanobind/C++, allowing Numba and llvmlite to be removed as required dependencies and enabling support for free-threaded Python. By @daidahao and @CloseChoice in https://github.com/shap/shap/pull/5081, https://github.com/shap/shap/pull/5082, https://github.com/shap/shap/pull/5088, https://github.com/shap/shap/pull/5089, https://github.com/shap/shap/pull/5090, https://github.com/shap/shap/pull/5091, https://github.com/shap/shap/pull/5092, https://github.com/shap/shap/pull/5117, https://github.com/shap/shap/pull/5129
• GPU TreeSHAP improvements: LightGBM categorical GPU TreeSHAP support has been added, alongside TreeExplainer changes and CPU/GPU equivalence testing for categorical features. By @RAMitchell and @CloseChoice in https://github.com/shap/shap/pull/5020 and https://github.com/shap/shap/pull/5026

What's Changed

Fixes

• Refactor short circuiting of tree_path_dependent shap calculation by @CloseChoice in https://github.com/shap/shap/pull/5069
• Remove outdated TensorFlow version warnings from DeepExplainer by @SushantTusharJoshi in https://github.com/shap/shap/pull/5126

Enhancements

• Support LightGBM categorical GPU TreeSHAP by @RAMitchell in https://github.com/shap/shap/pull/5020
• Use TreeEnsemble directly in TreeExplainer and add cpu gpu equivalence tests for categories by @CloseChoice in https://github.com/shap/shap/pull/5026
• Add GPU build, packaging, CI, smoke tests, and TestPyPI support by @CloseChoice in https://github.com/shap/shap/pull/5057, https://github.com/shap/shap/pull/5058, https://github.com/shap/shap/pull/5114, https://github.com/shap/shap/pull/5123, https://github.com/shap/shap/pull/5127
• ENH: Move optional-dep into dep-groups by @daidahao in https://github.com/shap/shap/pull/4589
• ENH: Performance monitoring for explainers by @daidahao in https://github.com/shap/shap/pull/5071
• PERF: Remove Numba from image masker by @daidahao in https://github.com/shap/shap/pull/5089
• PERF: Migrate clustering utilities to nanobind by @daidahao in https://github.com/shap/shap/pull/5088
• PERF: Migrate tabular masking utilities to nanobind by @daidahao in https://github.com/shap/shap/pull/5090
• PERF: Migrate ExactExplainer interaction utility to nanobind by @daidahao in https://github.com/shap/shap/pull/5091
• PERF: Migrate lower_credit to nanobind by @daidahao in https://github.com/shap/shap/pull/5081
• PERF: Migrate mask construction to nanobind by @daidahao in https://github.com/shap/shap/pull/5082
• PERF: Migrate masked-model output utilities to nanobind by @daidahao in https://github.com/shap/shap/pull/5092
• remove numba and llvmlite from dependencies, support free-threaded python by @CloseChoice in https://github.com/shap/shap/pull/5129
• run tests and build wheels for python 3.15 (including pre-release) by @CloseChoice in https://github.com/shap/shap/pull/5143
• Add Windows ARM64 build by @ndabas in https://github.com/shap/shap/pull/5137

Other Changes

• TST: Increase test coverage for shap/maskers/_image.py by @bedupako12mas in https://github.com/shap/shap/pull/4519
• DOC: Document ASV performance monitoring by @daidahao in https://github.com/shap/shap/pull/5083
• remove llvmlite and numba restrictions on macos by @CloseChoice in https://github.com/shap/shap/pull/5117
• TYP: add type hints for plots._benchmark by @siddharth7113 in https://github.com/shap/shap/pull/5101
• Build and upload nightly wheels to scientific-python-nightly-wheels by @CloseChoice in https://github.com/shap/shap/pull/5136
• update bundle js by @CloseChoice in https://github.com/shap/shap/pull/5139
• Skip nightly wheel build when master is unchanged by @CloseChoice in https://github.com/shap/shap/pull/5141
• Update actions/checkout to v7.0.1 and pin its commit SHA by @CloseChoice in https://github.com/shap/shap/pull/5144
• update dependabot by @CloseChoice in https://github.com/shap/shap/pull/5145

New Contributors

• @bedupako12mas made their first contribution in https://github.com/shap/shap/pull/4519
• @siddharth7113 made their first contribution in https://github.com/shap/shap/pull/5101
• @SushantTusharJoshi made their first contribution in https://github.com/shap/shap/pull/5126
• @ndabas made their first contribution in https://github.com/shap/shap/pull/5137

Full Changelog: https://github.com/shap/shap/compare/v0.52.0...v0.53.0rc0