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, estimativa e o destino de computação em que executar o experimento será executado.
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
| Nome | Description |
|---|---|
|
estimator
|
Um avaliador que será chamado com hiperparâmetros de exemplo.
Especifique apenas um dos seguintes parâmetros: Valor padrão: None
|
|
hyperparameter_sampling
Obrigatório
|
O espaço de amostragem do hiperparâmetro. |
|
policy
|
A política de término antecipado a ser usada. Se Nenhum – o padrão, nenhuma política de encerramento antecipada será usada. O MedianStoppingPolicy com Valor padrão: None
|
|
primary_metric_name
Obrigatório
|
O nome da métrica primária relatada pelo experimento é executado. |
|
primary_metric_goal
Obrigatório
|
PrimaryMetricGoal.MINIMIZE ou PrimaryMetricGoal.MAXIMIZE. Esse parâmetro determina se a métrica primária deve ser minimizada ou maximizada ao avaliar execuções. |
|
max_total_runs
Obrigatório
|
O número total máximo de execuções a serem criadas. Esse é o limite superior; pode haver menos execuções quando o espaço de exemplo for menor que esse valor.
Se tanto |
|
max_concurrent_runs
|
O número máximo de execuções a serem executadas simultaneamente. Se Nenhum, todas as execuções serão iniciadas em paralelo. O número de execuções simultâneas é ligado 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. Valor padrão: None
|
|
max_duration_minutes
|
A duração máxima da execução do HyperDrive. Depois que essa hora for excedida, todas as execuções que ainda estiverem em execução serão canceladas. Se tanto Valor padrão: 10080
|
|
resume_from
|
Uma execução de hiperdrive ou uma lista de execuções de hiperdrive que serão herdadas como pontos de dados para aquecer o início da nova execução. Valor padrão: None
|
|
resume_child_runs
|
Uma execução filho do hyperdrive ou uma lista de execuções filho do hyperdrive que serão retomadas como novas execuções filho da nova execução do hiperdrive. Valor padrão: None
|
|
run_config
|
Um objeto para configurar a configuração para execuções de script/notebook.
Especifique apenas um dos seguintes parâmetros: Valor padrão: None
|
|
pipeline
|
Um objeto de pipeline para configurar a configuração para 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: Valor padrão: None
|
|
custom_run_id
|
ID de execução personalizada fornecida pelo usuário Valor padrão: None
|
|
hyperparameter_sampling
Obrigatório
|
A definição de amostragem de espaço do hiperparâmetro. |
|
primary_metric_name
Obrigatório
|
O nome da métrica primária relatada pelo experimento é executado. |
|
primary_metric_goal
Obrigatório
|
PrimaryMetricGoal.MINIMIZE ou PrimaryMetricGoal.MAXIMIZE. Esse parâmetro determina se a métrica primária deve ser minimizada ou maximizada ao avaliar execuções. |
|
max_total_runs
Obrigatório
|
O número total máximo de execuções a serem criadas. Esse é o limite superior; pode haver menos execuções quando o espaço de exemplo for menor que esse valor. |
|
max_concurrent_runs
Obrigatório
|
O número máximo de execuções a serem executadas simultaneamente. Se Nenhum, todas as execuções serão iniciadas em paralelo. |
|
max_duration_minutes
Obrigatório
|
A duração máxima da execução do HyperDrive. Depois que essa hora for excedida, todas as execuções que ainda estiverem em execução serão canceladas. |
|
policy
Obrigatório
|
A política de término antecipado a ser usada. Se Nenhum – o padrão, nenhuma política de encerramento antecipada será usada. O <xref:azureml.train.hyperdrive.MedianTerminationPolicy> com |
|
estimator
Obrigatório
|
Um avaliador que será chamado com hiper parâmetros de exemplo.
Especifique apenas um dos seguintes parâmetros: |
|
run_config
Obrigatório
|
Um objeto para configurar a configuração para execuções de script/notebook.
Especifique apenas um dos seguintes parâmetros: |
|
resume_from
Obrigatório
|
Uma execução de hiperdrive ou uma lista de execuções de hiperdrive que serão herdadas como pontos de dados para aquecer o início da nova execução. |
|
resume_child_runs
Obrigatório
|
Uma execução filho do hyperdrive ou uma lista de execuções filho do hyperdrive que serão retomadas como novas execuções filho da nova execução do hiperdrive. |
|
pipeline
Obrigatório
|
Um objeto de pipeline para configurar a configuração para 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: |
|
custom_run_id
Obrigatório
|
ID de execução personalizada fornecida pelo usuário |
|
debug_flag
|
Valor padrão: None
|
Comentários
O exemplo a seguir mostra a criação de um objeto HyperDriveConfig a ser usado para ajuste de hiperparâmetro. 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 o HyperDriveConfig, consulte o tutorial Ajustar hiperparâmetros para seu modelo.
Atributos
estimator
pipeline
run_config
Retorne a configuração de script/notebook usada na execução do HyperDrive.
O valor será None se a execução usar um avaliador ou pipeline.
Retornos
| Tipo | Description |
|---|---|
|
A configuração de execução. |
source_directory
Retorne o diretório de origem da configuração a ser executada.
Retornos
| Tipo | Description |
|---|---|
|
O diretório de origem |