HyperDriveRun 클래스
HyperDriveRun에는 제출된 HyperDrive 실험의 세부 정보가 포함되어 있습니다.
이 클래스는 HyperDrive 실행 및 생성된 각 자식 실행에 대한 실행 세부 정보를 관리, 확인 및 검색하는 데 사용할 수 있습니다.
HyperDrive 실행을 초기화합니다.
- 상속
-
HyperDriveRun
생성자
HyperDriveRun(experiment, run_id, hyperdrive_config=None, **kwargs)매개 변수
| Name | Description |
|---|---|
|
experiment
필수
|
HyperDrive 실행에 대한 실험입니다. |
|
run_id
필수
|
HyperDrive 실행 ID입니다. |
|
hyperdrive_config
|
이 HyperDrive 실행에 대한 구성입니다. Default value: None
|
|
experiment
필수
|
HyperDrive 실행에 대한 실험입니다. |
|
run_id
필수
|
HyperDrive 실행 ID입니다. |
|
hyperdrive_config
필수
|
이 HyperDrive 실행에 대한 구성입니다. None인 경우 실행이 이미 있고 클라우드에서 수화하려고 한다고 가정합니다. |
메서드
| cancel |
HyperDrive 실행이 성공적으로 취소되면 True를 반환합니다. |
| fail |
사용하지 마십시오. HyperDriveRun 하위 클래스에는 fail 메서드가 지원되지 않습니다. |
| get_best_run_by_primary_metric |
모든 자식 실행 중에서 성능이 우수한 실행에 해당하는 Run 인스턴스를 찾아 반환합니다. 성능이 우수한 실행은 HyperDriveConfig에 지정된 기본 메트릭 매개 변수만을 기반으로 식별됩니다. PrimaryMetricGoal은 기본 메트릭의 최솟값 또는 최댓값이 사용되는지 여부를 제어합니다. 이 HyperDriveRun에 의해 시작된 모든 ExperimentRun 메트릭에 대한 더 자세한 분석을 수행하려면 get_metrics를 사용합니다. 이 HyperDrive 실행에 의해 실행된 실행 중 여러 개가 동일한 최상의 메트릭에 도달하더라도 실행 중 하나만 반환됩니다. |
| get_children_sorted_by_primary_metric |
최고의 기본 메트릭으로 정렬된 자식 목록을 반환합니다. 정렬은 기본 메트릭 및 해당 목표에 따라 수행됩니다. 최대화되면 자식이 가장 좋은 기본 메트릭의 내림차순으로 반환됩니다. reverse가 True이면 순서가 반대로 됩니다. 결과의 각 자식에는 실행 ID, 하이퍼 매개 변수, 최상의 기본 메트릭 값 및 상태가 있습니다. 기본 메트릭이 없는 자식은 destroy_no_metric이 True일 때 버려집니다. 그렇지 않으면 기본 메트릭이 있는 다른 자식 뒤에 있는 목록에 추가됩니다. reverse 옵션은 영향을 미치지 않습니다. |
| get_diagnostics |
사용하지 마십시오. get_diagnostics 메서드는 HyperDriveRun 하위 클래스에 대해 지원되지 않습니다. |
| get_hyperparameters |
이 HyperDriveRun에 의해 시작된 모든 자식 실행에 대한 하이퍼 매개 변수를 반환합니다. |
| get_metrics |
이 HyperDriveRun에 의해 시작된 모든 실행의 메트릭을 반환합니다. |
cancel
fail
사용하지 마십시오. HyperDriveRun 하위 클래스에는 fail 메서드가 지원되지 않습니다.
fail()예외
| 형식 | Description |
|---|---|
get_best_run_by_primary_metric
모든 자식 실행 중에서 성능이 우수한 실행에 해당하는 Run 인스턴스를 찾아 반환합니다.
성능이 우수한 실행은 HyperDriveConfig에 지정된 기본 메트릭 매개 변수만을 기반으로 식별됩니다. PrimaryMetricGoal은 기본 메트릭의 최솟값 또는 최댓값이 사용되는지 여부를 제어합니다. 이 HyperDriveRun에 의해 시작된 모든 ExperimentRun 메트릭에 대한 더 자세한 분석을 수행하려면 get_metrics를 사용합니다. 이 HyperDrive 실행에 의해 실행된 실행 중 여러 개가 동일한 최상의 메트릭에 도달하더라도 실행 중 하나만 반환됩니다.
get_best_run_by_primary_metric(include_failed=True, include_canceled=True, include_resume_from_runs=True) -> Run | None매개 변수
| Name | Description |
|---|---|
|
include_failed
|
실패한 실행을 포함할지 여부를 나타냅니다. Default value: True
|
|
include_canceled
|
취소된 실행을 포함할지 여부를 나타냅니다. Default value: True
|
|
include_resume_from_runs
|
상속된 resume_from 실행을 포함할지 여부를 나타냅니다. Default value: True
|
반환
| 형식 | Description |
|---|---|
|
최상의 실행 또는 기본 메트릭이 있는 자식이 없는 경우 None입니다. |
get_children_sorted_by_primary_metric
최고의 기본 메트릭으로 정렬된 자식 목록을 반환합니다.
정렬은 기본 메트릭 및 해당 목표에 따라 수행됩니다. 최대화되면 자식이 가장 좋은 기본 메트릭의 내림차순으로 반환됩니다. reverse가 True이면 순서가 반대로 됩니다.
결과의 각 자식에는 실행 ID, 하이퍼 매개 변수, 최상의 기본 메트릭 값 및 상태가 있습니다.
기본 메트릭이 없는 자식은 destroy_no_metric이 True일 때 버려집니다. 그렇지 않으면 기본 메트릭이 있는 다른 자식 뒤에 있는 목록에 추가됩니다. reverse 옵션은 영향을 미치지 않습니다.
get_children_sorted_by_primary_metric(top=0, reverse=False, discard_no_metric=False)매개 변수
| Name | Description |
|---|---|
|
top
|
반환할 상위 자식의 수입니다. 0이면 모든 자식이 반환됩니다. Default value: 0
|
|
reverse
|
True이면 순서가 반대로 됩니다. 기본 메트릭이 있는 자식에만 영향을 줍니다. Default value: False
|
|
discard_no_metric
|
False이면 기본 메트릭이 없는 자식이 목록에 추가됩니다. Default value: False
|
반환
| 형식 | Description |
|---|---|
|
실행 ID, 하이퍼 매개 변수, 최상의 기본 메트릭 및 상태가 있는 사전 목록 |
get_diagnostics
사용하지 마십시오. get_diagnostics 메서드는 HyperDriveRun 하위 클래스에 대해 지원되지 않습니다.
get_diagnostics()예외
| 형식 | Description |
|---|---|
get_hyperparameters
이 HyperDriveRun에 의해 시작된 모든 자식 실행에 대한 하이퍼 매개 변수를 반환합니다.
get_hyperparameters()반환
| 형식 | Description |
|---|---|
|
모든 자식 실행에 대한 하이퍼 매개 변수입니다. run_id를 키로 사용하는 사전입니다. |
get_metrics
이 HyperDriveRun에 의해 시작된 모든 실행의 메트릭을 반환합니다.
get_metrics()반환
| 형식 | Description |
|---|---|
|
이 실행의 모든 자식에 대한 메트릭입니다. |
특성
hyperdrive_config
HYPER_DRIVE_RUN_USER_AGENT
HYPER_DRIVE_RUN_USER_AGENT = 'sdk_run_hyper_drive'RUN_TYPE
RUN_TYPE = 'hyperdrive'