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

Name	Description
estimator	MMLBaseEstimator Een estimator die wordt aangeroepen met steekproef hyperparameters. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline. Default value: None
hyperparameter_sampling Vereist	HyperParameterSampling De steekproefruimte van de hyperparameter.
policy	EarlyTerminationPolicy 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). Default value: None
primary_metric_name Vereist	str De naam van de primaire metrische gegevens die door het experiment worden gerapporteerd.
primary_metric_goal Vereist	PrimaryMetricGoal 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 Vereist	int 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 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. Default value: None
max_duration_minutes	int 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. Default value: 10080
resume_from	HyperDriveRun of list[HyperDriveRun] Een hyperdrive-uitvoering of een lijst met hyperdrive-uitvoeringen die worden overgenomen als gegevens die erop wijst om de nieuwe uitvoering warm te starten. Default value: None
resume_child_runs	Run of list[Run] Een onderliggende hyperdrive-uitvoering of een lijst met onderliggende hyperdrive-uitvoeringen die worden hervat als nieuwe onderliggende uitvoeringen van de nieuwe hyperdrive-uitvoering. Default value: None
run_config	ScriptRunConfig 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. Default value: None
pipeline	Pipeline 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. Default value: None
custom_run_id	str Aangepaste uitvoerings-id opgegeven door de gebruiker Default value: None
hyperparameter_sampling Vereist	HyperParameterSampling De definitie van de steekproef van de hyperparameterruimte.
primary_metric_name Vereist	str De naam van de primaire metrische gegevens die door het experiment worden gerapporteerd.
primary_metric_goal Vereist	PrimaryMetricGoal 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 Vereist	int 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 Vereist	int Het maximum aantal uitvoeringen dat gelijktijdig moet worden uitgevoerd. Bij Geen worden alle uitvoeringen parallel gestart.
max_duration_minutes Vereist	int De maximale duur van de HyperDrive-uitvoering. Zodra deze tijd is overschreden, worden alle uitvoeringen die nog worden uitgevoerd, geannuleerd.
policy Vereist	EarlyTerminationPolicy 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 Vereist	MMLBaseEstimator Een estimator die wordt aangeroepen met hyperparameters met steekproefsgetalden. Geef slechts een van de volgende parameters op: estimator, run_configof pipeline.
run_config Vereist	ScriptRunConfig 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 Vereist	HyperDriveRun | list[HyperDriveRun] 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 Vereist	Run | list[Run] Een onderliggende hyperdrive-uitvoering of een lijst met onderliggende hyperdrive-uitvoeringen die worden hervat als nieuwe onderliggende uitvoeringen van de nieuwe hyperdrive-uitvoering.
pipeline Vereist	Pipeline 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 Vereist	str Aangepaste uitvoerings-id opgegeven door de gebruiker
debug_flag	Default value: 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

Type	Description
Estimator, None	De schatter.

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

Type	Description
Pipeline, None	De pijplijn.

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

Type	Description
ScriptRunConfig, None	De uitvoeringsconfiguratie.

source_directory

Retourneer de bronmap vanuit de configuratie die moet worden uitgevoerd.

Retouren

Type	Description
str	De bronmap