用於訓練和評估 TensorFlow 模型的 Estimator 類。
警告:不建議將估算器用於新代碼。估算器運行tf.compat.v1.Session-style 代碼更難正確編寫,並且可能出現意外行為,尤其是與 TF 2 代碼結合使用時。估算器確實屬於我們的兼容性保證,但不會收到除安全漏洞以外的任何修複。見遷移指南詳情。
用法
tf.compat.v1.estimator.Estimator(
model_fn, model_dir=None, config=None, params=None, warm_start_from=None
)
參數
-
model_fn
模型函數。遵循簽名:features
-- 這是從input_fn
返回的第一項,傳遞給train
,evaluate
和predict
。這應該是一個相同的tf.Tensor
或dict
。labels
-- 這是從傳遞給train
,evaluate
和predict
的input_fn
返回的第二項。這應該是相同的單個tf.Tensor
或dict
(對於multi-head 型號)。如果 mode 是tf.estimator.ModeKeys.PREDICT
,labels=None
將被傳遞。如果model_fn
的簽名不接受mode
,則model_fn
必須仍然能夠處理labels=None
。mode
-- 可選。指定這是訓練、評估還是預測。見tf.estimator.ModeKeys
。params
-- 可選的dict
超參數。將接收params
參數中傳遞給 Estimator 的內容。這允許通過超參數調整來配置 Estimator。config
-- 可選的estimator.RunConfig
對象。將接收作為其config
參數或默認值傳遞給 Estimator 的內容。允許根據num_ps_replicas
或model_dir
等配置在model_fn
中進行設置。- 返回 --
tf.estimator.EstimatorSpec
-
model_dir
保存模型參數、圖形等的目錄。這也可用於將檢查點從目錄加載到估計器中,以繼續訓練先前保存的模型。如果PathLike
對象,路徑將被解析。如果None
,如果設置,將使用config
中的 model_dir。如果兩者都設置,則它們必須相同。如果兩者都是None
,將使用臨時目錄。 -
config
estimator.RunConfig
配置對象。 -
params
dict
的超參數將被傳遞到model_fn
。鍵是參數的名稱,值是基本的 Python 類型。 -
warm_start_from
檢查點或 SavedModel 的可選字符串文件路徑以進行熱啟動,或tf.estimator.WarmStartSettings
對象以完全配置熱啟動。如果沒有,隻有 TRAINABLE 變量是熱啟動的。如果提供了字符串文件路徑而不是tf.estimator.WarmStartSettings
,則所有變量都是熱啟動的,並且假定詞匯表和tf.Tensor
名稱不變。
拋出
-
ValueError
model_fn
的參數與params
不匹配。 -
ValueError
如果這是通過子類調用的,並且該類覆蓋了Estimator
的成員。
屬性
-
config
-
model_dir
-
model_fn
返回綁定到self.params
的model_fn
。 -
params
Estimator
對象包裝了由 model_fn
指定的模型,該模型在給定輸入和許多其他參數的情況下,返回執行訓練、評估或預測所需的操作。
所有輸出(檢查點、事件文件等)都寫入 model_dir
或其子目錄。如果未設置model_dir
,則使用臨時目錄。
config
參數可以傳遞 tf.estimator.RunConfig
對象,其中包含有關執行環境的信息。如果 model_fn
有一個名為 "config" 的參數(並且以相同的方式輸入函數),它會被傳遞給 model_fn
。如果未傳遞 config
參數,則由 Estimator
實例化。不傳遞配置意味著使用對本地執行有用的默認值。 Estimator
使配置對模型可用(例如,允許基於可用工人數量的專業化),並且還使用它的一些字段來控製內部,特別是關於檢查點。
params
參數包含超參數。如果 model_fn
有一個名為 "params" 的參數,它會被傳遞給 model_fn
,並以相同的方式傳遞給輸入函數。 Estimator
隻傳遞參數,它不檢查它。因此,params
的結構完全取決於開發人員。
Estimator
的任何方法都不能在子類中被覆蓋(其構造函數強製執行此操作)。子類應該使用model_fn
來配置基類,並且可以添加實現特殊函數的方法。
有關詳細信息,請參閱估算器。
熱啟動 Estimator
:
estimator = tf.estimator.DNNClassifier(
feature_columns=[categorical_feature_a_emb, categorical_feature_b_emb],
hidden_units=[1024, 512, 256],
warm_start_from="/path/to/checkpoint/dir")
有關熱啟動配置的更多詳細信息,請參閱tf.estimator.WarmStartSettings
。
相關用法
- Python tf.compat.v1.estimator.DNNEstimator用法及代碼示例
- Python tf.compat.v1.estimator.experimental.KMeans用法及代碼示例
- Python tf.compat.v1.estimator.tpu.RunConfig用法及代碼示例
- Python tf.compat.v1.estimator.regressor_parse_example_spec用法及代碼示例
- Python tf.compat.v1.estimator.BaselineRegressor用法及代碼示例
- Python tf.compat.v1.estimator.inputs.numpy_input_fn用法及代碼示例
- Python tf.compat.v1.estimator.LinearRegressor用法及代碼示例
- Python tf.compat.v1.estimator.BaselineEstimator用法及代碼示例
- Python tf.compat.v1.estimator.BaselineClassifier用法及代碼示例
- Python tf.compat.v1.estimator.LinearClassifier用法及代碼示例
- Python tf.compat.v1.estimator.DNNLinearCombinedRegressor用法及代碼示例
- Python tf.compat.v1.estimator.tpu.TPUEstimator用法及代碼示例
- Python tf.compat.v1.estimator.DNNClassifier用法及代碼示例
- Python tf.compat.v1.estimator.DNNRegressor用法及代碼示例
- Python tf.compat.v1.estimator.tpu.experimental.EmbeddingConfigSpec用法及代碼示例
- Python tf.compat.v1.estimator.DNNLinearCombinedEstimator用法及代碼示例
- Python tf.compat.v1.estimator.LinearEstimator用法及代碼示例
- Python tf.compat.v1.estimator.classifier_parse_example_spec用法及代碼示例
- Python tf.compat.v1.estimator.DNNLinearCombinedClassifier用法及代碼示例
- Python tf.compat.v1.enable_eager_execution用法及代碼示例
注:本文由純淨天空篩選整理自tensorflow.org大神的英文原創作品 tf.compat.v1.estimator.Estimator。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。