X_pred from
matrix to xgb.DMatrix in
shapviz.xgb.Booster().treeshap() example to a ranger() model.collapse argument in
shapviz(). This is named list specifying which columns in
the SHAP matrix are to be collapsed by rowwise summation. A typical
application will be to combine the SHAP values of one-hot-encoded
dummies and explain them by the corrsponding factor variable.sv_importance(), see next section.sv_importance()The calculations behind sv_importance() are unchanged,
but defaults and some plot aspects have been reworked.
sv_importance() now shows a
bar plot by default. Use kind = "beeswarm" to get a
beeswarm plot.sv_importance() does not show SHAP
feature importances as text anymore. Use
show_numbers = TRUE to get them back. Furthermore, the
numbers are now printed on top of the bars instead on their bottom.show_numbers can be used to to add
SHAP feature importance values for all plot types.max_display has been increased from 10
to 15.bar_width.color_bar_title. Set to
NULL to remove the color bar altogether.format_fun now uses a right-aligned number
formatter with aligned decimal separator by default.dim() method for “shapviz” object, implying
nrow() and ncol().format_fun
argument of sv_waterfall() and sv_force() has
been replaced by format_shap to format SHAP values and
format_feat to format numeric feature values. By default,
they use the new global options “shapviz.format_shap” and
“shapviz.format_feat”, both with default
function(z) prettyNum(z, digits = 3, scientific = FALSE).sv_waterfall() now uses the more consistent argument
order_fun = function(s) order(abs(s)) instead of the
original sort_fun = function(shap) abs(shap) that was then
passed to order().viridis_args = getOption("shapviz.viridis_args") to
sv_dependence() and sv_importance() to control
the viridis color scale options. The default global option equals
list(begin = 0.25, end = 0.85, option = "inferno"). For
example, to switch to a standard viridis scale, you can either change
the default with options(shapviz.viridis_args = NULL) or
set viridis_args = NULL.shapviz_from_lgb_predict()
and shapviz_from_xgb_predict in favour of the collapsing
logic (see above). The functions will be removed in version 0.3.0.predict() arguments of LightGBM
(data -> newdata, predcontrib = TRUE -> type = “contrib”).This is the initial CRAN release.