TensorFlow RNN 模型的分類器。
警告:不建議將估算器用於新代碼。估算器運行tf.compat.v1.Session-style 代碼更難正確編寫,並且可能出現意外行為,尤其是與 TF 2 代碼結合使用時。估算器確實屬於我們的兼容性保證,但不會收到除安全漏洞以外的任何修複。見遷移指南詳情。
用法
tf.estimator.experimental.RNNClassifier(
sequence_feature_columns, context_feature_columns=None, units=None,
cell_type=USE_DEFAULT, rnn_cell_fn=None, return_sequences=False, model_dir=None,
n_classes=2, weight_column=None, label_vocabulary=None,
optimizer='Adagrad',
loss_reduction=tf.losses.Reduction.SUM_OVER_BATCH_SIZE,
sequence_mask='sequence_mask', config=None
)參數
-
sequence_feature_columns包含表示順序輸入的FeatureColumn的可迭代對象。集合中的所有項目都應該是序列列(例如sequence_numeric_column)或從一個列構造(例如embedding_column與sequence_categorical_column_*作為輸入)。 -
context_feature_columns包含用於上下文輸入的FeatureColumn的迭代。這些列表示的數據將在每個時間步被複製並提供給 RNN。這些列必須是派生自DenseColumn的類的實例,例如numeric_column,而不是順序變體。 -
units每個 RNN 層的整數個隱藏單元的迭代。如果設置,還必須指定cell_type並且rnn_cell_fn必須是None。 -
cell_type生成 RNN 單元的類或指定單元類型的字符串。支持的字符串是:'simple_rnn','lstm'和'gru'。如果設置,還必須指定units並且rnn_cell_fn必須是None。 -
rnn_cell_fn一個返回 RNN 單元實例的函數,該實例將用於構造 RNN。如果設置,則無法設置units和cell_type。這適用於需要在units和cell_type之外進行額外自定義的高級用戶。請注意,堆疊 RNN 需要tf.keras.layers.StackedRNNCells。 -
return_sequences一個布爾值,指示是返回輸出序列中的最後一個輸出,還是返回完整序列。請注意,如果為 True,weight_column必須為 None 或字符串。 -
model_dir保存模型參數、圖形等的目錄。這也可用於將檢查點從目錄加載到估計器中,以繼續訓練先前保存的模型。 -
n_classes標簽類別的數量。默認為2,即二分類。必須 > 1。 -
weight_column由tf.feature_column.numeric_column創建的字符串或NumericColumn定義表示權重的特征列。它用於在訓練期間減輕重量或增加示例。它將乘以示例的損失。如果它是一個字符串,它被用作從features中獲取權重張量的鍵。如果是NumericColumn,則通過鍵weight_column.key獲取原始張量,然後對其應用 weight_column.normalizer_fn 以獲得權重張量。 -
label_vocabulary字符串列表表示可能的標簽值。如果給定,標簽必須是字符串類型並且在label_vocabulary中具有任何值。如果沒有給出,這意味著標簽已經編碼為整數或在 [0, 1] 內為n_classes=2和在 {0, 1,..., n_classes-1} 中編碼為整數值n_classes> 2.如果沒有提供詞匯並且標簽是字符串,也會出現錯誤。 -
optimizertf.Optimizer的實例或指定優化器類型的字符串。默認為 Adagrad 優化器。 -
loss_reductiontf.losses.Reduction之一,除了NONE。說明如何減少批量訓練損失。默認為SUM_OVER_BATCH_SIZE。 -
sequence_mask具有序列掩碼張量名稱的字符串。如果sequence_mask在特征字典中,則使用提供的張量,否則從序列特征的長度計算序列掩碼。序列掩碼用於評估和訓練模式以匯總損失和度量計算,同時排除填充步驟。它還在預測模式下添加到預測字典中,以指示哪些步驟正在填充。 -
configRunConfig對象來配置運行時設置。
拋出
-
ValueError如果units,cell_type和rnn_cell_fn不兼容。
屬性
-
config -
model_dir -
model_fn返回綁定到self.params的model_fn。 -
params
訓練循環神經網絡模型以將實例分類為多個類之一。
例子:
token_sequence = sequence_categorical_column_with_hash_bucket(...)
token_emb = embedding_column(categorical_column=token_sequence, ...)
estimator = RNNClassifier(
sequence_feature_columns=[token_emb],
units=[32, 16], cell_type='lstm')
# Input builders
def input_fn_train:# returns x, y
pass
estimator.train(input_fn=input_fn_train, steps=100)
def input_fn_eval:# returns x, y
pass
metrics = estimator.evaluate(input_fn=input_fn_eval, steps=10)
def input_fn_predict:# returns x, None
pass
predictions = estimator.predict(input_fn=input_fn_predict)
train 和 evaluate 的輸入應具有以下特征,否則會出現 KeyError :
- 如果
weight_column不是None,則具有key=weight_column的特征,其值為Tensor。 - 對於每個
column在sequence_feature_columns:- 具有
key=column.name的函數,其value是SparseTensor。
- 具有
- 對於每個
column在context_feature_columns:- 如果
column是CategoricalColumn,則具有key=column.name的特征,其value是SparseTensor。 - 如果
column是WeightedCategoricalColumn,則有兩個特征:第一個具有keyid 列名,第二個具有key權重列名。兩個函數的value必須是SparseTensor。 - 如果
column是DenseColumn,則具有key=column.name的特征,其value是Tensor。
- 如果
損失是通過使用 softmax 交叉熵來計算的。
相關用法
- Python tf.estimator.experimental.RNNEstimator用法及代碼示例
- Python tf.estimator.experimental.stop_if_lower_hook用法及代碼示例
- Python tf.estimator.experimental.stop_if_no_increase_hook用法及代碼示例
- Python tf.estimator.experimental.LinearSDCA用法及代碼示例
- Python tf.estimator.experimental.make_early_stopping_hook用法及代碼示例
- Python tf.estimator.experimental.stop_if_higher_hook用法及代碼示例
- Python tf.estimator.experimental.InMemoryEvaluatorHook用法及代碼示例
- Python tf.estimator.experimental.stop_if_no_decrease_hook用法及代碼示例
- Python tf.estimator.TrainSpec用法及代碼示例
- Python tf.estimator.LogisticRegressionHead用法及代碼示例
- Python tf.estimator.MultiHead用法及代碼示例
- Python tf.estimator.PoissonRegressionHead用法及代碼示例
- Python tf.estimator.WarmStartSettings用法及代碼示例
- Python tf.estimator.RunConfig用法及代碼示例
- Python tf.estimator.MultiLabelHead用法及代碼示例
- Python tf.estimator.BaselineEstimator用法及代碼示例
- Python tf.estimator.DNNLinearCombinedEstimator用法及代碼示例
- Python tf.estimator.Estimator用法及代碼示例
- Python tf.estimator.LinearRegressor用法及代碼示例
- Python tf.estimator.LinearEstimator用法及代碼示例
注:本文由純淨天空篩選整理自tensorflow.org大神的英文原創作品 tf.estimator.experimental.RNNClassifier。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。
