HyperDriveConfig Klas

Configuratie die een HyperDrive-uitvoering definieert.

HyperDrive-configuratie bevat informatie over het nemen van hyperparameters, beëindigingsbeleid, primaire metrische gegevens, hervatten van configuratie, estimator en het rekendoel waarop het experiment moet worden uitgevoerd.

Initialiseer de HyperDriveConfig.

Overname
builtins.object
HyperDriveConfig

Constructor

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)

Parameters

estimator
MMLBaseEstimator
standaardwaarde: None

Een estimator die wordt aangeroepen met steekproef hyperparameters. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.

hyperparameter_sampling
HyperParameterSampling
Vereist

De steekproefruimte van de hyperparameter.

policy
EarlyTerminationPolicy
standaardwaarde: None

Het beleid voor vroegtijdige beëindiging dat moet worden gebruikt. Indien Geen: de standaardinstelling, wordt geen beleid voor vroegtijdige beëindiging gebruikt.

De MedianStoppingPolicy met delay_evaluation van 5 is een goed beëindigingsbeleid om mee te beginnen. Dit zijn conservatieve instellingen, die 25%-35% besparingen kunnen bieden zonder verlies op primaire metrische gegevens (op basis van onze evaluatiegegevens).

primary_metric_name
str
Vereist

De naam van de primaire metrische gegevens die door het experiment worden gerapporteerd.

primary_metric_goal
PrimaryMetricGoal
Vereist

PrimaryMetricGoal.MINIMIZE of PrimaryMetricGoal.MAXIMIZE. Deze parameter bepaalt of de primaire metrische waarde moet worden geminimaliseerd of gemaximaliseerd bij het evalueren van uitvoeringen.

max_total_runs
int
Vereist

Het maximum aantal uitvoeringen dat moet worden gemaakt. Dit is de bovengrens; er kunnen minder uitvoeringen zijn wanneer de voorbeeldruimte kleiner is dan deze waarde. Als zowel max_total_runs als max_duration_minutes zijn opgegeven, wordt het hyperparameterafstemmingsexperiment beëindigd wanneer de eerste van deze twee drempelwaarden is bereikt.

max_concurrent_runs
int
standaardwaarde: None

Het maximum aantal uitvoeringen dat gelijktijdig moet worden uitgevoerd. Bij Geen worden alle uitvoeringen parallel gestart. Het aantal gelijktijdige uitvoeringen is afhankelijk van de resources die beschikbaar zijn in het opgegeven rekendoel. Daarom moet u ervoor zorgen dat het rekendoel de beschikbare resources heeft voor de gewenste gelijktijdigheid.

max_duration_minutes
int
standaardwaarde: 10080

De maximale duur van de HyperDrive-uitvoering. Zodra deze tijd is overschreden, worden alle uitvoeringen die nog worden uitgevoerd, geannuleerd. Als zowel max_total_runs als max_duration_minutes zijn opgegeven, wordt het hyperparameterafstemmingsexperiment beëindigd wanneer de eerste van deze twee drempelwaarden is bereikt.

resume_from
HyperDriveRun of list[HyperDriveRun]
standaardwaarde: None

Een hyperdrive-uitvoering of een lijst met hyperdrive-uitvoeringen die worden overgenomen als gegevens die erop wijst om de nieuwe uitvoering warm te starten.

resume_child_runs
Run of list[Run]
standaardwaarde: None

Een onderliggende hyperdrive-uitvoering of een lijst met onderliggende hyperdrive-uitvoeringen die worden hervat als nieuwe onderliggende uitvoeringen van de nieuwe hyperdrive-uitvoering.

run_config
ScriptRunConfig
standaardwaarde: None

Een object voor het instellen van de configuratie voor script/notebook wordt uitgevoerd. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.

pipeline
Pipeline
standaardwaarde: None

Een pijplijnobject voor het instellen van configuratie voor pijplijnuitvoeringen. Het pijplijnobject wordt aangeroepen met de voorbeeldhyperparameters om pijplijnuitvoeringen te verzenden. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.

custom_run_id
str
standaardwaarde: None

Aangepaste uitvoerings-id opgegeven door de gebruiker

hyperparameter_sampling
HyperParameterSampling
Vereist

De definitie van de steekproef van de hyperparameterruimte.

primary_metric_name
str
Vereist

De naam van de primaire metrische gegevens die door het experiment worden gerapporteerd.

primary_metric_goal
PrimaryMetricGoal
Vereist

PrimaryMetricGoal.MINIMIZE of PrimaryMetricGoal.MAXIMIZE. Deze parameter bepaalt of de primaire metrische waarde moet worden geminimaliseerd of gemaximaliseerd bij het evalueren van uitvoeringen.

max_total_runs
int
Vereist

Het maximum aantal uitvoeringen dat moet worden gemaakt. Dit is de bovengrens; er kunnen minder uitvoeringen zijn wanneer de voorbeeldruimte kleiner is dan deze waarde.

max_concurrent_runs
int
Vereist

Het maximum aantal uitvoeringen dat gelijktijdig moet worden uitgevoerd. Bij Geen worden alle uitvoeringen parallel gestart.

max_duration_minutes
int
Vereist

De maximale duur van de HyperDrive-uitvoering. Zodra deze tijd is overschreden, worden alle uitvoeringen die nog worden uitgevoerd, geannuleerd.

policy
EarlyTerminationPolicy
Vereist

Het beleid voor vroegtijdige beëindiging dat moet worden gebruikt. Indien Geen: de standaardinstelling, wordt geen beleid voor vroegtijdige beëindiging gebruikt.

De <xref:azureml.train.hyperdrive.MedianTerminationPolicy> met delay_evaluation van 5 is een goed beëindigingsbeleid om mee te beginnen. Dit zijn conservatieve instellingen, die 25%-35% besparingen kunnen bieden zonder verlies op primaire metrische gegevens (op basis van onze evaluatiegegevens).

estimator
MMLBaseEstimator
Vereist

Een estimator die wordt aangeroepen met hyperparameters met steekproefsgetalden. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.

run_config
ScriptRunConfig
Vereist

Een object voor het instellen van de configuratie voor script/notebook wordt uitgevoerd. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.

resume_from
HyperDriveRun | list[HyperDriveRun]
Vereist

Een hyperdrive-uitvoering of een lijst met hyperdrive-uitvoeringen die worden overgenomen als gegevens die erop wijst om de nieuwe uitvoering warm te starten.

resume_child_runs
Run | list[Run]
Vereist

Een onderliggende hyperdrive-uitvoering of een lijst met onderliggende hyperdrive-uitvoeringen die worden hervat als nieuwe onderliggende uitvoeringen van de nieuwe hyperdrive-uitvoering.

pipeline
Pipeline
Vereist

Een pijplijnobject voor het instellen van configuratie voor pijplijnuitvoeringen. Het pijplijnobject wordt aangeroepen met de voorbeeldhyperparameters om pijplijnuitvoeringen te verzenden. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.

custom_run_id
str
Vereist

Aangepaste uitvoerings-id opgegeven door de gebruiker

debug_flag
standaardwaarde: None

Opmerkingen

In het onderstaande voorbeeld ziet u hoe u een HyperDriveConfig-object maakt dat moet worden gebruikt voor hyperparameter tunning. In het voorbeeld komt de primaire metrische naam overeen met een waarde die is vastgelegd in het trainingsscript.


   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)

Zie de zelfstudie Hyperparameters afstemmen voor uw model voor meer informatie over het werken met HyperDriveConfig.

Kenmerken

estimator

Retourneer de estimator die is gebruikt in de HyperDrive-uitvoering.

De waarde is Geen als de uitvoering gebruikmaakt van een scriptuitvoeringsconfiguratie of een pijplijn.

Retouren

De schatter.

Retourtype

pipeline

Retourneer de pijplijn die is gebruikt in de HyperDrive-uitvoering.

De waarde is Geen als de uitvoering gebruikmaakt van een scriptuitvoeringsconfiguratie of estimator.

Retouren

De pijplijn.

Retourtype

run_config

Retourneer de script-/notebookconfiguratie die is gebruikt in de HyperDrive-uitvoering.

De waarde is Geen als de uitvoering gebruikmaakt van een estimator of pijplijn.

Retouren

De uitvoeringsconfiguratie.

Retourtype

source_directory

Retourneer de bronmap vanuit de configuratie die moet worden uitgevoerd.

Retouren

De bronmap

Retourtype

str