shap.utils.sample

shap.utils.sample(X: _ArrayT, nsamples: int = 100, random_state: int = 0) → _ArrayT

对输入数据 X 执行不放回抽样。

这是对 scikit-learn 的 shuffle 函数的简单封装。它主要用于对 X 进行降采样，以便在 SHAP Explainer 及其子类中用作背景数据集。

0.42 版本更改: sample 的行为已从有放回抽样更改为不放回抽样。请注意，即使指定了 random_state，在此函数 0.42 版本前后使用时，再现性也可能会被破坏。

参数:

X类数组

从中抽样的数据。输入数据可以是数组、列表、数据帧或具有一致第一维度的 scipy 稀疏矩阵。

nsamplesint

从 X 生成的样本数。

random_state

确定用于数据洗牌的随机数生成。使用此参数以确保跨多个函数调用的可重复性。