Ctrl+K

MiniBatchDictionaryLearning#

class sklearn.decomposition.MiniBatchDictionaryLearning(n_components=None, *, alpha=1, max_iter=1000, fit_algorithm='lars', n_jobs=None, batch_size=256, shuffle=True, dict_init=None, transform_algorithm='omp', transform_n_nonzero_coefs=None, transform_alpha=None, verbose=False, split_sign=False, random_state=None, positive_code=False, positive_dict=False, transform_max_iter=1000, callback=None, tol=0.001, max_no_improvement=10)[源代码]#

小批量词典学习。

找到一个在对匹配数据进行稀疏编码方面表现良好的字典（一组原子）。

解决优化问题：：

(U^*,V^*) = argmin 0.5 || X - U V ||_Fro^2 + alpha * || U ||_1,1
             (U,V)
             with || V_k ||_2 <= 1 for all  0 <= k < n_components

||.||_ Fro代表弗罗贝尼乌斯规范， ||.||_ 1，1代表逐项矩阵规范，它是矩阵中所有条目的绝对值的和。

阅读更多的 User Guide .

参数:
n_componentsint，默认=无

要提取的字典元素数。

alphafloat，默认=1

稀疏性控制参数。

max_iterint，默认=1_000

独立于任何早期停止标准启发式而停止之前在完整数据集上进行的最大迭代次数。

Added in version 1.1.

fit_algorithm' lars '，'，默认=' lars '

使用的算法：

  • 'lars' ：使用最小角度回归方法解决套索问题 (linear_model.lars_path )

  • 'cd' ：使用坐标下降法计算Lasso解 (linear_model.Lasso ).如果估计的分量是稀疏的，则Lars将更快。

n_jobsint，默认=无

要运行的并行作业数。 None 意思是1，除非在a中 joblib.parallel_backend 上下文 -1 意味着使用所有处理器。看到 Glossary 了解更多详细信息。

batch_sizeint，默认=256

每个小批次中的样本数量。

在 1.3 版本发生变更: 的默认值 batch_size 在版本1.3中从3更改为256。

shuffle布尔，默认=True

是否在形成批次之前对样品进行混洗。

dict_init形状的nd数组（n_components，n_features），默认=无

热重启场景字典的初始值。

transform_algorithm搜索'lasso_lars'，'lasso_cd'，'lars'，'omp'， 'threshold'}，default='omp'

用于转换数据的算法：

  • 'lars' ：使用最小角度回归法 (linear_model.lars_path );

  • 'lasso_lars' ：使用Lars计算Lasso解。

  • 'lasso_cd' ：使用坐标下降法计算Lasso解 (linear_model.Lasso ). 'lasso_lars' 如果估计的成分是稀疏的，则会更快。

  • 'omp' ：使用垂直匹配追求来估计稀疏解。

  • 'threshold' ：将投影中小于alpha的所有系数压缩为零 dictionary * X' .

transform_n_nonzero_coefsint，默认=无

解决方案每列中要目标的非零系数数。这仅用于 algorithm='lars' 和 algorithm='omp' .如果 None 那么 transform_n_nonzero_coefs=int(n_features / 10) .

transform_alphafloat，默认=无

如果 algorithm='lasso_lars' 或 algorithm='lasso_cd' , alpha 是适用于L1规范的惩罚。如果 algorithm='threshold' , alpha 是阈值的绝对值，低于该阈值的系数将被压缩为零。如果 None ，默认为 alpha .

在 1.2 版本发生变更: 当无时，默认值从1.0更改为 alpha .

verbosebool或int，默认=False

控制程序的冗长程度。

split_sign布尔，默认=假

是否将稀疏特征载体拆分为负部分和正部分的级联。这可以提高下游分类器的性能。

random_stateint，RandomState实例或无，默认=无

用于初始化字典时 dict_init 未指定，当 shuffle 设置为 True ，并更新字典。传递int以获得跨多个函数调用的可重复结果。看到 Glossary .

positive_code布尔，默认=假

在查找代码时是否强制执行积极性。

Added in version 0.20.

positive_dict布尔，默认=假

在寻找字典时是否要加强积极态度。

Added in version 0.20.

transform_max_iterint，默认=1000

如果出现以下情况，需要执行的最大迭代次数 algorithm='lasso_cd' 或 'lasso_lars' .

Added in version 0.22.

callback可调用，默认值=无

每次迭代结束时调用的可调用对象。

Added in version 1.1.

tol浮点数，默认值= 1 e-3

根据字典中2个步骤之间差异的规范控制提前停止。

To disable early stopping based on changes in the dictionary, set tol to 0.0.

Added in version 1.1.

max_no_improvementint，默认值=10

根据小型批次的连续数量控制提前停止，但不会改善平滑成本函数。

要禁用基于成本函数的收敛检测，请设置 max_no_improvement 到无。

Added in version 1.1.

属性:
components_ndrow形状数组（n_components，n_features）

从数据中提取的组件。

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.

n_iter_int

完整数据集的迭代次数。

n_steps_int

处理的小批次数量。

Added in version 1.1.

参见

DictionaryLearning

找一个对数据进行稀疏编码的字典。

MiniBatchSparsePCA

小批量稀疏主成分分析。

SparseCoder

Find a sparse representation of data from a fixed, precomputed dictionary.

SparsePCA

稀疏主成分分析

引用

J. Mairal, F. Bach, J. Ponce, G. Sapiro, 2009: Online dictionary learning for sparse coding (https://www.di.ens.fr/~fbach/mairal_icml09.pdf)

示例

>>> import numpy as np
>>> from sklearn.datasets import make_sparse_coded_signal
>>> from sklearn.decomposition import MiniBatchDictionaryLearning
>>> X, dictionary, code = make_sparse_coded_signal(
...     n_samples=30, n_components=15, n_features=20, n_nonzero_coefs=10,
...     random_state=42)
>>> dict_learner = MiniBatchDictionaryLearning(
...     n_components=15, batch_size=3, transform_algorithm='lasso_lars',
...     transform_alpha=0.1, max_iter=20, random_state=42)
>>> X_transformed = dict_learner.fit_transform(X)

我们可以检查的稀疏程度 X_transformed :

>>> np.mean(X_transformed == 0) > 0.5
np.True_

我们可以比较稀疏编码信号的重建误差的平均平方欧几里得规范与原始信号的欧几里得规范平方：

>>> X_hat = X_transformed @ dict_learner.components_
>>> np.mean(np.sum((X_hat - X) ** 2, axis=1) / np.sum(X ** 2, axis=1))
np.float64(0.052...)
fit(X, y=None)[源代码]#

根据X中的数据匹配模型。

参数:
X形状类似阵列（n_samples，n_features）

训练载体，在哪里 n_samples 是样本数量和 n_features 是功能的数量。

y忽视

未使用，按照惯例，为了API一致性而存在。

返回:
self对象

返回实例本身。

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

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

适合变压器 X 和 y 具有可选参数 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)[源代码]#

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

输出的功能名称将以大写的类别名称为开头。例如，如果Transformer输出3个特征，则输出的特征名称为： ["class_name0", "class_name1", "class_name2"] .

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

仅用于通过中看到的名称验证要素名称 fit .

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

转换的功能名称。

get_metadata_routing()[源代码]#

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

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

返回:
routingMetadataRequest

A MetadataRequest 封装路由信息。

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

获取此估计器的参数。

参数:
deep布尔，默认=True

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

返回:
paramsdict

参数名称映射到其值。

partial_fit(X, y=None)[源代码]#

使用X中的数据作为迷你批处理更新模型。

参数:
X形状类似阵列（n_samples，n_features）

训练载体，在哪里 n_samples 是样本数量和 n_features 是功能的数量。

y忽视

未使用，按照惯例，为了API一致性而存在。

返回:
self对象

返回实例本身。

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

设置输出容器。

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

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

配置输出 transform 和 fit_transform .

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

  • "pandas" ：DataFrame输出

  • "polars" ：两极输出

  • None ：转换配置不变

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

返回:
self估计器实例

估计实例。

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

设置此估计器的参数。

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

参数:
**paramsdict

估计参数。

返回:
self估计器实例

估计实例。

transform(X)[源代码]#

将数据编码为字典原子的稀疏组合。

编码方法由对象参数决定 transform_algorithm .

参数:
X形状的nd数组（n_samples，n_features）

要转换的测试数据必须具有与用于训练模型的数据相同数量的特征。

返回:
X_new形状的nd数组（n_samples，n_components）

转换的数据。

On this page