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
|
샘플링된 하이퍼 매개 변수를 사용하여 호출되는 추정기입니다.
다음 매개 변수 중 하나만 지정합니다 Default value: None
|
|
hyperparameter_sampling
필수
|
하이퍼 매개 변수 샘플링 공간입니다. |
|
policy
|
사용할 조기 종료 정책입니다. None인 경우 기본값은 초기 종료 정책이 사용되지 않습니다.
MedianStoppingPolicy
Default value: None
|
|
primary_metric_name
필수
|
실험에서 보고한 기본 메트릭의 이름이 실행됩니다. |
|
primary_metric_goal
필수
|
PrimaryMetricGoal.MINIMIZE 또는 PrimaryMetricGoal.MAXIMIZE. 이 매개 변수는 실행을 평가할 때 기본 메트릭을 최소화하거나 최대화할지 여부를 결정합니다. |
|
max_total_runs
필수
|
만들 최대 총 실행 수입니다. 상한입니다. 샘플 공간이 이 값보다 작은 경우 실행 수가 적을 수 있습니다.
|
|
max_concurrent_runs
|
동시에 실행할 최대 실행 수입니다. None이면 모든 실행이 병렬로 시작됩니다. 동시 실행 수는 지정된 컴퓨팅 대상에서 사용할 수 있는 리소스에서 제어됩니다. 따라서 컴퓨팅 대상에 원하는 동시성에 사용할 수 있는 리소스가 있는지 확인해야 합니다. Default value: None
|
|
max_duration_minutes
|
HyperDrive 실행의 최대 기간입니다. 이 시간을 초과하면 실행 중인 모든 실행이 취소됩니다.
Default value: 10080
|
|
resume_from
|
새 실행을 웜 시작하기 위해 데이터 포인트로 상속되는 하이퍼드라이브 실행 또는 하이퍼드라이브 실행 목록입니다. Default value: None
|
|
resume_child_runs
|
새 하이퍼드라이브 실행의 새 자식 실행으로 다시 시작될 하이퍼드라이브 자식 실행 또는 하이퍼드라이브 자식 실행 목록입니다. Default value: None
|
|
run_config
|
스크립트/Notebook에 대한 구성을 설정하기 위한 개체가 실행됩니다.
다음 매개 변수 중 하나만 지정합니다 Default value: None
|
|
pipeline
|
파이프라인 실행에 대한 구성을 설정하기 위한 파이프라인 개체입니다.
파이프라인 개체는 샘플 하이퍼 매개 변수를 사용하여 호출하여 파이프라인 실행을 제출합니다.
다음 매개 변수 중 하나만 지정합니다 Default value: None
|
|
custom_run_id
|
사용자가 제공한 사용자 지정 실행 ID Default value: None
|
|
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
필수
|
스크립트/Notebook에 대한 구성을 설정하기 위한 개체가 실행됩니다.
다음 매개 변수 중 하나만 지정합니다 |
|
resume_from
필수
|
새 실행을 웜 시작하기 위해 데이터 포인트로 상속되는 하이퍼드라이브 실행 또는 하이퍼드라이브 실행 목록입니다. |
|
resume_child_runs
필수
|
새 하이퍼드라이브 실행의 새 자식 실행으로 다시 시작될 하이퍼드라이브 자식 실행 또는 하이퍼드라이브 자식 실행 목록입니다. |
|
pipeline
필수
|
파이프라인 실행에 대한 구성을 설정하기 위한 파이프라인 개체입니다.
파이프라인 개체는 샘플 하이퍼 매개 변수를 사용하여 호출하여 파이프라인 실행을 제출합니다.
다음 매개 변수 중 하나만 지정합니다 |
|
custom_run_id
필수
|
사용자가 제공한 사용자 지정 실행 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
pipeline
run_config
HyperDrive 실행에 사용되는 스크립트/Notebook 구성을 반환합니다.
실행에서 추정기 또는 파이프라인을 사용하는 경우 값은 None입니다.
반환
| 형식 | Description |
|---|---|
|
실행 구성입니다. |