Freigeben über


HyperDriveConfig Klasse

Konfiguration, die eine HyperDrive-Ausführung definiert.

Die HyperDrive-Konfiguration enthält Informationen zum Sampling des Hyperparameterraums, zur Beendigungsrichtlinie, zur primären Metrik, zum Fortsetzen aus der Konfiguration, zum Schätzen und zum Ausführen des Experiments.

Initialisieren Sie 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)

Parameter

Name Beschreibung
estimator

Eine Schätzung, die mit stichprobenierten Hyperparametern aufgerufen wird. Geben Sie nur einen der folgenden Parameter an: estimator, , run_config, oder pipeline.

Standardwert: None
hyperparameter_sampling
Erforderlich

Der Hyperparameter-Samplingbereich.

policy

Die zu verwendende Richtlinie für vorzeitige Beendigung. Wenn keine – der Standardwert, wird keine Richtlinie für vorzeitige Beendigungen verwendet.

MedianStoppingPolicy Mit delay_evaluation 5 ist eine gute Kündigungsrichtlinie zu beginnen. Dies sind konservative Einstellungen, die 25%-35% Einsparungen ohne Verlust an primärer Metrik (basierend auf unseren Auswertungsdaten) bereitstellen können.

Standardwert: None
primary_metric_name
Erforderlich
str

Der Name der primären Metrik, die vom Experiment gemeldet wird.

primary_metric_goal
Erforderlich

Entweder PrimaryMetricGoal.MINIMIZE oder PrimaryMetricGoal.MAXIMIZE. Dieser Parameter bestimmt, ob die primäre Metrik bei der Auswertung minimiert oder maximiert werden soll.

max_total_runs
Erforderlich
int

Die maximale Gesamtanzahl der zu erstellenden Läufe. Dies ist die obere Grenze; Es kann weniger Läufe geben, wenn der Beispielbereich kleiner als dieser Wert ist. Wenn sowohl max_total_runs als auch max_duration_minutes angegeben werden, wird das Experiment zur Hyperparameteroptimierung beim Erreichen des ersten dieser beiden Schwellenwerte beendet.

max_concurrent_runs
int

Die maximale Anzahl von Ausführungsläufen, die gleichzeitig ausgeführt werden sollen. Wenn keine, werden alle Läufe 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 über die verfügbaren Ressourcen für die gewünschte Parallelität verfügt.

Standardwert: None
max_duration_minutes
int

Die maximale Dauer der HyperDrive-Ausführung. Sobald diese Zeit überschritten wurde, werden alle ausgeführten Ausführungen abgebrochen. Wenn sowohl max_total_runs als auch max_duration_minutes angegeben werden, wird das Experiment zur Hyperparameteroptimierung beim Erreichen des ersten dieser beiden Schwellenwerte beendet.

Standardwert: 10080
resume_from

Eine Hyperdrive-Ausführung oder eine Liste von Hyperdrive-Ausführungen, die als Datenpunkte geerbt werden, um die neue Ausführung zu starten.

Standardwert: None
resume_child_runs
Run oder list[Run]

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

Standardwert: None
run_config

Ein Objekt zum Einrichten der Konfiguration für Skript/Notizbuch wird ausgeführt. Geben Sie nur einen der folgenden Parameter an: estimator, , run_config, oder pipeline.

Standardwert: None
pipeline

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

Standardwert: None
custom_run_id
str

Vom Benutzer bereitgestellte benutzerdefinierte Run-ID

Standardwert: None
hyperparameter_sampling
Erforderlich

Die Hyperparameter-Raumsamplingdefinition.

primary_metric_name
Erforderlich
str

Der Name der primären Metrik, die vom Experiment gemeldet wird.

primary_metric_goal
Erforderlich

Entweder PrimaryMetricGoal.MINIMIZE oder PrimaryMetricGoal.MAXIMIZE. Dieser Parameter bestimmt, ob die primäre Metrik bei der Auswertung minimiert oder maximiert werden soll.

max_total_runs
Erforderlich
int

Die maximale Gesamtanzahl der zu erstellenden Läufe. Dies ist die obere Grenze; Es kann weniger Läufe geben, wenn der Beispielbereich kleiner als dieser Wert ist.

max_concurrent_runs
Erforderlich
int

Die maximale Anzahl von Ausführungsläufen, die gleichzeitig ausgeführt werden sollen. Wenn keine, werden alle Läufe parallel gestartet.

max_duration_minutes
Erforderlich
int

Die maximale Dauer der HyperDrive-Ausführung. Sobald diese Zeit überschritten wurde, werden alle ausgeführten Ausführungen abgebrochen.

policy
Erforderlich

Die zu verwendende Richtlinie für vorzeitige Beendigung. Wenn keine – der Standardwert, wird keine Richtlinie für vorzeitige Beendigungen verwendet.

<xref:azureml.train.hyperdrive.MedianTerminationPolicy> Mit delay_evaluation 5 ist eine gute Kündigungsrichtlinie zu beginnen. Dies sind konservative Einstellungen, die 25%-35% Einsparungen ohne Verlust an primärer Metrik (basierend auf unseren Auswertungsdaten) bereitstellen können.

estimator
Erforderlich

Eine Schätzung, die mit beispielierten Hyperparametern aufgerufen wird. Geben Sie nur einen der folgenden Parameter an: estimator, , run_config, oder pipeline.

run_config
Erforderlich

Ein Objekt zum Einrichten der Konfiguration für Skript/Notizbuch wird ausgeführt. Geben Sie nur 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 die neue Ausführung zu starten.

resume_child_runs
Erforderlich
Run | list[Run]

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

pipeline
Erforderlich

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

custom_run_id
Erforderlich
str

Vom Benutzer bereitgestellte benutzerdefinierte Run-ID

debug_flag
Standardwert: None

Hinweise

Das folgende Beispiel zeigt das Erstellen eines HyperDriveConfig-Objekts, das für hyperparameter-Tunning verwendet werden soll. Im Beispiel entspricht der primäre Metrikname einem Wert, der im Schulungsskript protokolliert wird.


   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 Lernprogramm "Optimieren von Hyperparametern für Ihr Modell".

Attribute

estimator

Gibt den Schätzer zurück, der in der HyperDrive-Ausführung verwendet wird.

Der Wert ist "None", wenn die Ausführung eine Skriptausführungskonfiguration oder eine Pipeline verwendet.

Gibt zurück

Typ Beschreibung

Der Schätzer.

pipeline

Gibt die pipeline zurück, die in der HyperDrive-Ausführung verwendet wird.

Der Wert ist "None", wenn die Ausführung eine Skriptausführungskonfiguration oder -schätzung verwendet.

Gibt zurück

Typ Beschreibung

Die Pipeline.

run_config

Gibt die Skript-/Notizbuchkonfiguration zurück, die in der HyperDrive-Ausführung verwendet wird.

Der Wert ist "None", wenn die Ausführung einen Schätzwert oder eine Pipeline verwendet.

Gibt zurück

Typ Beschreibung

Die Ausführungskonfiguration.

source_directory

Gibt das Quellverzeichnis aus der auszuführenden Konfiguration zurück.

Gibt zurück

Typ Beschreibung
str

Das Quellverzeichnis