Freigeben über


HyperDriveRunConfig Klasse

Konfiguration, die eine HyperDrive-Ausführung definiert.

Die Konfiguration enthält Informationen zur Stichprobenentnahme für den Parameterbereich, zur Beendigungsrichtlinie, der primären Metrik, zum Schätzer und zum Computeziel für die Ausführung des Experiments.

Initialisieren Sie hyperDriveConfig.

Vererbung
azureml.train.hyperdrive.runconfig.HyperDriveConfig
HyperDriveRunConfig

Konstruktor

HyperDriveRunConfig(estimator, hyperparameter_sampling, primary_metric_name, primary_metric_goal, max_total_runs, max_concurrent_runs=None, max_duration_minutes=10080, policy=None)

Parameter

Name Beschreibung
hyperparameter_sampling
Erforderlich

Der Raum für die Hyperparameter-Stichprobenentnahme.

primary_metric_name
Erforderlich
str

Der Name der primären Metrik, die von den Experimentausführungen gemeldet wird.

primary_metric_goal
Erforderlich

Maximierung oder Minimierung. Bestimmt, ob die primäre Metrik in der Auswertung der Experimentausführungen minimiert/maximiert werden muss.

max_total_runs
Erforderlich
int

Die maximale Anzahl von Ausführungen. Dies ist die Obergrenze. Es kann weniger Ausführungen geben, wenn der Stichprobenraum kleiner als dieser Wert ist.

max_concurrent_runs
int

Maximale Anzahl von Ausführungen, die gleichzeitig ausgeführt werden können. Bei „None“ werden alle Ausführungen parallel gestartet.

Standardwert: None
max_duration_minutes
int

Die maximale Dauer der HyperDrive-Ausführung. Bei Überschreitung dieser Zeit wird die Ausführung abgebrochen. Die maximale Dauer der untergeordneten Ausführungen kann mit dem ScriptRunConfig-Argument „max_run_duration_seconds“ festgelegt werden.

Standardwert: 10080
policy

Die zu verwendende Richtlinie für vorzeitige Beendigung. Wenn None als Standardeinstellung festgelegt ist, wird keine Richtlinie für die vorzeitige Beendigung verwendet. MedianTerminationPolicy mit delay_evaluation 5 ist eine gute Beendigungsrichtlinie für den Anfang. Dies sind konservative Einstellungen, die annähernd 25%–35% Ersparnis ohne Verluste bei der primären Metrik erbringen kann (bezogen auf unsere Auswertungsdaten).

Standardwert: None
estimator
Erforderlich

Ein Schätzer, der mit Stichproben-Hyperparametern aufgerufen wird.

run_config
Erforderlich

Ein Objekt zum Einrichten der Konfiguration für Skript-/Notebook-Ausführungen. Geben Sie zusätzlich einen der folgenden Parameter an: estimator, run_config oder pipeline.

resume_from
Erforderlich

Eine Hyperdrive-Ausführung oder eine Liste von Hyperdrive-Ausführungen, die als Datenpunkte geerbt werden, um einen Warmstart der neuen Ausführung zu ermöglichen.

resume_child_runs
Erforderlich
Run oder list[Run]

Eine untergeordnete Hyperdrive-Ausführung oder eine Liste untergeordneter Hyperdrive-Ausführungen, die als neue untergeordnete Ausführungen der neuen Hyperdrive-Ausführung fortgesetzt werden.

pipeline
Erforderlich

Ein Pipelineobjekt zum Einrichten der Konfiguration für Pipelineausführungen. Das Pipeline-Objekt wird mit den Stichproben-Hyperparametern aufgerufen, um Pipelineausführungen zu übermitteln. Geben Sie zusätzlich einen der folgenden Parameter an: estimator, run_config oder pipeline.

hyperparameter_sampling
Erforderlich

Die Definition des Hyperparameterraums für die Stichprobenentnahme.

primary_metric_name
Erforderlich
str

Der Name der primären Metrik, die von den Experimentausführungen gemeldet wird.

primary_metric_goal
Erforderlich

Entweder „PrimaryMetricGoal.MINIMIZE“ oder „PrimaryMetricGoal.MAXIMIZE“. Dieser Parameter bestimmt, ob die primäre Metrik beim Auswerten von Ausführungen minimiert oder maximiert werden soll.

max_total_runs
Erforderlich
int

Die maximale Gesamtanzahl zu erstellender Ausführungen. Dies ist die Obergrenze. Es kann weniger Ausführungen geben, wenn der Stichprobenraum kleiner als dieser Wert ist.

max_concurrent_runs
Erforderlich
int

Die maximale Anzahl von Ausführungen, die gleichzeitig ausgeführt werden können. Bei „None“ werden alle Ausführungen parallel gestartet.

max_duration_minutes
Erforderlich
int

Die maximale Dauer der HyperDrive-Ausführung. Sobald diese Zeit überschritten wird, werden alle noch aktiven Ausführungen abgebrochen.

policy
Erforderlich

Die zu verwendende Richtlinie für vorzeitige Beendigung. Bei Verwendung der Standardeinstellung „None“ wird keine Richtlinie für die vorzeitige Beendigung verwendet.

Die <xref:azureml.train.hyperdrive.MedianTerminationPolicy> mit delay_evaluation 5 ist eine gute Beendigungsrichtlinie, mit der Sie beginnen können. Dies sind konservative Einstellungen, die annähernd 25 – 35 Prozent Ersparnis ohne Verluste bei der primären Metrik erbringen können (basierend auf unseren Auswertungsdaten).

estimator
Erforderlich

Ein Schätzer, der mit Stichproben-Hyperparametern aufgerufen wird. Geben Sie zusätzlich einen der folgenden Parameter an: estimator, run_config oder pipeline.

run_config
Erforderlich

Ein Objekt zum Einrichten der Konfiguration für Skript-/Notebookausführungen. Geben Sie zusätzlich einen der folgenden Parameter an: estimator, run_config oder pipeline.

resume_from
Erforderlich

Eine Hyperdrive-Ausführung oder eine Liste von Hyperdrive-Ausführungen, die als Datenpunkte geerbt werden, um einen Warmstart der neuen Ausführung zu ermöglichen.

resume_child_runs
Erforderlich
Run | list[Run]

Eine untergeordnete Hyperdrive-Ausführung oder eine Liste untergeordneter Hyperdrive-Ausführungen, die als neue untergeordnete Ausführungen der neuen Hyperdrive-Ausführung fortgesetzt werden.

pipeline
Erforderlich

Ein Pipelineobjekt zum Einrichten der Konfiguration für Pipelineausführungen. Das Pipeline-Objekt wird mit den Stichproben-Hyperparametern aufgerufen, um Pipelineausführungen zu übermitteln. Geben Sie zusätzlich einen der folgenden Parameter an: estimator, run_config oder pipeline.

custom_run_id
Erforderlich
str

Vom Benutzer bereitgestellte benutzerdefinierte Ausführungs-ID