归一化器#

class sklearn.preprocessing.Normalizer(norm='l2', *, copy=True)[源代码]#

将样本单独标准化至单位规范。

具有至少一个非零分量的每个样本(即数据矩阵的每一行)独立于其他样本重新缩放,以便其规范(l1、l2或inf)等于1。

这个Transformer能够同时处理密集的numpy数组和scipy.sparse矩阵(如果你想避免复制/转换的负担,请使用CSR格式)。

例如,将输入缩放到单位规范是文本分类或集群的常见操作。例如,两个l2规格化的TF-IDF载体的点积是载体的Cosol相似度,并且是信息检索界常用的载体空间模型的基本相似度度量。

有关可视化示例,请参阅 Compare Normalizer with other scalers .

阅读更多的 User Guide .

参数:
norm' l1 ',',' max ',默认=' l2 '

用于标准化每个非零样本的规范。如果使用norm =' max ',值将根据绝对值的最大值重新缩放。

copy布尔,默认=True

设置为False以执行就地行规范化并避免复制(如果输入已经是numpy数组或scipy.sparse CSR矩阵)。

属性:
n_features_in_int

期间看到的功能数量 fit .

Added in version 0.24.

feature_names_in_ :nd形状数组 (n_features_in_ ,)nd数组形状(

Names of features seen during fit. Defined only when X has feature names that are all strings.

Added in version 1.0.

参见

normalize

没有估计器API的等效功能。

注意到

这个估计器是 stateless 并且不需要安装。不过,我们建议致电 fit_transform 而不是 transform ,因为参数验证仅在 fit .

示例

>>> from sklearn.preprocessing import Normalizer
>>> X = [[4, 1, 2, 2],
...      [1, 3, 9, 3],
...      [5, 7, 5, 1]]
>>> transformer = Normalizer().fit(X)  # fit does nothing.
>>> transformer
Normalizer()
>>> transformer.transform(X)
array([[0.8, 0.2, 0.4, 0.4],
       [0.1, 0.3, 0.9, 0.3],
       [0.5, 0.7, 0.5, 0.1]])
fit(X, y=None)[源代码]#

仅验证估计器的参数。

该方法允许:(i)验证估计器的参数以及(ii)与scikit-learn Transformer API一致。

参数:
X形状(n_samples,n_features)的{类数组,稀疏矩阵}

用于估计正规化参数的数据。

y忽视

未使用,此处列出是为了按照惯例实现API一致性。

返回:
self对象

已安装Transformer。

fit_transform(X, y=None, **fit_params)[源代码]#

适应数据,然后对其进行转换。

适合变压器 Xy 具有可选参数 fit_params 并返回的转换版本 X .

参数:
X形状类似阵列(n_samples,n_features)

输入样本。

y形状为(n_samples,)或(n_samples,n_outputs)的阵列状, 默认值=无

目标值(无监督转换)。

**fit_paramsdict

其他适合参数。

返回:
X_newndray形状数组(n_samples,n_features_new)

变形的数组。

get_feature_names_out(input_features=None)[源代码]#

获取用于转换的输出要素名称。

参数:
input_features字符串或无的类数组,默认=无

输入功能。

  • 如果 input_featuresNone 那么 feature_names_in_ 在中用作功能名称。如果 feature_names_in_ 未定义,则生成以下输入要素名称: ["x0", "x1", ..., "x(n_features_in_ - 1)"] .

  • 如果 input_features 是一个类似阵列的,那么 input_features 必须匹配 feature_names_in_ 如果 feature_names_in_ 是定义的。

返回:
feature_names_out字符串对象的nd数组

与输入功能相同。

get_metadata_routing()[源代码]#

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

请检查 User Guide 关于路由机制如何工作。

返回:
routingMetadataRequest

A MetadataRequest 封装路由信息。

get_params(deep=True)[源代码]#

获取此估计器的参数。

参数:
deep布尔,默认=True

如果为True,将返回此估计量和包含的作为估计量的子对象的参数。

返回:
paramsdict

参数名称映射到其值。

set_output(*, transform=None)[源代码]#

设置输出容器。

看到 介绍 set_output API 了解如何使用API的示例。

参数:
transform{“默认”,“pandas”,“polars”},默认=无

配置输出 transformfit_transform .

  • "default" :Transformer的默认输出格式

  • "pandas" :DataFrame输出

  • "polars" :两极输出

  • None :转换配置不变

Added in version 1.4: "polars" 添加了选项。

返回:
self估计器实例

估计实例。

set_params(**params)[源代码]#

设置此估计器的参数。

该方法适用于简单估计器以及嵌套对象(例如 Pipeline ).后者具有以下形式的参数 <component>__<parameter> 以便可以更新嵌套对象的每个组件。

参数:
**paramsdict

估计参数。

返回:
self估计器实例

估计实例。

set_transform_request(*, copy: bool | None | str = '$UNCHANGED$') Normalizer[源代码]#

请求元数据传递给 transform

请注意,此方法仅适用于以下情况 enable_metadata_routing=True (见 sklearn.set_config ).请参阅 User Guide 关于路由机制如何工作。

The options for each parameter are:

  • True :元数据被请求并传递给 transform 如果提供的话。如果未提供元数据,则会忽略请求。

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

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

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

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

Added in version 1.3.

备注

只有当该估计器用作元估计器的子估计器时,该方法才相关,例如在 Pipeline .否则就没有效果了。

参数:
copy字符串、真、假或无, 默认=sklearn.utils. metalics_Routing.UNChanged

元数据路由 copy 参数 transform .

返回:
self对象

更新的对象。

transform(X, copy=None)[源代码]#

将X的每个非零行缩放到单位规范。

参数:
X形状(n_samples,n_features)的{类数组,稀疏矩阵}

要逐行标准化的数据。scipy.sparse矩阵应采用CSR格式,以避免不必要的复制。

copybool,默认值=无

复制或不复制输入X。

返回:
X_tr{ndarray,sparse matrix}的形状(n_samples,n_features)

变形的数组。