當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文


Python tf.compat.v1.estimator.Estimator用法及代碼示例


用於訓練和評估 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 , evaluatepredict 。這應該是一個相同的 tf.Tensordict
    • labels -- 這是從傳遞給 train , evaluatepredictinput_fn 返回的第二項。這應該是相同的單個tf.Tensordict(對於multi-head 型號)。如果 mode 是 tf.estimator.ModeKeys.PREDICTlabels=None 將被傳遞。如果 model_fn 的簽名不接受 mode ,則 model_fn 必須仍然能夠處理 labels=None
    • mode -- 可選。指定這是訓練、評估還是預測。見tf.estimator.ModeKeysparams -- 可選的 dict 超參數。將接收 params 參數中傳遞給 Estimator 的內容。這允許通過超參數調整來配置 Estimator。
    • config -- 可選的 estimator.RunConfig 對象。將接收作為其config 參數或默認值傳遞給 Estimator 的內容。允許根據 num_ps_replicasmodel_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.paramsmodel_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

相關用法


注:本文由純淨天空篩選整理自tensorflow.org大神的英文原創作品 tf.compat.v1.estimator.Estimator。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。