可以建立簡單基線的分類器。
警告:不建議將估算器用於新代碼。估算器運行tf.compat.v1.Session-style 代碼更難正確編寫,並且可能出現意外行為,尤其是與 TF 2 代碼結合使用時。估算器確實屬於我們的兼容性保證,但不會收到除安全漏洞以外的任何修複。見遷移指南詳情。
用法
tf.estimator.BaselineClassifier(
model_dir=None, n_classes=2, weight_column=None, label_vocabulary=None,
optimizer='Ftrl', config=None,
loss_reduction=tf.losses.Reduction.SUM_OVER_BATCH_SIZE
)
參數
-
model_dir
保存模型參數、圖形等的目錄。這也可用於將檢查點從目錄加載到估計器中,以繼續訓練先前保存的模型。 -
n_classes
標簽類別的數量。默認為二分類。它必須大於 1。 注意:類標簽是表示類索引的整數(即從 0 到 n_classes-1 的值)。對於任意標簽值(例如字符串標簽),首先轉換為類索引。 -
weight_column
由tf.feature_column.numeric_column
創建的字符串或NumericColumn
定義表示權重的特征列。它將乘以示例的損失。 -
label_vocabulary
可選的字符串列表,大小為[n_classes]
,定義標簽詞匯。僅支持n_classes
> 2。 -
optimizer
字符串、tf.keras.optimizers.*
對象或可調用,用於創建用於訓練的優化器。如果未指定,將使用Ftrl
作為默認優化器。 -
config
RunConfig
對象來配置運行時設置。 -
loss_reduction
tf.losses.Reduction
之一,除了NONE
。說明如何減少批量訓練損失。默認為SUM_OVER_BATCH_SIZE
。
拋出
-
ValueError
如果n_classes
屬性
-
config
-
export_savedmodel
-
model_dir
-
model_fn
返回綁定到self.params
的model_fn
。 -
params
該分類器忽略特征值,將學習預測每個標簽的平均值。對於single-label 問題,這將預測標簽中看到的類的概率分布。對於多標簽問題,這將預測每個類別中正麵示例的比例。
例子:
# Build BaselineClassifier
classifier = tf.estimator.BaselineClassifier(n_classes=3)
# Input builders
def input_fn_train:
# Returns tf.data.Dataset of (x, y) tuple where y represents label's class
# index.
pass
def input_fn_eval:
# Returns tf.data.Dataset of (x, y) tuple where y represents label's class
# index.
pass
# Fit model.
classifier.train(input_fn=input_fn_train)
# Evaluate cross entropy between the test and train labels.
loss = classifier.evaluate(input_fn=input_fn_eval)["loss"]
# predict outputs the probability distribution of the classes as seen in
# training.
predictions = classifier.predict(new_samples)
train
和 evaluate
的輸入應具有以下特征,否則會出現 KeyError
:
- 如果
weight_column
不是None
,則具有key=weight_column
的特征,其值為Tensor
。
相關用法
- Python tf.estimator.BaselineEstimator用法及代碼示例
- Python tf.estimator.BaselineRegressor用法及代碼示例
- Python tf.estimator.BinaryClassHead用法及代碼示例
- Python tf.estimator.TrainSpec用法及代碼示例
- Python tf.estimator.LogisticRegressionHead用法及代碼示例
- Python tf.estimator.MultiHead用法及代碼示例
- Python tf.estimator.PoissonRegressionHead用法及代碼示例
- Python tf.estimator.WarmStartSettings用法及代碼示例
- Python tf.estimator.experimental.stop_if_lower_hook用法及代碼示例
- Python tf.estimator.RunConfig用法及代碼示例
- Python tf.estimator.MultiLabelHead用法及代碼示例
- Python tf.estimator.experimental.stop_if_no_increase_hook用法及代碼示例
- Python tf.estimator.DNNLinearCombinedEstimator用法及代碼示例
- Python tf.estimator.Estimator用法及代碼示例
- Python tf.estimator.experimental.LinearSDCA用法及代碼示例
- Python tf.estimator.experimental.RNNClassifier用法及代碼示例
- Python tf.estimator.experimental.make_early_stopping_hook用法及代碼示例
- Python tf.estimator.LinearRegressor用法及代碼示例
- Python tf.estimator.LinearEstimator用法及代碼示例
- Python tf.estimator.DNNClassifier用法及代碼示例
注:本文由純淨天空篩選整理自tensorflow.org大神的英文原創作品 tf.estimator.BaselineClassifier。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。