다음을 통해 공유


HyperDriveConfig 클래스

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

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

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

샘플링된 하이퍼 매개 변수를 사용하여 호출되는 추정기입니다. 다음 매개 변수 중 하나만 지정합니다estimatorrun_configpipeline.

Default value: None
hyperparameter_sampling
필수

하이퍼 매개 변수 샘플링 공간입니다.

policy

사용할 조기 종료 정책입니다. None인 경우 기본값은 초기 종료 정책이 사용되지 않습니다.

MedianStoppingPolicy delay_evaluation 5를 사용하는 것은 시작하기에 좋은 종료 정책입니다. 이는 기본 메트릭에 대한 손실 없이 25개의%-35% 절감을 제공할 수 있는 보수적인 설정입니다(평가 데이터 기반).

Default value: None
primary_metric_name
필수
str

실험에서 보고한 기본 메트릭의 이름이 실행됩니다.

primary_metric_goal
필수

PrimaryMetricGoal.MINIMIZE 또는 PrimaryMetricGoal.MAXIMIZE. 이 매개 변수는 실행을 평가할 때 기본 메트릭을 최소화하거나 최대화할지 여부를 결정합니다.

max_total_runs
필수
int

만들 최대 총 실행 수입니다. 상한입니다. 샘플 공간이 이 값보다 작은 경우 실행 수가 적을 수 있습니다. max_total_runsmax_duration_minutes가 모두 지정된 경우 이러한 두 임계값 중 첫 번째 임계값에 도달하면 하이퍼 매개 변수 조정 실험은 종료됩니다.

max_concurrent_runs
int

동시에 실행할 최대 실행 수입니다. None이면 모든 실행이 병렬로 시작됩니다. 동시 실행 수는 지정된 컴퓨팅 대상에서 사용할 수 있는 리소스에서 제어됩니다. 따라서 컴퓨팅 대상에 원하는 동시성에 사용할 수 있는 리소스가 있는지 확인해야 합니다.

Default value: None
max_duration_minutes
int

HyperDrive 실행의 최대 기간입니다. 이 시간을 초과하면 실행 중인 모든 실행이 취소됩니다. max_total_runsmax_duration_minutes가 모두 지정된 경우 이러한 두 임계값 중 첫 번째 임계값에 도달하면 하이퍼 매개 변수 조정 실험은 종료됩니다.

Default value: 10080
resume_from

새 실행을 웜 시작하기 위해 데이터 포인트로 상속되는 하이퍼드라이브 실행 또는 하이퍼드라이브 실행 목록입니다.

Default value: None
resume_child_runs
Run 또는 list[Run]

새 하이퍼드라이브 실행의 새 자식 실행으로 다시 시작될 하이퍼드라이브 자식 실행 또는 하이퍼드라이브 자식 실행 목록입니다.

Default value: None
run_config

스크립트/Notebook에 대한 구성을 설정하기 위한 개체가 실행됩니다. 다음 매개 변수 중 하나만 지정합니다estimatorrun_configpipeline.

Default value: None
pipeline

파이프라인 실행에 대한 구성을 설정하기 위한 파이프라인 개체입니다. 파이프라인 개체는 샘플 하이퍼 매개 변수를 사용하여 호출하여 파이프라인 실행을 제출합니다. 다음 매개 변수 중 하나만 지정합니다estimatorrun_configpipeline.

Default value: None
custom_run_id
str

사용자가 제공한 사용자 지정 실행 ID

Default value: None
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
필수

스크립트/Notebook에 대한 구성을 설정하기 위한 개체가 실행됩니다. 다음 매개 변수 중 하나만 지정합니다estimatorrun_configpipeline.

resume_from
필수

새 실행을 웜 시작하기 위해 데이터 포인트로 상속되는 하이퍼드라이브 실행 또는 하이퍼드라이브 실행 목록입니다.

resume_child_runs
필수
Run | list[Run]

새 하이퍼드라이브 실행의 새 자식 실행으로 다시 시작될 하이퍼드라이브 자식 실행 또는 하이퍼드라이브 자식 실행 목록입니다.

pipeline
필수

파이프라인 실행에 대한 구성을 설정하기 위한 파이프라인 개체입니다. 파이프라인 개체는 샘플 하이퍼 매개 변수를 사용하여 호출하여 파이프라인 실행을 제출합니다. 다음 매개 변수 중 하나만 지정합니다estimatorrun_configpipeline.

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

추정기입니다.

pipeline

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

실행에서 스크립트 실행 구성 또는 추정기를 사용하는 경우 값은 None입니다.

반환

형식 Description

파이프라인입니다.

run_config

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

실행에서 추정기 또는 파이프라인을 사용하는 경우 값은 None입니다.

반환

형식 Description

실행 구성입니다.

source_directory

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

반환

형식 Description
str

원본 디렉터리