[Meta-issue] deprecation tracker for upcoming releases

[connortann]

This is a meta-issue to track any deprecation cycles within the shap package.

Maintainers, feel free to edit this tracker as necessary,

Not yet deprecated

Items ready to be deprecated, but which don't current raise a DeprecationWarning:

Unused / dead code:

• shap/utils/_masked_models.py:_build_delta_masked_inputs()
• shap/plots/_text.py:text_old()
• shap/explainers/_explainer.py:Explainer._compute_main_effects()

Deprecated but without a specific schedule

Deprecated arguments / API changes:

• KernelExplainer.shap_values: l1_reg="auto" :

  shap/shap/explainers/_kernel.py

  Line 177 in 87ee4ef

  l1_reg : "num_features(int)", "auto" (default for now, but deprecated), "aic", "bic", or float

• PerumutationExplainer.shap_values() :

  shap/shap/explainers/_permutation.py

  Line 211 in 87ee4ef

  warnings.warn("shap_values() is deprecated; use __call__().", DeprecationWarning)

• Beeswarm / Violin plot auto_size_plot:

  shap/shap/plots/_beeswarm.py

  Line 505 in 87ee4ef

  warnings.warn("auto_size_plot=False is deprecated and is now ignored! Use plot_size=None instead.")

Scheduled for removal

Items that raise a DeprecationWarning due to be removed in an specific release:

0.45.0

• #3511
• #3340

Parameters which were renamed:

feature_dependence -> feature_perturbation
independent -> interventional
correlation -> correlation_dependent
logloss -> log_loss
margin -> raw

0.46.0

0.47.0