HyperDriveConfig 클래스

참조

HyperDrive 실행을 정의하는 구성입니다.

HyperDrive 구성에는 하이퍼 매개 변수 공간 샘플링, 종료 정책, 기본 메트릭, 구성에서 다시 시작, 예측 도구 및 실험을 실행할 컴퓨팅 대상에 대한 정보가 포함되어 있습니다.

HyperDriveConfig를 초기화합니다.

상속: builtins.object

HyperDriveConfig

생성자

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)

매개 변수

Name	Description
estimator	MMLBaseEstimator 샘플링된 하이퍼 매개 변수로 호출될 예측 도구입니다. `estimator`, `run_config` 또는 `pipeline` 매개 변수 중 하나만 지정합니다. Default value: None
hyperparameter_sampling 필수	HyperParameterSampling 하이퍼 매개 변수 샘플링 공간입니다.
policy	EarlyTerminationPolicy 사용할 조기 종료 정책입니다. 기본값인 None인 경우 조기 종료 정책이 사용되지 않습니다. 5의 `delay_evaluation`이 있는 MedianStoppingPolicy는 시작하기에 좋은 종료 정책입니다. 이는 보수적인 설정으로, 기본 메트릭의 손실 없이 25%~35% 절감 효과를 제공할 수 있습니다(평가 데이터 기반). Default value: None
primary_metric_name 필수	str 실험 실행에서 보고된 기본 메트릭의 이름입니다.
primary_metric_goal 필수	PrimaryMetricGoal PrimaryMetricGoal.MINIMIZE 또는 PrimaryMetricGoal.MAXIMIZE입니다. 이 매개 변수는 실행을 평가할 때 기본 메트릭을 최소화할지 최대화할지 결정합니다.
max_total_runs 필수	int 만들 수 있는 최대 총 실행 수입니다. 이는 상한입니다. 표본 공간이 이 값보다 작으면 더 적은 수의 실행이 있을 수 있습니다. `max_total_runs` 및 `max_duration_minutes`가 모두 지정된 경우 이러한 두 임계값 중 첫 번째 임계값에 도달하면 하이퍼 매개 변수 조정 실험은 종료됩니다.
max_concurrent_runs	int 동시에 실행할 수 있는 최대 실행 수입니다. None이면 모든 실행이 병렬로 시작됩니다. 동시 실행 수는 지정된 컴퓨팅 대상에서 사용할 수 있는 리소스에서 제어됩니다. 따라서 컴퓨팅 대상이 원하는 동시성에 대한 사용 가능한 리소스를 갖도록 해야 합니다. Default value: None
max_duration_minutes	int HyperDrive 실행의 최대 기간입니다. 이 시간을 초과하면 아직 실행 중인 모든 실행이 취소됩니다. `max_total_runs` 및 `max_duration_minutes`가 모두 지정된 경우 이러한 두 임계값 중 첫 번째 임계값에 도달하면 하이퍼 매개 변수 조정 실험은 종료됩니다. Default value: 10080
resume_from	HyperDriveRun 또는 list[HyperDriveRun] 새 실행을 웜 부팅하기 위한 데이터 포인트로 상속될 HyperDrive 실행 또는 HyperDrive 실행 목록입니다. Default value: None
resume_child_runs	Run 또는 list[Run] 새 HyperDrive 실행의 새 자식 실행으로 다시 시작될 HyperDrive 자식 실행 또는 HyperDrive 자식 실행 목록입니다. Default value: None
run_config	ScriptRunConfig 스크립트/Notebook에 대한 구성을 설정하기 위한 개체가 실행됩니다. `estimator`, `run_config` 또는 `pipeline` 매개 변수 중 하나만 지정합니다. Default value: None
pipeline	Pipeline 파이프라인 실행에 대한 구성을 설정하기 위한 파이프라인 개체입니다. 파이프라인 개체는 샘플 하이퍼 매개 변수와 함께 호출되어 파이프라인 실행을 제출합니다. `estimator`, `run_config` 또는 `pipeline` 매개 변수 중 하나만 지정합니다. Default value: None
custom_run_id	str 사용자가 제공한 사용자 지정 실행 ID Default value: None
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인 경우 조기 종료 정책이 사용되지 않습니다. 5의 `delay_evaluation`이 있는 <xref:azureml.train.hyperdrive.MedianTerminationPolicy>는 시작하기에 좋은 종료 정책입니다. 이는 보수적인 설정으로, 기본 메트릭의 손실 없이 25%~35% 절감 효과를 제공할 수 있습니다(평가 데이터 기반).
estimator 필수	MMLBaseEstimator 샘플링된 하이퍼 매개 변수로 호출될 예측 도구입니다. `estimator`, `run_config` 또는 `pipeline` 매개 변수 중 하나만 지정합니다.
run_config 필수	ScriptRunConfig 스크립트/Notebook에 대한 구성을 설정하기 위한 개체가 실행됩니다. `estimator`, `run_config` 또는 `pipeline` 매개 변수 중 하나만 지정합니다.
resume_from 필수	HyperDriveRun \| list[HyperDriveRun] 새 실행을 웜 부팅하기 위한 데이터 포인트로 상속될 HyperDrive 실행 또는 HyperDrive 실행 목록입니다.
resume_child_runs 필수	Run \| list[Run] 새 HyperDrive 실행의 새 자식 실행으로 다시 시작될 HyperDrive 자식 실행 또는 HyperDrive 자식 실행 목록입니다.
pipeline 필수	Pipeline 파이프라인 실행에 대한 구성을 설정하기 위한 파이프라인 개체입니다. 파이프라인 개체는 샘플 하이퍼 매개 변수와 함께 호출되어 파이프라인 실행을 제출합니다. `estimator`, `run_config` 또는 `pipeline` 매개 변수 중 하나만 지정합니다.
custom_run_id 필수	str 사용자가 제공한 사용자 지정 실행 ID
debug_flag	Default value: None

설명

아래 예는 하이퍼 매개 변수 조정에 사용할 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입니다.

반환

형식	Description
Estimator, None	예측 도구입니다.

pipeline

HyperDrive 실행에 사용된 파이프라인을 반환합니다.

실행이 스크립트 실행 구성 또는 예측 도구를 사용하는 경우 값은 None입니다.

반환

형식	Description
Pipeline, None	파이프라인입니다.

run_config

HyperDrive 실행에 사용된 스크립트/Notebook 구성을 반환합니다.

실행이 예측 도구 또는 파이프라인을 사용하는 경우 값은 None입니다.

반환

형식	Description
ScriptRunConfig, None	실행 구성입니다.

source_directory

실행할 구성에서 소스 디렉터리를 반환합니다.

반환

형식	Description
str	소스 디렉터리

다음을 통해 공유