HyperDriveConfig クラス
HyperDrive の実行を定義する構成。
HyperDrive の構成には、ハイパーパラメーター空間サンプリング、終了ポリシー、プライマリ メトリック、構成からの再開、推定器、実験の実行を実行するコンピューティング先に関する情報が含まれています。
HyperDriveConfig を初期化します。
- 継承
-
builtins.objectHyperDriveConfig
コンストラクター
HyperDriveConfig(hyperparameter_sampling, primary_metric_name, primary_metric_goal, max_total_runs, max_concurrent_runs=None, max_duration_minutes=10080, policy=None, estimator=None, run_config=None, resume_from=None, resume_child_runs=None, pipeline=None, debug_flag=None, custom_run_id=None)パラメーター
- estimator
- MMLBaseEstimator
サンプリングされたハイパーパラメーターを使用して呼び出される推定器。
estimator、run_config、pipeline のいずれかのパラメーターのみを指定します。
- policy
- EarlyTerminationPolicy
使用する早期終了ポリシー。 None (既定値) の場合、早期終了ポリシーは使用されません。
MedianStoppingPolicy で delay_evaluation を 5 に設定するのは、最初に使用する終了ポリシーとして有効です。 これらは保守的な設定であり、(評価データに基づいて) 主要メトリックに関する損失なしで 25% から 35% の節約を実現できます。
- primary_metric_goal
- PrimaryMetricGoal
PrimaryMetricGoal.MINIMIZE または PrimaryMetricGoal.MAXIMIZE のいずれかです。 このパラメーターは、実行の評価時にプライマリ メトリックを最小化するか最大化するかを決定します。
- max_total_runs
- int
作成する実行の最大総数。 これは上限です。サンプル空間がこの値より小さい場合は、実行回数が少なくなる可能性があります。
max_total_runs と max_duration_minutes の両方を指定した場合は、これら 2 つのしきい値のうちの最初のしきい値に達するとハイパーパラメーター調整実験は終了します。
- max_concurrent_runs
- int
同時に実行できる実行の最大数。 None の場合、すべての実行が並列で起動されます。 並列実行の数は、指定された計算ターゲットで使用できるリソースに基づいて制御されます。 そのため、目的の同時実行可能性のために、計算ターゲットに必要なリソースを確保する必要があります。
- max_duration_minutes
- int
HyperDrive の実行の最大継続時間。 この時間を超えると、実行中の実行は取り消されます。 max_total_runs と max_duration_minutes の両方を指定した場合は、これら 2 つのしきい値のうちの最初のしきい値に達するとハイパーパラメーター調整実験は終了します。
- resume_from
- HyperDriveRun または list[HyperDriveRun]
ハイパードライブ実行、または新しい実行をウォーム スタートするためのデータ ポイントとして継承されるハイパードライブ実行の一覧。
ハイパードライブの子実行、または新しいハイパードライブ実行の新しい子実行として再開されるハイパードライブの子実行の一覧。
- run_config
- ScriptRunConfig
スクリプト/ノートブック実行の構成を設定するオブジェクト。
estimator、run_config、pipeline のいずれかのパラメーターのみを指定します。
- pipeline
- Pipeline
パイプライン実行の構成を設定するパイプライン オブジェクト。
パイプライン オブジェクトは、パイプラインの実行を送信するためにサンプルのハイパーパラメーターを使用して呼び出されます。
estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。
- primary_metric_goal
- PrimaryMetricGoal
PrimaryMetricGoal.MINIMIZE または PrimaryMetricGoal.MAXIMIZE のいずれかです。 このパラメーターは、実行の評価時にプライマリ メトリックを最小化するか最大化するかを決定します。
- policy
- EarlyTerminationPolicy
使用する早期終了ポリシー。 None (既定値) の場合、早期終了ポリシーは使用されません。
<xref:azureml.train.hyperdrive.MedianTerminationPolicy> で delay_evaluation を 5 に設定するのは、最初に使用する終了ポリシーとして有効です。 これらは保守的な設定であり、(評価データに基づいて) 主要メトリックに関する損失なしで 25% から 35% の節約を実現できます。
- estimator
- MMLBaseEstimator
サンプリングされたハイパー パラメーターを使用して呼び出される推定器。
estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。
- run_config
- ScriptRunConfig
スクリプト/ノートブック実行の構成を設定するオブジェクト。
estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。
- resume_from
- HyperDriveRun | list[HyperDriveRun]
ハイパードライブの実行、または新しい実行をウォーム スタートするためのデータ ポイントとして継承されるハイパードライブ実行の一覧。
- pipeline
- Pipeline
パイプライン実行の構成を設定するパイプライン オブジェクト。
パイプライン オブジェクトは、パイプラインの実行を送信するためにサンプルのハイパーパラメーターを使用して呼び出されます。
estimator、run_config、pipeline の次のいずれかのパラメーターのみを指定します。
- debug_flag
注釈
次の例は、ハイパーパラメーターのチューニングに使用する HyperDriveConfig オブジェクトの作成を示しています。 この例では、プライマリ メトリック名はトレーニング スクリプトに記録された値と一致します。
hd_config = HyperDriveConfig(run_config=src,
hyperparameter_sampling=ps,
policy=early_termination_policy,
primary_metric_name='validation_acc',
primary_metric_goal=PrimaryMetricGoal.MAXIMIZE,
max_total_runs=4,
max_concurrent_runs=4)
HyperDriveConfig の操作の詳細については、モデルのハイパーパラメーターのチューニングのチュートリアルを参照してください。
属性
estimator
HyperDrive の実行で使用される推定器を返します。
実行でスクリプト実行構成またはパイプラインが使用される場合、値は None です。
戻り値
推定器。
の戻り値の型 :
pipeline
HyperDrive の実行で使用されるパイプラインを返します。
実行でスクリプト実行構成または推定器が使用される場合、値は None です。
戻り値
パイプライン。
の戻り値の型 :
run_config
HyperDrive の実行で使用されるスクリプトまたはノートブックの構成を返します。
実行で推定器またはパイプラインが使用される場合、値は None です。
戻り値
実行構成。
の戻り値の型 :
source_directory
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示