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: 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 Default value: None
|
|
primary_metric_name
Necessário
|
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
|
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_concurrent_runs
|
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
|
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 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
|
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: 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: Default value: None
|
|
custom_run_id
|
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
|
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
|
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
|
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
|
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 |
|
estimator
Necessário
|
Um estimador que será chamado com hiperparâmetros amostrados.
Especifique apenas um dos seguintes parâmetros: |
|
run_config
Necessário
|
Um objeto para configurar a configuração de script/notebook é executado.
Especifique apenas um dos seguintes parâmetros: |
|
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
|
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: |
|
custom_run_id
Necessário
|
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
pipeline
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 |
|---|---|
|
O diretório de origem |