留一组交叉验证#
- 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
split
中groups
参数的元数据路由。
- 返回:
- self对象
更新后的对象。