HyperDriveRunConfig 類別

定義 HyperDrive 執行的組態。

組態包含參數空間取樣、終止原則、主要計量、估算器和執行實驗執行目標的相關資訊。

初始化 HyperDriveConfig。

繼承
azureml.train.hyperdrive.runconfig.HyperDriveConfig
HyperDriveRunConfig

建構函式

HyperDriveRunConfig(estimator, hyperparameter_sampling, primary_metric_name, primary_metric_goal, max_total_runs, max_concurrent_runs=None, max_duration_minutes=10080, policy=None)

參數

hyperparameter_sampling
HyperParameterSampling
必要

超參數取樣空間。

primary_metric_name
str
必要

實驗執行所報告的主要計量名稱。

primary_metric_goal
PrimaryMetricGoal
必要

其中一個最大化/最小化。 它會判斷主要計量是否必須在實驗執行評估中最小化/最大化。

max_total_runs
int
必要

執行次數上限。 這是上限;當樣本空間小於此值時,可能會有較少的執行。

max_concurrent_runs
int
預設值: None

要同時執行的執行數目上限。 如果為 None,則會以平行方式啟動所有執行。

max_duration_minutes
int
預設值: 10080

Hyperdrive 執行的最大持續時間。 超過此時間之後,就會取消執行。 子執行的持續時間上限可以使用 ScriptRunConfig 的 「max_run_duration_seconds」 引數來設定。

policy
EarlyTerminationPolicy
預設值: None

要使用的提早終止原則。 如果為 None - 預設值,則不會使用任何提早終止原則。 delay_evaluation為 5 的 MedianTerminationPolicy 是一個開始的良好終止原則。 這些是保守的設定,可根據我們的評估資料) ,為主要計量 (節省 25%-35% 的費用。

estimator
MMLBaseEstimator
必要

使用取樣的超參數呼叫的估算器。

run_config
ScriptRunConfig
必要

物件,用於設定腳本/筆記本執行的組態。 只指定下列其中一個參數: estimatorrun_configpipeline

resume_from
HyperDriveRunlist[HyperDriveRun]
必要

Hyperdrive 執行或 hyperdrive 執行清單,這些執行會繼承為資料點,以暖啟動新的執行。

resume_child_runs
Runlist[Run]
必要

Hyperdrive 子執行或 hyperdrive 子執行清單,當新 Hyperdrive 執行的新子執行時,將會繼續執行。

pipeline
Pipeline
必要

用於設定管線執行組態的管線物件。 管線物件將會使用範例超參數呼叫,以提交管線執行。 只指定下列其中一個參數: estimatorrun_configpipeline

hyperparameter_sampling
HyperParameterSampling
必要

超參數空間取樣定義。

primary_metric_name
str
必要

實驗執行所報告的主要計量名稱。

primary_metric_goal
PrimaryMetricGoal
必要

PrimaryMetricGoal.MINIMIZE 或 PrimaryMetricGoal.MAXIMIZE。 此參數會判斷評估執行時,主要計量是否要最小化或最大化。

max_total_runs
int
必要

要建立的執行總數上限。 這是上限;當樣本空間小於此值時,可能會有較少的執行。

max_concurrent_runs
int
必要

要同時執行的執行數目上限。 如果為 None,則會以平行方式啟動所有執行。

max_duration_minutes
int
必要

HyperDrive 執行的持續時間上限。 超過此時間之後,任何仍在執行的執行都會取消。

policy
EarlyTerminationPolicy
必要

要使用的提早終止原則。 如果為 None - 預設值,則不會使用任何提早終止原則。

具有 <xref:azureml.train.hyperdrive.MedianTerminationPolicy>delay_evaluation 5 的 是一個很好的終止原則, 這些是保守的設定,可根據我們的評估資料) ,為主要計量 (節省 25%-35% 的費用。

estimator
MMLBaseEstimator
必要

使用取樣的超參數呼叫的估算器。 只指定下列其中一個參數: estimatorrun_configpipeline

run_config
ScriptRunConfig
必要

物件,用於設定腳本/筆記本執行的組態。 只指定下列其中一個參數: estimatorrun_configpipeline

resume_from
HyperDriveRun | list[HyperDriveRun]
必要

Hyperdrive 執行或 hyperdrive 執行清單,這些執行會繼承為資料點,以暖啟動新的執行。

resume_child_runs
Run | list[Run]
必要

Hyperdrive 子執行或 hyperdrive 子執行清單,當新 Hyperdrive 執行的新子執行時,將會繼續執行。

pipeline
Pipeline
必要

用於設定管線執行組態的管線物件。 管線物件將會使用範例超參數呼叫,以提交管線執行。 只指定下列其中一個參數: estimatorrun_configpipeline

custom_run_id
str
必要

使用者提供的自訂執行識別碼