HyperDriveConfig Klasse
Konfiguration, die eine Hyperdrive-Ausführung definiert.
Die HyperDrive-Konfiguration enthält Informationen zur Stichprobenentnahme für den Hyperparameterbereich, zur Beendigungsrichtlinie, zur primären Metrik, zum Fortsetzen anhand der Konfiguration, zum Schätzer und zum Computeziel für die Ausführung des Experiments.
Initialisieren Sie hyperDriveConfig.
- Vererbung
-
builtins.objectHyperDriveConfig
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)Parameter
| Name | Beschreibung |
|---|---|
|
estimator
|
Ein Schätzer, der mit stichprobenbasierten Hyperparametern aufgerufen wird.
Geben Sie zusätzlich einen der folgenden Parameter an: Standardwert: None
|
|
hyperparameter_sampling
Erforderlich
|
Der Raum für die Hyperparameter-Stichprobenentnahme. |
|
policy
|
Die zu verwendende Richtlinie für vorzeitige Beendigung. Bei Verwendung der Standardeinstellung „None“ wird keine Richtlinie für die vorzeitige Beendigung verwendet. Die MedianStoppingPolicy mit Standardwert: None
|
|
primary_metric_name
Erforderlich
|
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
|
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.
Wenn sowohl |
|
max_concurrent_runs
|
Die maximale Anzahl von Ausführungen, die gleichzeitig ausgeführt werden können. Bei „None“ werden alle Ausführungen parallel gestartet. Die Anzahl der gleichzeitigen Läufe wird durch die im angegebenen Computeziel verfügbaren Ressourcen beschränkt. Daher müssen Sie sicherstellen, dass das Computeziel die verfügbaren Ressourcen für die gewünschte Parallelität aufweist. Standardwert: None
|
|
max_duration_minutes
|
Die maximale Dauer der HyperDrive-Ausführung. Sobald diese Zeit überschritten wird, werden alle noch aktiven Ausführungen abgebrochen. Wenn sowohl Standardwert: 10080
|
|
resume_from
|
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. Standardwert: None
|
|
resume_child_runs
|
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. Standardwert: None
|
|
run_config
|
Ein Objekt zum Einrichten der Konfiguration für Skript-/Notebookausführungen.
Geben Sie zusätzlich einen der folgenden Parameter an: Standardwert: None
|
|
pipeline
|
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: Standardwert: None
|
|
custom_run_id
|
Vom Benutzer bereitgestellte benutzerdefinierte Ausführungs-ID Standardwert: None
|
|
hyperparameter_sampling
Erforderlich
|
Die Definition des Hyperparameterraums für die Stichprobenentnahme. |
|
primary_metric_name
Erforderlich
|
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
|
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
|
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
|
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 |
|
estimator
Erforderlich
|
Ein Schätzer, der mit Stichproben-Hyperparametern aufgerufen wird.
Geben Sie zusätzlich einen der folgenden Parameter an: |
|
run_config
Erforderlich
|
Ein Objekt zum Einrichten der Konfiguration für Skript-/Notebookausführungen.
Geben Sie zusätzlich einen der folgenden Parameter an: |
|
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
|
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: |
|
custom_run_id
Erforderlich
|
Vom Benutzer bereitgestellte benutzerdefinierte Ausführungs-ID |
|
debug_flag
|
Standardwert: None
|
Hinweise
Das folgende Beispiel veranschaulicht das Erstellen eines HyperDriveConfig-Objekts für die Hyperparameteroptimierung. Im Beispiel stimmt der Name der primären Metrik mit einem im Trainingsskript protokollierten Wert überein.
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)
Weitere Informationen zum Arbeiten mit HyperDriveConfig finden Sie im Tutorial Optimieren von Hyperparametern für Ihr Modell.
Attribute
estimator
Dient zum Zurückgeben des in der HyperDrive-Ausführung verwendeten Schätzers.
Der Wert ist „None“, wenn die Ausführung eine Skriptlaufzeitkonfiguration oder eine Pipeline verwendet.
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Der Schätzer. |
pipeline
Dient zum Zurückgeben der in der HyperDrive-Ausführung verwendeten Pipeline.
Der Wert ist „None“, wenn die Ausführung eine Skriptlaufzeitkonfiguration oder einen Schätzer verwendet.
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Die Pipeline. |
run_config
Dient zum Zurückgeben der in der HyperDrive-Ausführung verwendeten Skript-/Notebookkonfiguration.
Der Wert ist „None“, wenn die Ausführung einen Schätzer oder eine Pipeline verwendet.
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Die Laufzeitkonfiguration. |
source_directory
Dient zum Zurückgeben des Quellverzeichnisses der auszuführenden Konfiguration.
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Das Quellverzeichnis. |