sklearn.linear_model.Perceptron?

class sklearn.linear_model.Perceptron(*, penalty=None, alpha=0.0001, fit_intercept=True, max_iter=1000, tol=0.001, shuffle=True, verbose=0, eta0=1.0, n_jobs=None, random_state=0, early_stopping=False, validation_fraction=0.1, n_iter_no_change=5, class_weight=None, warm_start=False)

[源碼]

在用戶指南中閱讀更多內容。

參數 說明
penalty {‘l2’,’l1’,’elasticnet’}, default=None
要使用的懲罰（又稱正則化）。
alpha float, default=0.0001
如果使用正則化，則乘以正則化項的常數。
fit_intercept bool, default=True
是否估計截距。如果為False，則假定數據已經中心化。
max_iter int, default=1000
訓練數據的最大迭代次數（又稱歷元）。它只會影響fit方法中的行為，而不會影響 partial_fit方法。
tol float, default=1e-3
停止標準。如果不是None，則迭代將在（loss> previous_loss-tol）時停止。

0.19版本中的新功能。
shuffle bool, default=True
在每次迭代之后是否重新整理訓練數據。
verbose int, default=0
輸出日志的詳細程度
eta0 double, default=1
更新乘以的常數。
n_jobs int, default=None
用于執行OVA（對于多類問題而言為“一個對所有”）的CPU內核數。除非設置了joblib.parallel_backend 參數，否則None表示1 。 -1表示使用所有處理器。有關更多詳細信息，請參見詞匯表。
random_state int, RandomState instance, default=None
用于打亂訓練數據，當shuffle設置為 True。可以用一個整數為多個函數調用傳遞重復的輸出。請參閱詞匯表。
early_stopping bool, default=False
是否使用驗證提前停止終止訓練。如果設置為True，它將自動將訓練數據的分層部分留作驗證，并在連續n_iter_no_change次的驗證分數沒有提高至少tol時終止訓練。

0.20版中的新功能。
validation_fraction float, default=0.1
預留的作為早期停止的驗證集的訓練數據比例。必須在0到1之間。僅當early_stopping為True時使用。

0.20版中的新功能。
n_iter_no_change int, default=5
在提前停止之前沒有提升的迭代次數。

0.20版中的新功能。
class_weight dict, {class_label: weight} or “balanced”, default=None
class_weight fit參數的預設值。

類別關聯的權重。如果沒有給出，所有類別的權重都應該是1。

“balanced”模式使用y的值來自動調整為與輸入數據中的類頻率成反比的權重。如n_samples / (n_classes * np.bincount(y))
warm_start bool, default=False
設置為True時，重用前面調用的解決方案來進行初始化，否則，只清除前面的解決方案。請參閱詞匯表。
屬性 說明
coef_ ndarray of shape = [1, n_features] if n_classes == 2 else [n_classes, n_features]
分配給特征的權重。
intercept_ ndarray of shape = [1] if n_classes == 2 else [n_classes]
決策函數中的常量。
n_iter_ int
達到停止標準的實際迭代次數。對于多類擬合，它是每個二進制擬合的最大值。
classes_ ndarray of shape (n_classes,)
非重復的類標簽。
t_ int
訓練期間進行權重更新的次數。與(n_iter_ * n_samples)相同。

另見

SGDClassifier

注

Perceptron是一種分類算法，與SGDClassifier有相同的底層實現。事實上 Perceptron()等同于SGDClassifier(loss="perceptron", eta0=1, learning_rate="constant", penalty=None)。

參考

https://en.wikipedia.org/wiki/Perceptron及其參考。

示例

>>> from sklearn.datasets import load_digits
>>> from sklearn.linear_model import Perceptron
>>> X, y = load_digits(return_X_y=True)
>>> clf = Perceptron(tol=1e-3, random_state=0)
>>> clf.fit(X, y)
Perceptron()
>>> clf.score(X, y)
0.939...

方法

方法 說明
decision_function(self, X) 預測樣本的置信度得分。
densify(self) 將系數矩陣轉換為密集數組格式。
fit(self, X, y[, coef_init, intercept_init, …]) 用隨機梯度下降擬合線性模型。
get_params(self[, deep]) 獲取此估計器的參數。
partial_fit(self, X, y[, classes, sample_weight]) 對給定的樣本進行一次隨機梯度下降。
predict(self, X) 預測X中樣本的類別標簽。
score(self, X, y[, sample_weight]) 返回給定測試數據和標簽上的平均準確度。
set_params(self, **kwargs) 設置并驗證估計器的參數。
sparsify(self) 將系數矩陣轉換為稀疏格式。 
__init__(self, *, penalty=None, alpha=0.0001, fit_intercept=True, max_iter=1000, tol=0.001, shuffle=True, verbose=0, eta0=1.0, n_jobs=None, random_state=0, early_stopping=False, validation_fraction=0.1, n_iter_no_change=5, class_weight=None, warm_start=False)

[源碼]

初始化self， 請參閱help(type(self))以獲得準確的說明。

decision_function(self, X)

[源碼]

預測樣本的置信度得分。

樣本的置信度分數是該樣本到超平面的符號距離。

參數 說明
X array_like or sparse matrix, shape (n_samples, n_features)
樣本數據。
返回值 說明
array, shape=(n_samples,) if n_classes == 2 else (n_samples, n_classes)
每個（樣本，類別）組合的置信度得分。在二分類情況下，self.classes_ [1]的置信度得分> 0表示將預測該類。		 
densify(self)

[源碼]

將系數矩陣轉換為密集數組格式。

將coef_數值（返回）轉換為numpy.ndarray。這是coef_的默認格式，并且是擬合模型所需的格式，因此僅在之前被稀疏化的模型上才需要調用此方法。否則，它是無操作的。

返回值 說明
self 擬合估計器。 
fit(self, X, y, coef_init=None, intercept_init=None, sample_weight=None)

[源碼]

用隨機梯度下降擬合線性模型。

參數 說明
X {array-like, sparse matrix} of shape (n_samples, n_features)
訓練數據
y array-like of shape (n_samples,)
目標標簽。
coef_init ndarray of shape (n_classes, n_features), default=None
用于熱啟動優化的初始系數。
intercept_init ndarray of shape (n_classes,), default=None
初始截距以熱啟動優化。
sample_weight array-like, shape (n_samples,), default=None
權重應用于各個樣本。如果未提供，則假定權重相同。如果指定了class_weight，則這些權重將與class_weight（通過構造函數傳遞）相乘。
返回值 說明
self 返回self的實例。 
get_params（self，deep = True ）

[源碼]

獲取此估計器的參數。

參數 說明
deep bool, default=True
如果為True，返回此估計器和所包含子對象的參數。
返回值 說明
params mapping of string to any
參數名稱映射到其值。		 
partial_fit(self, X, y, classes=None, sample_weight=None)

[源碼]

對給定的樣本進行一次隨機梯度下降。

在內部，此方法使用max_iter = 1。因此，不能保證調用一次后達到損失函數的最小值。目標收斂、提前停止等問題由用戶自行處理。

參數 說明
X {array-like, sparse matrix}, shape (n_samples, n_features)
訓練數據的子集
y ndarray of shape (n_samples,)
目標值的子集
classes ndarray of shape (n_classes,), default=None
partial_fit調用中所有的類。可以通過np.unique(y_all)獲得，其中y_all是整個數據集的目標向量。第一次調用partial_fit時需要此參數，在后續調用中可以將其省略。請注意，y不需要包含classes中的所有標簽。
sample_weight array-like, shape (n_samples,), default=None
權重應用于各個樣本。如果未提供，則假定權重相同。
返回值 說明
self 返回self的實例。 
predict(self, X)

[源碼]

預測X中樣本的類別標簽。

參數 說明
X array_like or sparse matrix, shape (n_samples, n_features)
樣本數據
返回值 說明
C array, shape [n_samples]
每個樣本的預測類別標簽。		 
score（self，X，y，sample_weight = None ）

[源碼]

返回給定測試數據和標簽上的平均準確度。

在多標簽分類中，這是子集準確性，這是一個嚴格的指標，因為你需要為每個樣本正確預測對應的標簽集。

參數 說明
X array-like of shape (n_samples, n_features)
測試樣本。
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
預測標簽與真實標簽的平均準確度		 
set_params(self, **kwargs)

[源碼]

設置并驗證估計器的參數。

參數 說明
**kwargs dict
估計器參數。
返回值 說明
self object
估計器實例。		 
sparsify(self)

[源碼]

將系數矩陣轉換為稀疏格式。

將coef_數值轉換為scipy.sparse矩陣，對于L1正規化的模型，該矩陣比通常的numpy.ndarray具有更高的內存和存儲效率。

該intercept_數值未轉換。

返回值 說明
self 擬合估計器。

注

對于非稀疏模型，即當coef_中零的個數不多時，這實際上可能會增加內存使用量，因此請謹慎使用此方法。經驗法則是，可以使用(coef_ == 0).sum()計算得到的零元素的數量必須大于50％，這時的效果是顯著的。

在調用densify之前，調用此方法將無法進一步使用partial_fit方法（如果有）。