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
必需
str

试验运行报告的主要指标的名称。

primary_metric_goal
必需

最大化/最小化之一。 它确定主要指标是否必须在试验运行评估中最小化/最大化。

max_total_runs
必需
int

最大运行数。 这是上限;当样本空间小于此值时,运行次数可能更少。

max_concurrent_runs
int

要并发运行的最大运行数。 如果为 None,则所有运行都并行启动。

默认值: None
max_duration_minutes
int

Hyperdrive 运行的最大持续时间。 超过此时间后,将取消运行。 可以使用 ScriptRunConfig 的“max_run_duration_seconds”参数设置子运行的最大持续时间。

默认值: 10080
policy

要使用的提前终止策略。 如果 None - 默认值,则不会使用提前终止策略。 delay_evaluation为 5 的 MedianTerminationPolicy 是一个很好的终止策略。 这些是保守的设置,可以提供 25%-35% 节省,且主要指标不会丢失(基于我们的评估数据)。

默认值: None
estimator
必需

将使用采样的超参数调用的估算器。

run_config
必需

用于设置脚本/笔记本运行的配置的对象。 仅指定以下参数之一: estimatorrun_configpipeline

resume_from
必需

Hyperdrive 运行或作为数据点继承的 Hyperdrive 运行列表,以预启动新运行。

resume_child_runs
必需
Runlist[Run]

Hyperdrive 子运行或将作为新 Hyperdrive 运行的新子运行恢复的 hyperdrive 子运行的列表。

pipeline
必需

用于设置管道运行配置的管道对象。 将使用示例超参数调用管道对象来提交管道运行。 仅指定以下参数之一: estimatorrun_configpipeline

hyperparameter_sampling
必需

超参数空间采样定义。

primary_metric_name
必需
str

试验运行报告的主要指标的名称。

primary_metric_goal
必需

PrimaryMetricGoal.MINIMIZE 或 PrimaryMetricGoal.MAXIMIZE。 此参数确定在评估运行时,主要指标是最小化还是最大化。

max_total_runs
必需
int

要创建的运行总数上限。 这是上限;当样本空间小于此值时,运行次数可能更少。

max_concurrent_runs
必需
int

要并发执行的最大运行数。 如果为 None,则所有运行都并行启动。

max_duration_minutes
必需
int

HyperDrive 运行的最大持续时间。 超过此时间后,仍在执行的任何运行将被取消。

policy
必需

要使用的提前终止策略。 如果 None - 默认值,则不会使用提前终止策略。

<xref:azureml.train.hyperdrive.MedianTerminationPolicy> delay_evaluation 5 的终止策略是一个很好的终止策略。 这些是保守的设置,可以提供 25%-35% 节省,且主要指标不会丢失(基于我们的评估数据)。

estimator
必需

将使用采样的超参数调用的估算器。 仅指定以下参数之一: estimatorrun_configpipeline

run_config
必需

用于设置脚本/笔记本运行的配置的对象。 仅指定以下参数之一: estimatorrun_configpipeline

resume_from
必需

Hyperdrive 运行或作为数据点继承的 Hyperdrive 运行列表,以预启动新运行。

resume_child_runs
必需
Run | list[Run]

Hyperdrive 子运行或将作为新 Hyperdrive 运行的新子运行恢复的 hyperdrive 子运行的列表。

pipeline
必需

用于设置管道运行配置的管道对象。 将使用示例超参数调用管道对象来提交管道运行。 仅指定以下参数之一: estimatorrun_configpipeline

custom_run_id
必需
str

用户提供的自定义运行 ID