Partilhar via


HyperDriveConfig Classe

Configuração que define uma execução do HyperDrive.

A configuração do HyperDrive inclui informações sobre amostragem de espaço de hiperparâmetro, política de encerramento, métrica primária, retomada da configuração, estimador e o destino de computação para executar o experimento.

Inicialize o HyperDriveConfig.

Construtor

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)

Parâmetros

Name Description
estimator

Um estimador que será chamado com hiperparâmetros amostrados. Especifique apenas um dos seguintes parâmetros: estimator, run_config, ou pipeline.

Default value: None
hyperparameter_sampling
Necessário

O espaço de amostragem do hiperparâmetro.

policy

A política de rescisão antecipada a utilizar. Se Nenhum - o padrão, nenhuma política de rescisão antecipada será usada.

O MedianStoppingPolicy com delay_evaluation de 5 é uma boa política de rescisão para começar. Estas são configurações conservadoras, que podem fornecer economias de 25%a -35% sem perda na métrica primária (com base em nossos dados de avaliação).

Default value: None
primary_metric_name
Necessário
str

O nome da métrica primária relatada pelo experimento é executado.

primary_metric_goal
Necessário

PrimaryMetricGoal.MINIMIZE ou PrimaryMetricGoal.MAXIMIZE. Este parâmetro determina se a métrica primária deve ser minimizada ou maximizada ao avaliar execuções.

max_total_runs
Necessário
int

O número total máximo de execuções a serem criadas. Este é o limite superior; Pode haver menos execuções quando o espaço de amostra é menor do que esse valor. Se ambos max_total_runs forem max_duration_minutes especificados, o experimento de ajuste de hiperparâmetros terminará quando o primeiro desses dois limites for atingido.

max_concurrent_runs
int

O número máximo de execuções a serem executadas simultaneamente. Se Nenhum, todas as execuções são iniciadas em paralelo. O número de execuções simultâneas é limitado aos recursos disponíveis no destino de computação especificado. Portanto, você precisa garantir que o destino de computação tenha os recursos disponíveis para a simultaneidade desejada.

Default value: None
max_duration_minutes
int

A duração máxima da execução do HyperDrive. Uma vez que esse tempo é excedido, todas as execuções ainda em execução são canceladas. Se ambos max_total_runs forem max_duration_minutes especificados, o experimento de ajuste de hiperparâmetros terminará quando o primeiro desses dois limites for atingido.

Default value: 10080
resume_from

Uma execução de hiperdrive ou uma lista de execuções de hyperdrive que serão herdadas como pontos de dados para iniciar a nova execução.

Default value: None
resume_child_runs
Run ou list[Run]

Uma execução filho do hyperdrive ou uma lista de execuções filho do hyperdrive que serão retomadas à medida que novas execuções filho do novo hyperdrive forem executados.

Default value: None
run_config

Um objeto para configurar a configuração de script/notebook é executado. Especifique apenas um dos seguintes parâmetros: estimator, run_config, ou pipeline.

Default value: None
pipeline

Um objeto de pipeline para configurar a configuração de execuções de pipeline. O objeto de pipeline será chamado com os hiperparâmetros de exemplo para enviar execuções de pipeline. Especifique apenas um dos seguintes parâmetros: estimator, run_config, ou pipeline.

Default value: None
custom_run_id
str

ID de execução personalizada fornecida pelo usuário

Default value: None
hyperparameter_sampling
Necessário

A definição de amostragem de espaço de hiperparâmetro.

primary_metric_name
Necessário
str

O nome da métrica primária relatada pelo experimento é executado.

primary_metric_goal
Necessário

PrimaryMetricGoal.MINIMIZE ou PrimaryMetricGoal.MAXIMIZE. Este parâmetro determina se a métrica primária deve ser minimizada ou maximizada ao avaliar execuções.

max_total_runs
Necessário
int

O número total máximo de execuções a serem criadas. Este é o limite superior; Pode haver menos execuções quando o espaço de amostra é menor do que esse valor.

max_concurrent_runs
Necessário
int

O número máximo de execuções a serem executadas simultaneamente. Se Nenhum, todas as execuções são iniciadas em paralelo.

max_duration_minutes
Necessário
int

A duração máxima da execução do HyperDrive. Uma vez que esse tempo é excedido, todas as execuções ainda em execução são canceladas.

policy
Necessário

A política de rescisão antecipada a utilizar. Se Nenhum - o padrão, nenhuma política de rescisão antecipada será usada.

O <xref:azureml.train.hyperdrive.MedianTerminationPolicy> com delay_evaluation de 5 é uma boa política de rescisão para começar. Estas são configurações conservadoras, que podem fornecer economias de 25%a -35% sem perda na métrica primária (com base em nossos dados de avaliação).

estimator
Necessário

Um estimador que será chamado com hiperparâmetros amostrados. Especifique apenas um dos seguintes parâmetros: estimator, run_config, ou pipeline.

run_config
Necessário

Um objeto para configurar a configuração de script/notebook é executado. Especifique apenas um dos seguintes parâmetros: estimator, run_config, ou pipeline.

resume_from
Necessário

Uma execução de hiperdrive ou uma lista de execuções de hyperdrive que serão herdadas como pontos de dados para iniciar a nova execução.

resume_child_runs
Necessário
Run | list[Run]

Uma execução filho do hyperdrive ou uma lista de execuções filho do hyperdrive que serão retomadas à medida que novas execuções filho do novo hyperdrive forem executados.

pipeline
Necessário

Um objeto de pipeline para configurar a configuração de execuções de pipeline. O objeto de pipeline será chamado com os hiperparâmetros de exemplo para enviar execuções de pipeline. Especifique apenas um dos seguintes parâmetros: estimator, run_config, ou pipeline.

custom_run_id
Necessário
str

ID de execução personalizada fornecida pelo usuário

debug_flag
Default value: None

Observações

O exemplo abaixo mostra a criação de um objeto HyperDriveConfig para usar para ajuste de hiperparâmetros. No exemplo, o nome da métrica primária corresponde a um valor registrado no script de treinamento.


   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)

Para obter mais informações sobre como trabalhar com HyperDriveConfig, consulte o tutorial Tune hyperparameters for your model.

Atributos

estimator

Retorne o estimador usado na execução do HyperDrive.

O valor é Nenhum se a execução usar uma configuração de execução de script ou um pipeline.

Devoluções

Tipo Description

O estimador.

pipeline

Retorne o pipeline usado na execução do HyperDrive.

O valor é Nenhum se a execução usar uma configuração ou estimador de execução de script.

Devoluções

Tipo Description

O gasoduto.

run_config

Retorne a configuração de script/notebook usada na execução do HyperDrive.

O valor é Nenhum se a execução usar um estimador ou pipeline.

Devoluções

Tipo Description

A configuração de execução.

source_directory

Retorne o diretório de origem da configuração para executar.

Devoluções

Tipo Description
str

O diretório de origem