DummyClassifier#

class sklearn.dummy.DummyClassifier(*, strategy='prior', random_state=None, constant=None)[source]#

DummyClassifier 做出忽略输入特征的预测。

此分类器用作简单的基准，用于与更复杂的分类器进行比较。

基准的具体行为通过 strategy 参数选择。

所有策略都忽略传递给 fit 和 predict 的 X 参数中的输入特征值进行预测。然而，预测通常取决于传递给 fit 的 y 参数中观察到的值。

请注意，“stratified”（分层）和“uniform”（均匀）策略会导致非确定性预测，如果需要，可以通过设置 random_state 参数使其确定。其他策略本质上是确定性的，一旦拟合，对于任何 X 值，它们总是返回相同的常数预测。

在用户指南中阅读更多内容。

在版本 0.13 中添加。

参数:

strategy{“most_frequent”, “prior”, “stratified”, “uniform”, “constant”}, default=”prior”

用于生成预测的策略。

“most_frequent”：“predict”方法始终返回传递给 fit 的观察到的 y 参数中最常见的类别标签。“predict_proba”方法返回匹配的 one-hot 编码向量。
“prior”：“predict”方法始终返回传递给 fit 的观察到的 y 参数中最常见的类别标签（与“most_frequent”类似）。“predict_proba”始终返回 y 的经验类别分布，也称为经验类别先验分布。
“stratified”：“predict_proba”方法从以经验类别先验概率为参数的多项分布中随机采样 one-hot 向量。“predict”方法返回在 predict_proba 的 one-hot 向量中概率为一的类别标签。因此，这两种方法的每个采样行都是独立且同分布的。
“uniform”：从 y 中观察到的唯一类别列表中均匀随机生成预测，即每个类别具有相等的概率。
“constant”：始终预测用户提供的常数标签。这对于评估非多数类别的指标很有用。

版本 0.24 中的变化： strategy 的默认值在版本 0.24 中更改为“prior”。

random_stateint, RandomState instance or None, default=None

控制当 strategy='stratified' 或 strategy='uniform' 时生成预测的随机性。传递一个 int 以在多次函数调用中获得可重现的输出。请参阅词汇表。

constantint or str or array-like of shape (n_outputs,), default=None

“constant”策略所预测的显式常数。此参数仅对“constant”策略有用。

属性:

classes_ndarray of shape (n_classes,) or list of such arrays: 在 y 中观察到的唯一类别标签。对于多输出分类问题，此属性是一个数组列表，因为每个输出都有一组独立的可能类别。
n_classes_int or list of int: 每个输出的标签数量。
class_prior_ndarray of shape (n_classes,) or list of such arrays: 在 y 中观察到的每个类别的频率。对于多输出分类问题，这是为每个输出独立计算的。
n_features_in_int: 在拟合期间看到的特征数。
feature_names_in_shape 为 (n_features_in_,) 的 ndarray: 在 fit 期间看到的特征名称。仅当 X 具有全部为字符串的特征名称时才定义。
n_outputs_int: 输出数量。
sparse_output_bool: 如果从 predict 返回的数组要采用稀疏 CSC 格式，则为 True。如果输入 y 以稀疏格式传递，则自动设置为 True。

另请参阅

DummyRegressor: 使用简单规则进行预测的回归器。

示例

>>> import numpy as np
>>> from sklearn.dummy import DummyClassifier
>>> X = np.array([-1, 1, 1, 1])
>>> y = np.array([0, 1, 1, 1])
>>> dummy_clf = DummyClassifier(strategy="most_frequent")
>>> dummy_clf.fit(X, y)
DummyClassifier(strategy='most_frequent')
>>> dummy_clf.predict(X)
array([1, 1, 1, 1])
>>> dummy_clf.score(X, y)
0.75

fit(X, y, sample_weight=None)[source]#

拟合基准分类器。

参数:

Xshape 为 (n_samples, n_features) 的 array-like: 训练数据。
yshape 为 (n_samples,) 或 (n_samples, n_outputs) 的 array-like: 目标值。
sample_weightshape 为 (n_samples,) 的 array-like, default=None: 样本权重。

返回:

selfobject: 返回实例本身。

get_metadata_routing()[source]#

获取此对象的元数据路由。

请查阅用户指南，了解路由机制如何工作。

返回:

routingMetadataRequest: 封装路由信息的 MetadataRequest。

get_params(deep=True)[source]#

获取此估计器的参数。

参数:

deepbool, default=True: 如果为 True，将返回此估计器以及包含的子对象（如果它们是估计器）的参数。

返回:

paramsdict: 参数名称映射到其值。

predict(X)[source]#

对测试向量 X 执行分类。

参数:

Xshape 为 (n_samples, n_features) 的 array-like: 测试数据。

返回:

yshape 为 (n_samples,) 或 (n_samples, n_outputs) 的 array-like: X 的预测目标值。

predict_log_proba(X)[source]#

返回测试向量 X 的对数概率估计。

参数:

X{array-like, object with finite length or shape}: 训练数据。

返回:

Pndarray of shape (n_samples, n_classes) or list of such arrays: 返回模型中每个类别的样本对数概率，其中类别按每个输出的算术顺序排列。

predict_proba(X)[source]#

返回测试向量 X 的概率估计。

参数:

Xshape 为 (n_samples, n_features) 的 array-like: 测试数据。

返回:

Pndarray of shape (n_samples, n_classes) or list of such arrays: 返回模型中每个类别的样本概率，其中类别按算术顺序排列，适用于每个输出。

score(X, y, sample_weight=None)[source]#

Return the mean accuracy on the given test data and labels.

在多标签分类中，这是子集准确率 (subset accuracy)，这是一个严格的指标，因为它要求每个样本的每个标签集都被正确预测。

参数:

XNone or array-like of shape (n_samples, n_features): 测试样本。传递 None 作为测试样本会得到与传递真实测试样本相同的结果，因为 DummyClassifier 独立于采样的观察结果运行。
yshape 为 (n_samples,) 或 (n_samples, n_outputs) 的 array-like: X 的真实标签。
sample_weightshape 为 (n_samples,) 的 array-like, default=None: 样本权重。

返回: