HyperDriveRun Klasa

Funkcja HyperDriveRun zawiera szczegóły przesłanego eksperymentu funkcji HyperDrive.

Ta klasa może służyć do zarządzania, sprawdzania stanu i pobierania szczegółów przebiegu dla przebiegu funkcji HyperDrive i każdego z wygenerowanych przebiegów podrzędnych.

Inicjowanie uruchomienia usługi HyperDrive.

Dziedziczenie
HyperDriveRun

Konstruktor

HyperDriveRun(experiment, run_id, hyperdrive_config=None, **kwargs)

Parametry

experiment
Experiment
Wymagane

Eksperyment dla uruchomienia usługi HyperDrive.

run_id
str
Wymagane

Identyfikator uruchomienia funkcji HyperDrive.

hyperdrive_config
HyperDriveConfig
wartość domyślna: None

Konfiguracja dla tej funkcji HyperDrive jest uruchamiana.

experiment
Experiment
Wymagane

Eksperyment dla uruchomienia usługi HyperDrive.

run_id
str
Wymagane

Identyfikator uruchomienia funkcji HyperDrive.

hyperdrive_config
HyperDriveConfig
Wymagane

Konfiguracja dla tej funkcji HyperDrive jest uruchamiana. Jeśli brak, załóżmy, że przebieg już istnieje i spróbujemy nawodnić z chmury.

Metody

cancel

Zwróć wartość True, jeśli przebieg funkcji HyperDrive został pomyślnie anulowany.

fail

Nie używaj. Metoda fail nie jest obsługiwana dla podklasy HyperDriveRun.

get_best_run_by_primary_metric

Znajdź i zwróć wystąpienie Uruchom, które odpowiada najlepszemu przebiegowi podrzędnego.

Przebieg o najlepszej wydajności jest identyfikowany wyłącznie na podstawie podstawowego parametru metryki określonego w funkcji HyperDriveConfig. Element PrimaryMetricGoal określa, czy jest używana minimalna, czy maksymalna wartość podstawowej metryki. Aby przeprowadzić bardziej szczegółową analizę wszystkich metryk ExperimentRun uruchomionych przez tę funkcję HyperDriveRun, użyj get_metrics. Zwracany jest tylko jeden z przebiegów, nawet jeśli kilka przebiegów uruchomionych przez tę metrykę funkcji HyperDrive osiągnęło tę samą najlepszą metrykę.

get_children_sorted_by_primary_metric

Zwróć listę elementów podrzędnych posortowanych według najlepszej podstawowej metryki.

Sortowanie odbywa się zgodnie z metryką podstawową i jej celem: jeśli jest zmaksymalizowana, to dzieci są zwracane w kolejności malejącej najlepszej podstawowej metryki. Jeśli odwrotnie ma wartość True, kolejność jest odwracana.

Każdy element podrzędny w wyniku ma identyfikator przebiegu, hiperparametry, najlepszą podstawową wartość metryki i stan.

Elementy podrzędne bez podstawowej metryki są odrzucane, gdy discard_no_metric ma wartość True. W przeciwnym razie są one dołączane do listy innych elementów podrzędnych z metrykami podstawowymi. Należy pamiętać, że opcja odwrotna nie ma na nie wpływu.

get_diagnostics

Nie używaj. Metoda get_diagnostics nie jest obsługiwana dla podklasy HyperDriveRun.

get_hyperparameters

Zwróć hiperparametry dla wszystkich przebiegów podrzędnych, które zostały uruchomione przez tę funkcję HyperDriveRun.

get_metrics

Zwróć metryki ze wszystkich przebiegów uruchomionych przez tę funkcję HyperDriveRun.

cancel

Zwróć wartość True, jeśli przebieg funkcji HyperDrive został pomyślnie anulowany.

cancel()

Zwraca

Czy przebieg został pomyślnie anulowany.

Typ zwracany

fail

Nie używaj. Metoda fail nie jest obsługiwana dla podklasy HyperDriveRun.

fail()

Wyjątki

get_best_run_by_primary_metric

Znajdź i zwróć wystąpienie Uruchom, które odpowiada najlepszemu przebiegowi podrzędnego.

Przebieg o najlepszej wydajności jest identyfikowany wyłącznie na podstawie podstawowego parametru metryki określonego w funkcji HyperDriveConfig. Element PrimaryMetricGoal określa, czy jest używana minimalna, czy maksymalna wartość podstawowej metryki. Aby przeprowadzić bardziej szczegółową analizę wszystkich metryk ExperimentRun uruchomionych przez tę funkcję HyperDriveRun, użyj get_metrics. Zwracany jest tylko jeden z przebiegów, nawet jeśli kilka przebiegów uruchomionych przez tę metrykę funkcji HyperDrive osiągnęło tę samą najlepszą metrykę.

get_best_run_by_primary_metric(include_failed=True, include_canceled=True, include_resume_from_runs=True) -> Run | None

Parametry

include_failed
bool
wartość domyślna: True

Określa, czy należy uwzględnić przebiegi w trybie failed.

include_canceled
bool
wartość domyślna: True

Czy uwzględnić anulowane przebiegi.

include_resume_from_runs
bool
wartość domyślna: True

Określa, czy dołączać dziedziczone resume_from działa.

Zwraca

Najlepszy przebieg lub Brak, jeśli żaden element podrzędny nie ma podstawowej metryki.

Typ zwracany

Run

get_children_sorted_by_primary_metric

Zwróć listę elementów podrzędnych posortowanych według najlepszej podstawowej metryki.

Sortowanie odbywa się zgodnie z metryką podstawową i jej celem: jeśli jest zmaksymalizowana, to dzieci są zwracane w kolejności malejącej najlepszej podstawowej metryki. Jeśli odwrotnie ma wartość True, kolejność jest odwracana.

Każdy element podrzędny w wyniku ma identyfikator przebiegu, hiperparametry, najlepszą podstawową wartość metryki i stan.

Elementy podrzędne bez podstawowej metryki są odrzucane, gdy discard_no_metric ma wartość True. W przeciwnym razie są one dołączane do listy innych elementów podrzędnych z metrykami podstawowymi. Należy pamiętać, że opcja odwrotna nie ma na nie wpływu.

get_children_sorted_by_primary_metric(top=0, reverse=False, discard_no_metric=False)

Parametry

top
int
wartość domyślna: 0

Liczba najczęściej zwracanych elementów podrzędnych. Jeśli ma wartość 0, zostaną zwrócone wszystkie dzieci.

reverse
bool
wartość domyślna: False

Jeśli ma wartość True, kolejność zostanie odwrócona. Ma to wpływ tylko na elementy podrzędne z metrykami podstawowymi.

discard_no_metric
bool
wartość domyślna: False

Jeśli ma wartość False, elementy podrzędne bez podstawowej metryki zostaną dołączone do listy.

Zwraca

Lista słowników z identyfikatorem przebiegu, hiperparametrami, najlepszą metrykami podstawowymi i stanem

Typ zwracany

get_diagnostics

Nie używaj. Metoda get_diagnostics nie jest obsługiwana dla podklasy HyperDriveRun.

get_diagnostics()

Wyjątki

get_hyperparameters

Zwróć hiperparametry dla wszystkich przebiegów podrzędnych, które zostały uruchomione przez tę funkcję HyperDriveRun.

get_hyperparameters()

Zwraca

Hiperparametry dla wszystkich przebiegów podrzędnych. Jest to słownik z run_id jako klucz.

Typ zwracany

get_metrics

Zwróć metryki ze wszystkich przebiegów uruchomionych przez tę funkcję HyperDriveRun.

get_metrics()

Zwraca

Metryki dla wszystkich elementów podrzędnych tego przebiegu.

Typ zwracany

Atrybuty

hyperdrive_config

Zwróć konfigurację uruchamiania funkcji hyperdrive.

Zwraca

Konfiguracja uruchamiania funkcji hyperdrive.

Typ zwracany

HYPER_DRIVE_RUN_USER_AGENT

HYPER_DRIVE_RUN_USER_AGENT = 'sdk_run_hyper_drive'

RUN_TYPE

RUN_TYPE = 'hyperdrive'