sklearn.neighbors.RadiusNeighborsRegressor?
class sklearn.neighbors.RadiusNeighborsRegressor(radius=1.0, *, weights='uniform', algorithm='auto', leaf_size=30, p=2, metric='minkowski', metric_params=None, n_jobs=None, **kwargs)
[源碼]
基于固定半徑內的臨近點的回歸。
通過對訓練集中最近臨近點的相關目標進行局部插值來預測目標。
在用戶指南中閱讀更多內容。
0.9版的新功能。
參數 | 說明 |
---|---|
radius | float, default=1.0 默認情況下用于radius_neighbors查詢的參數空間范圍。 |
weights | {‘uniform’, ‘distance’} or callable, default=’uniform’ 預測中使用的權重函數。 可能的值: “uniform”:統一權重。 每個鄰域中的所有點均被加權。 “distance”:權重點與其距離的倒數。 在這種情況下,查詢點的近鄰比遠處的近鄰具有更大的影響力。 [callable]:用戶定義的函數,該函數接受距離數組,并返回包含權重的相同形狀的數組。 默認情況下使用統一權重。 |
algorithm | {‘auto’, ‘ball_tree’, ‘kd_tree’, ‘brute’}, default=’auto’ 用于計算最近臨近點的算法: ball_tree’將使用BallTree kd_tree”將使用KDTree “brute”將使用暴力搜索。 “auto”將嘗試根據傳遞給fit方法的值來決定最合適的算法。 注意:在稀疏輸入上進行擬合將使用蠻力覆蓋此參數的設置。 |
leaf_size | int, default=30 葉大小傳遞給BallTree或KDTree。 這會影響構造和查詢的速度,以及存儲樹所需的內存。 最佳值取決于問題的性質。 |
p | int, default=2 Minkowski指標的功率參數。 當p = 1時,這等效于對p = 2使用manhattan_distance(l1)和euclidean_distance(l2)。對于任意p,使用minkowski_distance(l_p)。 |
metric | str or callable, default=’minkowski’ 樹使用的距離度量。 默認度量標準為minkowski,p = 2等于標準歐幾里德度量標準。 有關可用度量的列表,請參見DistanceMetric的文檔。 如果度量是“預先計算的”,則X被假定為距離矩陣sparse graph,并且在擬合過程中必須為平方。 X可能是一個稀疏圖,在這種情況下,只有“非零”元素可以被視為臨近點。 |
metric_params | dict, default=None 度量功能的其他關鍵字參數。 |
n_jobs | int, default=None 為臨近點搜索運行的并行作業數。 除非在joblib.parallel_backend`上下文中,否則None表示1。 -1表示使用所有處理器。 有關更多詳細信息,請參見詞匯表Glossary。 |
屬性 | 說明 |
---|---|
effective_metric_ | str or callable 使用的距離度量。 它將與度量參數相同或與其相同,例如 如果metric參數設置為“ minkowski”,而p參數設置為2,則為“ euclidean”。 |
effective_metric_params_ | dict 度量功能的其他關鍵字參數。 對于大多數指標而言,它與metric_params參數相同,但是,如果將valid_metric_屬性設置為“ minkowski”,則也可能包含p參數值。 |
另見:
聲明
有關算法選擇和leaf_size的討論,請參見在線文檔中的Nearest Neighbors
https://en.wikipedia.org/wiki/K-nearest_neighbor_algorithm
示例
>>> X = [[0], [1], [2], [3]]
>>> y = [0, 0, 1, 1]
>>> from sklearn.neighbors import RadiusNeighborsRegressor
>>> neigh = RadiusNeighborsRegressor(radius=1.0)
>>> neigh.fit(X, y)
RadiusNeighborsRegressor(...)
>>> print(neigh.predict([[1.5]]))
[0.5]
方法
方法 | 說明 |
---|---|
fit (X, y) |
使用X作為訓練數據和y作為目標值擬合模型 |
get_params ([deep]) |
獲取此估計量的參數。 |
predict (X) |
預測提供數據的目標 |
radius_neighbors ([X, radius, …]) |
查找一個或多個給定半徑內的臨近點。 |
radius_neighbors_graph ([X, radius, mode, …]) |
計算X中點的臨近點(加權)圖 |
score (X, y[, sample_weight]) |
返回預測的確定系數R ^ 2。 |
set_params (**params) |
設置此估算器的參數。 |
__init__(radius=1.0, *, weights='uniform', algorithm='auto', leaf_size=30, p=2, metric='minkowski', metric_params=None, n_jobs=None, **kwargs)
[源碼]
初始化, 請參閱help(type())以獲得準確的說明
fit(X, y)
[源碼]
使用X作為訓練數據和y作為目標值擬合模型
參數 | 說明 |
---|---|
X | {array-like, sparse matrix, BallTree, KDTree} 訓練數據。 如果是數組或矩陣,則將其形狀設置為[n_samples,n_features],如果是metric =“ precomputed”,則為[n_samples,n_samples]。 |
y | {array-like, sparse matrix} 目標值,浮點值數組,形狀= [n_samples]或[n_samples,num_outputs] |
get_params(deep=True)
[源碼]
獲取此估計量的參數。
參數 | 說明 |
---|---|
deep | bool, default=True 如果為True,則將返回此估算器和作為估算器的所包含子對象的參數。 |
返回值 | 說明 |
---|---|
params | mapping of string to any 參數名稱映射到其值。 |
predict(X)
[源碼]
預測提供數據的目標
參數 | 說明 |
---|---|
X | array-like of shape (n_queries, n_features), or (n_queries, n_indexed) if metric == ‘precomputed’ 測試樣本 |
返回值 | 說明 |
---|---|
y | ndarray of shape (n_queries,) or (n_queries, n_outputs), dtype=double 目標值。 |
radius_neighbors(X=None, radius=None, return_distance=True, sort_results=False)
[源碼]
在一個或多個點的給定半徑內查找臨近點
返回數據集中每個點的索引和距離,該數據集位于一個球中,球的大小半徑圍繞查詢數組的點。 邊界上的點包括在結果中
結果點不一定按與查詢點的距離排序。
參數 | 說明 |
---|---|
X | array-like, (n_samples, n_features), optional 查詢點。 如果未提供,則返回每個索引點的臨近點。 在這種情況下,查詢點不被視為其自己的臨近點。 |
radius | float 限制臨近點返回的距離。 (默認值為傳遞給構造函數的值)。 |
return_distance | boolean, optional. Defaults to True. 如果為False,則不會返回距離。 |
sort_results | boolean, optional. Defaults to False. 如果為True,則距離和索引將在返回之前進行排序。 如果為False,則不會對結果進行排序。 如果return_distance == False,則將sort_results = True設置將導致錯誤。 0.22版中的新功能。 |
返回值 | 說明 |
---|---|
neigh_dist | array, shape (n_samples,) of arrays 表示到每個點的距離的數組,僅當return_distance = True時才存在。 距離值是根據度量構造函數參數計算的。 |
neigh_ind | array, shape (n_samples,) of arrays 人口矩陣中距離查詢點最近的近似點的索引數組。 |
聲明
因為每個點的臨近點數不一定相等,所以多個查詢點的結果不能適合標準數據數組。 為了提高效率,radius_neighbors返回對象數組,其中每個對象都是一維索引或距離數組。
示例
在以下示例中,我們從代表我們的數據集的數組構造NeighborsClassifier類,并詢問誰是最接近[1,1,1]的點:
>>> import numpy as np
>>> samples = [[0., 0., 0.], [0., .5, 0.], [1., 1., .5]]
>>> from sklearn.neighbors import NearestNeighbors
>>> neigh = NearestNeighbors(radius=1.6)
>>> neigh.fit(samples)
NearestNeighbors(radius=1.6)
>>> rng = neigh.radius_neighbors([[1., 1., 1.]])
>>> print(np.asarray(rng[0][0]))
[1.5 0.5]
>>> print(np.asarray(rng[1][0]))
[1 2]
返回的第一個數組包含到所有小于1.6的點的距離,而返回的第二個數組包含其索引。 通常,可以同時查詢多個點。
radius_neighbors_graph(X=None, radius=None, mode='connectivity', sort_results=False)
[源碼]
計算X中點的臨近點(加權)圖
鄰域限制點的距離小于半徑。
參數 | 說明 |
---|---|
X | array-like of shape (n_samples, n_features), default=None 查詢點。 如果未提供,則返回每個索引點的臨近點。 在這種情況下,查詢點不被視為其自己的臨近點。 |
radius | float 社區半徑。 (默認值為傳遞給構造函數的值)。 |
mode | {‘connectivity’, ‘distance’}, optional 返回矩陣的類型:“連通性”將返回具有1和0的連通性矩陣,在“距離”中,邊為點之間的歐幾里得距離。 |
sort_results | boolean, optional. Defaults to False. 如果為True,則距離和索引將在返回之前進行排序。 如果為False,則不會對結果進行排序。 僅與mode =” distance”一起使用。 0.22版中的新功能。 |
返回值 | 說明 |
---|---|
A | sparse graph in CSR format, shape = [n_queries, n_samples_fit] n_samples_fit是擬合數據中的樣本數A [i,j],分配了將i連接到j的邊的權重。 |
另見:
示例
>>> X = [[0], [3], [1]]
>>> from sklearn.neighbors import NearestNeighbors
>>> neigh = NearestNeighbors(radius=1.5)
>>> neigh.fit(X)
NearestNeighbors(radius=1.5)
>>> A = neigh.radius_neighbors_graph(X)
>>> A.toarray()
array([[1., 0., 1.],
[0., 1., 0.],
[1., 0., 1.]])
score(X, y, sample_weight=None)
[源碼]
返回預測的確定系數R ^ 2。
系數R ^ 2定義為(1- u / v),其中u是殘差平方和((y_true-y_pred)** 2).sum(),而v是平方和的總和((y_true- y_true.mean())** 2).sum()。 可能的最高得分為1.0,并且可能為負(因為該模型可能會更差)。 不管輸入特征如何,始終預測y的期望值的常數模型將獲得0.0的R ^ 2分數。
參數 | 說明 |
---|---|
X | array-like of shape (n_samples, n_features) 測試樣本。 對于某些估計量,這可以是預先計算的內核矩陣或通用對象列表,而不是shape =(n_samples,n_samples_fitted),其中n_samples_fitted是用于估計量擬合的樣本數。 |
y | array-like of shape (n_samples,) or (n_samples, n_outputs) X的真實值。 |
sample_weight | array-like of shape (n_samples,), default=None 樣本權重。 |
返回值 | 說明 |
---|---|
score | float self.predict(X)wrt.y的R ^ 2。 |
聲明
在回歸器上調用分數時使用的R2分數使用版本0.23中的multioutput ='uniform_average'來保持與r2_score的默認值一致。 這會影響所有多輸出回歸器的評分方法(MultiOutputRegressor除外)。
set_params(**params)
[源碼]
設置此估算器的參數。
該方法適用于簡單的估計器以及嵌套對象(例如管道)。 后者的參數格式為
參數 | 說明 |
---|---|
**params | dict 估算器參數 |
返回值 | 說明 |
---|---|
self | object 估算器實例。 |