留一组交叉验证#

class sklearn.model_selection.LeaveOneGroupOut[source]#

留一组交叉验证器。

提供训练/测试索引来划分数据,以便每个训练集包含除属于一个特定组的样本外的所有样本。任意特定领域的组信息作为整数数组提供,该数组编码每个样本的组。

例如,组可以是样本的收集年份,因此允许针对基于时间的拆分进行交叉验证。

更多信息请参见用户指南

另见

分组K折交叉验证

具有非重叠分组的K折迭代器变体。

注释

分割按照留出的分组索引排序。第一次分割的测试集由在groups中索引最低的分组组成,以此类推。

示例

>>> import numpy as np
>>> from sklearn.model_selection import LeaveOneGroupOut
>>> X = np.array([[1, 2], [3, 4], [5, 6], [7, 8]])
>>> y = np.array([1, 2, 1, 2])
>>> groups = np.array([1, 1, 2, 2])
>>> logo = LeaveOneGroupOut()
>>> logo.get_n_splits(X, y, groups)
2
>>> logo.get_n_splits(groups=groups)  # 'groups' is always required
2
>>> print(logo)
LeaveOneGroupOut()
>>> for i, (train_index, test_index) in enumerate(logo.split(X, y, groups)):
...     print(f"Fold {i}:")
...     print(f"  Train: index={train_index}, group={groups[train_index]}")
...     print(f"  Test:  index={test_index}, group={groups[test_index]}")
Fold 0:
  Train: index=[2 3], group=[2 2]
  Test:  index=[0 1], group=[1 1]
Fold 1:
  Train: index=[0 1], group=[1 1]
  Test:  index=[2 3], group=[2 2]
get_metadata_routing()[source]#

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

请查看用户指南,了解路由机制的工作原理。

返回:
routingMetadataRequest

一个MetadataRequest,封装了路由信息。

get_n_splits(X=None, y=None, groups=None)[source]#

返回交叉验证器中的分割迭代次数。

参数:
X对象

始终被忽略,为了兼容性而存在。

y对象

始终被忽略,为了兼容性而存在。

groups形状为 (n_samples,) 的类数组

将数据集分割成训练集/测试集时使用的样本的分组标签。虽然其他参数可以省略,但此“groups”参数必须始终指定才能计算分割次数。

返回:
n_splits整数

返回交叉验证器中的分割迭代次数。

set_split_request(*, groups: bool | None | str = '$UNCHANGED$') LeaveOneGroupOut[source]#

请求传递给split方法的元数据。

请注意,只有当enable_metadata_routing=True时(参见sklearn.set_config),此方法才相关。请参阅用户指南,了解路由机制的工作原理。

每个参数的选项为

  • True:请求元数据,如果提供则传递给split。如果未提供元数据,则忽略请求。

  • False:不请求元数据,元估计器不会将其传递给split

  • None:不请求元数据,如果用户提供元数据,元估计器将引发错误。

  • str:元数据应使用此给定的别名而不是原始名称传递给元估计器。

默认值(sklearn.utils.metadata_routing.UNCHANGED)保留现有的请求。这允许您更改某些参数的请求,而不对其他参数进行更改。

版本 1.3 中新增。

注意

仅当此估计器用作元估计器的子估计器时(例如,在Pipeline中使用)此方法才相关。否则,它无效。

参数:
groupsstr、True、False 或 None,默认为 sklearn.utils.metadata_routing.UNCHANGED

splitgroups参数的元数据路由。

返回:
self对象

更新后的对象。

split(X, y=None, groups=None)[source]#

生成将数据分割成训练集和测试集的索引。

参数:
X形状为 (n_samples, n_features) 的类数组

训练数据,其中n_samples是样本数,n_features是特征数。

y形状为 (n_samples,) 的类数组,默认为 None

监督学习问题的目标变量。

groups形状为 (n_samples,) 的类数组

将数据集分割成训练集/测试集时使用的样本的分组标签。

产量:
trainndarray

该分割的训练集索引。

testndarray

该分割的测试集索引。