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.objectHyperDriveConfig
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
Een estimator die wordt aangeroepen met steekproef hyperparameters.
Geef slechts een van de volgende parameters op: estimator
, run_config
of pipeline
.
- 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).
- primary_metric_name
- str
De naam van de primaire metrische gegevens die door het experiment worden gerapporteerd.
- primary_metric_goal
- 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
- 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.
- 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.
- 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.
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
Een object voor het instellen van de configuratie voor script/notebook wordt uitgevoerd.
Geef slechts een van de volgende parameters op: estimator
, run_config
of pipeline
.
- 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_config
of pipeline
.
- hyperparameter_sampling
- HyperParameterSampling
De definitie van de steekproef van de hyperparameterruimte.
- primary_metric_name
- str
De naam van de primaire metrische gegevens die door het experiment worden gerapporteerd.
- primary_metric_goal
- 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
- 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
- int
Het maximum aantal uitvoeringen dat gelijktijdig moet worden uitgevoerd. Bij Geen worden alle uitvoeringen parallel gestart.
- max_duration_minutes
- int
De maximale duur van de HyperDrive-uitvoering. Zodra deze tijd is overschreden, worden alle uitvoeringen die nog worden uitgevoerd, geannuleerd.
- 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 <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
Een estimator die wordt aangeroepen met hyperparameters met steekproefsgetalden.
Geef slechts een van de volgende parameters op: estimator
, run_config
of pipeline
.
- 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_config
of pipeline
.
- resume_from
- 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.
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
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_config
of pipeline
.
- debug_flag
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
Feedback
https://aka.ms/ContentUserFeedback voor meer informatie.
Binnenkort beschikbaar: in de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. ZieFeedback verzenden en weergeven voor