HyperDriveRunConfig 类
定义 HyperDrive 运行的配置。
配置包括有关参数空间采样、终止策略、主要指标、估算器以及执行试验运行的计算目标的信息。
初始化 HyperDriveConfig。
构造函数
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
必需
|
超参数采样空间。 |
primary_metric_name
必需
|
试验运行报告的主要指标的名称。 |
primary_metric_goal
必需
|
最大化/最小化之一。 它确定主要指标是否必须在试验运行评估中最小化/最大化。 |
max_total_runs
必需
|
最大运行数。 这是上限;当样本空间小于此值时,运行次数可能更少。 |
max_concurrent_runs
|
要并发运行的最大运行数。 如果为 None,则所有运行都并行启动。 默认值: None
|
max_duration_minutes
|
Hyperdrive 运行的最大持续时间。 超过此时间后,将取消运行。 可以使用 ScriptRunConfig 的“max_run_duration_seconds”参数设置子运行的最大持续时间。 默认值: 10080
|
policy
|
要使用的提前终止策略。 如果 None - 默认值,则不会使用提前终止策略。 delay_evaluation为 5 的 MedianTerminationPolicy 是一个很好的终止策略。 这些是保守的设置,可以提供 25%-35% 节省,且主要指标不会丢失(基于我们的评估数据)。 默认值: None
|
estimator
必需
|
将使用采样的超参数调用的估算器。 |
run_config
必需
|
用于设置脚本/笔记本运行的配置的对象。
仅指定以下参数之一: |
resume_from
必需
|
Hyperdrive 运行或作为数据点继承的 Hyperdrive 运行列表,以预启动新运行。 |
resume_child_runs
必需
|
Hyperdrive 子运行或将作为新 Hyperdrive 运行的新子运行恢复的 hyperdrive 子运行的列表。 |
pipeline
必需
|
用于设置管道运行配置的管道对象。
将使用示例超参数调用管道对象来提交管道运行。
仅指定以下参数之一: |
hyperparameter_sampling
必需
|
超参数空间采样定义。 |
primary_metric_name
必需
|
试验运行报告的主要指标的名称。 |
primary_metric_goal
必需
|
PrimaryMetricGoal.MINIMIZE 或 PrimaryMetricGoal.MAXIMIZE。 此参数确定在评估运行时,主要指标是最小化还是最大化。 |
max_total_runs
必需
|
要创建的运行总数上限。 这是上限;当样本空间小于此值时,运行次数可能更少。 |
max_concurrent_runs
必需
|
要并发执行的最大运行数。 如果为 None,则所有运行都并行启动。 |
max_duration_minutes
必需
|
HyperDrive 运行的最大持续时间。 超过此时间后,仍在执行的任何运行将被取消。 |
policy
必需
|
要使用的提前终止策略。 如果 None - 默认值,则不会使用提前终止策略。
<xref:azureml.train.hyperdrive.MedianTerminationPolicy>
|
estimator
必需
|
将使用采样的超参数调用的估算器。
仅指定以下参数之一: |
run_config
必需
|
用于设置脚本/笔记本运行的配置的对象。
仅指定以下参数之一: |
resume_from
必需
|
Hyperdrive 运行或作为数据点继承的 Hyperdrive 运行列表,以预启动新运行。 |
resume_child_runs
必需
|
Hyperdrive 子运行或将作为新 Hyperdrive 运行的新子运行恢复的 hyperdrive 子运行的列表。 |
pipeline
必需
|
用于设置管道运行配置的管道对象。
将使用示例超参数调用管道对象来提交管道运行。
仅指定以下参数之一: |
custom_run_id
必需
|
用户提供的自定义运行 ID |