HyperDriveConfig Klass

Konfiguration som definierar en HyperDrive-körning.

HyperDrive-konfigurationen innehåller information om utrymmessampling av hyperparametrar, avslutningsprincip, primärt mått, cv från konfiguration, beräkning och beräkningsmålet som experimentet körs på.

Initiera HyperDriveConfig.

Arv

builtins.object

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 Hyperparameterns samplingsutrymme.
policy	EarlyTerminationPolicy Den princip för tidig avslutning 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 besparingar på 25–35 % 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 för 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 ska ärvas som data pekar på en varm start på 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 när nya underordnade körningar av den nya hyperdrive-körningen återupptas. 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 konfiguration av 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 hyperparameterutrymmessampling.
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 Den princip för tidig avslutning 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 besparingar på 25–35 % utan förlust på primärmått (baserat på våra utvärderingsdata).
estimator Obligatorisk	MMLBaseEstimator En skattningsfaktor som anropas med exempelparametrar. 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 ska ärvas som data pekar på en varm start på 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 när nya underordnade körningar av den nya hyperdrive-körningen återupptas.
pipeline Obligatorisk	Pipeline Ett pipelineobjekt för konfiguration av 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 Finjustera hyperparametrar för din modell.

Attribut

estimator

Returnera uppskattningen 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 skattnings- eller pipeline.

Returer

Typ	Description
ScriptRunConfig, None	Körningskonfigurationen.

source_directory

Returnera källkatalogen från konfigurationen som ska köras.

Returer

Typ	Description
str	Källkatalogen