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

必須

スクリプト/ノートブック実行の構成を設定するオブジェクト。 estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。

resume_from: HyperDriveRun または list[HyperDriveRun]

必須

ハイパードライブの実行、または新しい実行をウォームスタートするためのデータポイントとして継承されるハイパードライブ実行の一覧。

resume_child_runs: Run または list[Run]

必須

ハイパードライブの子実行、または新しいハイパードライブ実行の新しい子実行として再開されるハイパードライブの子実行の一覧。

pipeline: Pipeline

必須

パイプライン実行の構成を設定するパイプラインオブジェクト。パイプラインオブジェクトは、パイプラインの実行を送信するためにサンプルのハイパーパラメーターを使用して呼び出されます。 estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。

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

必須

サンプリングされたハイパーパラメーターを使用して呼び出される推定器。 estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。

run_config: ScriptRunConfig

必須