HyperDriveConfig Klass

Konfiguration som definierar en HyperDrive-körning.

HyperDrive-konfigurationen innehåller information om sampling av hyperparameterutrymme, avslutningsprincip, primärt mått, återuppta från konfiguration, uppskattning och beräkningsmålet som experimentet körs på.

Initiera 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)

Parametrar

Name	Description
estimator	MMLBaseEstimator En skattning som anropas med exempel på hyperparametrar. Ange endast en av följande parametrar: estimator, run_configeller pipeline. Standardvärde: None
hyperparameter_sampling Obligatorisk	HyperParameterSampling Samplingsutrymmet för hyperparameter.
policy	EarlyTerminationPolicy Principen för tidig uppsägning som ska användas. Om Ingen – standardinställningen används ingen princip för tidig avslutning. Med MedianStoppingPolicydelay_evaluation 5 är en bra avslutningsprincip att börja med. Det här är konservativa inställningar som kan ge 25%-35% besparingar utan förlust på primärmått (baserat på våra utvärderingsdata). Standardvärde: None
primary_metric_name Obligatorisk	str Namnet på det primära mått som rapporterats av experimentet körs.
primary_metric_goal Obligatorisk	PrimaryMetricGoal Antingen PrimaryMetricGoal.MINIMIZE eller PrimaryMetricGoal.MAXIMIZE. Den här parametern avgör om det primära måttet ska minimeras eller maximeras vid utvärdering av körningar.
max_total_runs Obligatorisk	int Det maximala totala antalet körningar som ska skapas. Det här är den övre gränsen. det kan finnas färre körningar när exempelutrymmet är mindre än det här värdet. Om både max_total_runs och max_duration_minutes anges avslutas hyperparameterjusteringsexperimentet när det första av dessa två tröskelvärden nås.
max_concurrent_runs	int Det maximala antalet körningar som ska köras samtidigt. Om Ingen startas alla körningar parallellt. Antalet samtidiga körningar är gated på de resurser som är tillgängliga i det angivna beräkningsmålet. Därför måste du se till att beräkningsmålet har tillgängliga resurser för önskad samtidighet. Standardvärde: None
max_duration_minutes	int Den maximala varaktigheten för HyperDrive-körningen. När den här tiden har överskridits avbryts alla körningar som fortfarande körs. Om både max_total_runs och max_duration_minutes anges avslutas hyperparameterjusteringsexperimentet när det första av dessa två tröskelvärden nås. Standardvärde: 10080
resume_from	HyperDriveRun eller list[HyperDriveRun] En hyperdrive-körning eller en lista över hyperdrive-körningar som ärvs som datapunkter för att starta den nya körningen. Standardvärde: None
resume_child_runs	Run eller list[Run] En underordnad hyperdrive-körning eller en lista över underordnade hyperdrive-körningar som återupptas som nya underordnade körningar av den nya hyperdrive-körningen. Standardvärde: None
run_config	ScriptRunConfig Ett objekt för att konfigurera konfiguration för skript-/notebook-körningar. Ange endast en av följande parametrar: estimator, run_configeller pipeline. Standardvärde: None
pipeline	Pipeline Ett pipelineobjekt för att konfigurera konfiguration för pipelinekörningar. Pipelineobjektet anropas med exempelhyperparametrar för att skicka pipelinekörningar. Ange endast en av följande parametrar: estimator, run_configeller pipeline. Standardvärde: None
custom_run_id	str Anpassat körnings-ID som tillhandahålls av användaren Standardvärde: None
hyperparameter_sampling Obligatorisk	HyperParameterSampling Definitionen för hyperparameterns utrymmessampling.
primary_metric_name Obligatorisk	str Namnet på det primära mått som rapporterats av experimentet körs.
primary_metric_goal Obligatorisk	PrimaryMetricGoal Antingen PrimaryMetricGoal.MINIMIZE eller PrimaryMetricGoal.MAXIMIZE. Den här parametern avgör om det primära måttet ska minimeras eller maximeras vid utvärdering av körningar.
max_total_runs Obligatorisk	int Det maximala totala antalet körningar som ska skapas. Det här är den övre gränsen. det kan finnas färre körningar när exempelutrymmet är mindre än det här värdet.
max_concurrent_runs Obligatorisk	int Det maximala antalet körningar som ska köras samtidigt. Om Ingen startas alla körningar parallellt.
max_duration_minutes Obligatorisk	int Den maximala varaktigheten för HyperDrive-körningen. När den här tiden har överskridits avbryts alla körningar som fortfarande körs.
policy Obligatorisk	EarlyTerminationPolicy Principen för tidig uppsägning som ska användas. Om Ingen – standardinställningen används ingen princip för tidig avslutning. Med <xref:azureml.train.hyperdrive.MedianTerminationPolicy>delay_evaluation 5 är en bra avslutningsprincip att börja med. Det här är konservativa inställningar som kan ge 25%-35% besparingar utan förlust på primärmått (baserat på våra utvärderingsdata).
estimator Obligatorisk	MMLBaseEstimator En skattare som anropas med hyperparametrar i urvalet. Ange endast en av följande parametrar: estimator, run_configeller pipeline.
run_config Obligatorisk	ScriptRunConfig Ett objekt för att konfigurera konfiguration för skript-/notebook-körningar. Ange endast en av följande parametrar: estimator, run_configeller pipeline.
resume_from Obligatorisk	HyperDriveRun | list[HyperDriveRun] En hyperdrive-körning eller en lista över hyperdrive-körningar som ärvs som datapunkter för att starta den nya körningen.
resume_child_runs Obligatorisk	Run | list[Run] En underordnad hyperdrive-körning eller en lista över underordnade hyperdrive-körningar som återupptas som nya underordnade körningar av den nya hyperdrive-körningen.
pipeline Obligatorisk	Pipeline Ett pipelineobjekt för att konfigurera konfiguration för pipelinekörningar. Pipelineobjektet anropas med exempelhyperparametrar för att skicka pipelinekörningar. Ange endast en av följande parametrar: estimator, run_configeller pipeline.
custom_run_id Obligatorisk	str Anpassat körnings-ID som tillhandahålls av användaren
debug_flag	Standardvärde: None

Kommentarer

Exemplet nedan visar hur du skapar ett HyperDriveConfig-objekt som ska användas för hyperparameter-tunning. I exemplet matchar det primära måttnamnet ett värde som loggas i träningsskriptet.

   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)

Mer information om hur du arbetar med HyperDriveConfig finns i självstudien Justera hyperparametrar för din modell.

Attribut

estimator

Returnera den skattning som används i HyperDrive-körningen.

Värdet är Ingen om körningen använder en skriptkörningskonfiguration eller en pipeline.

Returer

Typ	Description
Estimator, None	Skattaren.

pipeline

Returnera pipelinen som används i HyperDrive-körningen.

Värdet är Ingen om körningen använder en skriptkörningskonfiguration eller beräkning.

Returer

Typ	Description
Pipeline, None	Pipelinen.

run_config

Returnera skript-/notebook-konfigurationen som används i HyperDrive-körningen.

Värdet är Ingen om körningen använder en uppskattning eller pipeline.

Returer

Typ	Description
ScriptRunConfig, None	Körningskonfigurationen.

source_directory

Returnera källkatalogen från konfigurationen för att köra.

Returer

Typ	Description
str	Källkatalogen