RationalQuadratic#

class sklearn.gaussian_process.kernels.RationalQuadratic(length_scale=1.0, alpha=1.0, length_scale_bounds=(1e-05, 100000.0), alpha_bounds=(1e-05, 100000.0))#

有理二次核函数。

有理二次核函数可以被看作是具有不同特征长度尺度的RBF核函数的尺度混合(无限和)。它由一个长度尺度参数 \(l>0\) 和一个尺度混合参数 \(lpha>0\) 参数化。目前仅支持各向同性变体,其中长度尺度 \(l\) 是一个标量。核函数定义为:

\[k(x_i, x_j) = \left( 1 + \]

rac{d(x_i, x_j)^2 }{ 2lpha l^2} ight)^{-lpha}

其中 \(lpha\) 是尺度混合参数,\(l\) 是核函数的长度尺度,\(d(\cdot,\cdot)\) 是欧几里得距离。关于如何设置参数的建议,请参见例如 [Rc7764613bdcf-1]

更多信息请参阅 用户指南

Added in version 0.18.

Parameters:
length_scalefloat > 0, default=1.0

核函数的长度尺度。

alphafloat > 0, default=1.0

尺度混合参数

length_scale_bounds一对浮点数 >= 0 或 “fixed”, default=(1e-5, 1e5)

‘length_scale’ 的下界和上界。 如果设置为 “fixed”,则在超参数调整期间 ‘length_scale’ 不能更改。

alpha_bounds一对浮点数 >= 0 或 “fixed”, default=(1e-5, 1e5)

‘alpha’ 的下界和上界。 如果设置为 “fixed”,则在超参数调整期间 ‘alpha’ 不能更改。

Examples

>>> from sklearn.datasets import load_iris
>>> from sklearn.gaussian_process import GaussianProcessClassifier
>>> from sklearn.gaussian_process.kernels import RationalQuadratic
>>> X, y = load_iris(return_X_y=True)
>>> kernel = RationalQuadratic(length_scale=1.0, alpha=1.5)
>>> gpc = GaussianProcessClassifier(kernel=kernel,
...         random_state=0).fit(X, y)
>>> gpc.score(X, y)
0.9733...
>>> gpc.predict_proba(X[:2,:])
array([[0.8881..., 0.0566..., 0.05518...],
        [0.8678..., 0.0707... , 0.0614...]])
__call__(X, Y=None, eval_gradient=False)#

返回核函数 k(X, Y) 及其梯度(可选)。

Parameters:
Xndarray,形状为 (n_samples_X, n_features)

返回核函数 k(X, Y) 的左参数

Yndarray,形状为 (n_samples_Y, n_features),默认=None

返回核函数 k(X, Y) 的右参数。如果为 None,则计算 k(X, X)。

eval_gradientbool,默认=False

确定是否计算关于核函数超参数对数的梯度。 仅在 Y 为 None 时支持。

Returns:
Kndarray,形状为 (n_samples_X, n_samples_Y)

核函数 k(X, Y)

K_gradientndarray,形状为 (n_samples_X, n_samples_X, n_dims),可选

核函数 k(X, X) 关于其超参数对数的梯度。仅在 eval_gradient 为 True 时返回。

property bounds#

返回对theta进行对数变换后的边界。

Returns:
boundsndarray of shape (n_dims, 2)

核函数超参数theta的对数变换边界

clone_with_theta(theta)#

返回具有给定超参数 theta 的自身克隆。

Parameters:
thetandarray of shape (n_dims,)

超参数

diag(X)#

返回核 k(X, X) 的对角线。

此方法的结果与 np.diag(self(X)) 相同;然而, 它可以更高效地进行评估,因为只评估对角线。

Parameters:
Xndarray of shape (n_samples_X, n_features)

返回核 k(X, Y) 的左参数

Returns:
K_diagndarray of shape (n_samples_X,)

核 k(X, X) 的对角线

get_params(deep=True)#

获取此内核的参数。

Parameters:
deepbool, 默认=True

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

Returns:
paramsdict

参数名称映射到它们的值。

property hyperparameters#

返回所有超参数规范的列表。

is_stationary()#

返回内核是否是平稳的。

property n_dims#

返回内核的非固定超参数的数量。

property requires_vector_input#

返回内核是否定义在固定长度的特征向量或通用对象上。默认为True以保持向后兼容性。

set_params(**params)#

设置此内核的参数。

该方法适用于简单内核和嵌套内核。后者具有形式为 <component>__<parameter> 的参数,因此可以更新嵌套对象的每个组件。

Returns:
self
property theta#

返回非固定超参数的(扁平化、对数变换后的)值。

注意,theta通常是内核超参数的对数变换值,因为这种搜索空间的表示更适合超参数搜索,例如长度尺度等超参数自然存在于对数尺度上。

Returns:
thetandarray of shape (n_dims,)

内核的非固定、对数变换后的超参数