HyperDriveConfig Klasa

Konfiguracja definiująca przebieg funkcji HyperDrive.

Konfiguracja funkcji HyperDrive zawiera informacje o próbkowaniu przestrzeni hiperparametrowej, zasadach zakończenia, podstawowej metryce, wznawianiu konfiguracji, narzędzia do szacowania i celu obliczeniowego do wykonania przebiegów eksperymentu.

Zainicjuj konfigurację funkcji HyperDrive.

Dziedziczenie

builtins.object

HyperDriveConfig

Konstruktor

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)

Parametry

Nazwa	Opis
estimator	MMLBaseEstimator Narzędzie do szacowania, które zostanie wywołane za pomocą przykładowych hiperparametrów. Określ tylko jeden z następujących parametrów: estimator, run_configlub pipeline. Domyślna wartość: None
hyperparameter_sampling Wymagane	HyperParameterSampling Przestrzeń próbkowania hiperparametrów.
policy	EarlyTerminationPolicy Zasady wczesnego zakończenia do użycia. Jeśli brak — ustawienie domyślne, nie będą używane żadne zasady wczesnego zakończenia. Wartość MedianStoppingPolicy z delay_evaluation 5 jest dobrymi zasadami kończenia, od których należy zacząć. Są to konserwatywne ustawienia, które mogą zapewnić 25%-35% oszczędności bez utraty podstawowej metryki (na podstawie naszych danych ewaluacyjnych). Domyślna wartość: None
primary_metric_name Wymagane	str Nazwa metryki podstawowej zgłoszonej przez przebiegi eksperymentu.
primary_metric_goal Wymagane	PrimaryMetricGoal PrimaryMetricGoal.MINIMAL lub PrimaryMetricGoal.MAXIMIZE. Ten parametr określa, czy podstawowa metryka ma być zminimalizowana lub zmaksymalizowana podczas oceniania przebiegów.
max_total_runs Wymagane	int Maksymalna łączna liczba przebiegów do utworzenia. Jest to górna granica; może istnieć mniej przebiegów, gdy miejsce próbki jest mniejsze niż ta wartość. Jeśli zostanie określony i max_total_runsmax_duration_minutes zostanie określony, eksperyment dostrajania hiperparametrów zakończy się po osiągnięciu pierwszego z tych dwóch progów.
max_concurrent_runs	int Maksymalna liczba przebiegów do wykonania współbieżnie. Jeśli brak, wszystkie uruchomienia są uruchamiane równolegle. Liczba współbieżnych przebiegów jest bramowana na zasobach dostępnych w określonym obiekcie docelowym obliczeniowym. W związku z tym należy upewnić się, że docelowy obiekt obliczeniowy ma dostępne zasoby dla żądanej współbieżności. Domyślna wartość: None
max_duration_minutes	int Maksymalny czas trwania przebiegu funkcji HyperDrive. Po przekroczeniu tego czasu wszystkie uruchomienia nadal wykonywane są anulowane. Jeśli zostanie określony i max_total_runsmax_duration_minutes zostanie określony, eksperyment dostrajania hiperparametrów zakończy się po osiągnięciu pierwszego z tych dwóch progów. Domyślna wartość: 10080
resume_from	HyperDriveRun lub list[HyperDriveRun] Uruchomienie funkcji hyperdrive lub lista przebiegów funkcji hyperdrive, które będą dziedziczone jako punkty danych w celu ciepłego uruchomienia nowego uruchomienia. Domyślna wartość: None
resume_child_runs	Run lub list[Run] Uruchomienie podrzędne funkcji hyperdrive lub lista przebiegów podrzędnych funkcji hyperdrive, które zostaną wznowione jako nowe uruchomienia podrzędne nowego uruchomienia funkcji hyperdrive. Domyślna wartość: None
run_config	ScriptRunConfig Obiekt służą do konfigurowania konfiguracji dla przebiegów skryptów/notesów. Określ tylko jeden z następujących parametrów: estimator, run_configlub pipeline. Domyślna wartość: None
pipeline	Pipeline Obiekt potoku do konfigurowania konfiguracji dla przebiegów potoku. Obiekt potoku zostanie wywołany za pomocą przykładowych hiperparametrów do przesyłania przebiegów potoku. Określ tylko jeden z następujących parametrów: estimator, run_configlub pipeline. Domyślna wartość: None
custom_run_id	str Niestandardowy identyfikator przebiegu dostarczony przez użytkownika Domyślna wartość: None
hyperparameter_sampling Wymagane	HyperParameterSampling Definicja próbkowania przestrzeni hiperparametrowej.
primary_metric_name Wymagane	str Nazwa metryki podstawowej zgłoszonej przez przebiegi eksperymentu.
primary_metric_goal Wymagane	PrimaryMetricGoal PrimaryMetricGoal.MINIMAL lub PrimaryMetricGoal.MAXIMIZE. Ten parametr określa, czy podstawowa metryka ma być zminimalizowana lub zmaksymalizowana podczas oceniania przebiegów.
max_total_runs Wymagane	int Maksymalna łączna liczba przebiegów do utworzenia. Jest to górna granica; może istnieć mniej przebiegów, gdy miejsce próbki jest mniejsze niż ta wartość.
max_concurrent_runs Wymagane	int Maksymalna liczba przebiegów do wykonania współbieżnie. Jeśli brak, wszystkie uruchomienia są uruchamiane równolegle.
max_duration_minutes Wymagane	int Maksymalny czas trwania przebiegu funkcji HyperDrive. Po przekroczeniu tego czasu wszystkie uruchomienia nadal wykonywane są anulowane.
policy Wymagane	EarlyTerminationPolicy Zasady wczesnego zakończenia do użycia. Jeśli brak — ustawienie domyślne, nie będą używane żadne zasady wczesnego zakończenia. Wartość <xref:azureml.train.hyperdrive.MedianTerminationPolicy> z delay_evaluation 5 jest dobrymi zasadami kończenia, od których należy zacząć. Są to konserwatywne ustawienia, które mogą zapewnić 25%-35% oszczędności bez utraty podstawowej metryki (na podstawie naszych danych ewaluacyjnych).
estimator Wymagane	MMLBaseEstimator Narzędzie do szacowania, które będzie wywoływane z przykładowymi parametrami funkcji hyper. Określ tylko jeden z następujących parametrów: estimator, run_configlub pipeline.
run_config Wymagane	ScriptRunConfig Obiekt służą do konfigurowania konfiguracji dla przebiegów skryptów/notesów. Określ tylko jeden z następujących parametrów: estimator, run_configlub pipeline.
resume_from Wymagane	HyperDriveRun | list[HyperDriveRun] Uruchomienie funkcji hyperdrive lub lista przebiegów funkcji hyperdrive, które będą dziedziczone jako punkty danych w celu ciepłego uruchomienia nowego uruchomienia.
resume_child_runs Wymagane	Run | list[Run] Uruchomienie podrzędne funkcji hyperdrive lub lista przebiegów podrzędnych funkcji hyperdrive, które zostaną wznowione jako nowe uruchomienia podrzędne nowego uruchomienia funkcji hyperdrive.
pipeline Wymagane	Pipeline Obiekt potoku do konfigurowania konfiguracji dla przebiegów potoku. Obiekt potoku zostanie wywołany za pomocą przykładowych hiperparametrów do przesyłania przebiegów potoku. Określ tylko jeden z następujących parametrów: estimator, run_configlub pipeline.
custom_run_id Wymagane	str Niestandardowy identyfikator przebiegu dostarczony przez użytkownika
debug_flag	Domyślna wartość: None

Uwagi

W poniższym przykładzie pokazano tworzenie obiektu HyperDriveConfig do użycia na potrzeby uruchamiania hiperparametrów. W tym przykładzie nazwa metryki podstawowej jest zgodna z wartością zalogowaną w skrycie trenowania.

   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)

Aby uzyskać więcej informacji na temat pracy z funkcją HyperDriveConfig, zobacz samouczek Dostosowywanie hiperparametrów dla modelu.

Atrybuty

estimator

Zwróć narzędzie do szacowania używane w uruchomieniu funkcji HyperDrive.

Wartość to Brak, jeśli uruchomienie używa konfiguracji uruchomienia skryptu lub potoku.

Zwraca

Typ	Opis
Estimator, None	Narzędzie do szacowania.

pipeline

Zwróć potok używany w uruchomieniu funkcji HyperDrive.

Wartość to Brak, jeśli uruchomienie używa konfiguracji uruchomienia skryptu lub narzędzia do szacowania.

Zwraca

Typ	Opis
Pipeline, None	Potok.

run_config

Zwróć konfigurację skryptu/notesu używaną w uruchomieniu funkcji HyperDrive.

Wartość to Brak, jeśli uruchomienie używa narzędzia do szacowania lub potoku.

Zwraca

Typ	Opis
ScriptRunConfig, None	Konfiguracja uruchamiania.

source_directory

Zwróć katalog źródłowy z konfiguracji, aby go uruchomić.

Zwraca

Typ	Opis
str	Katalog źródłowy