Compartilhar via


HyperDriveRun Classe

O HyperDriveRun contém os detalhes de um experimento do HyperDrive enviado.

Essa classe pode ser usada para gerenciar, verificar o status e recuperar detalhes de execução para a execução do HyperDrive e cada uma das execuções filho geradas.

Inicializar uma execução do HyperDrive.

Construtor

HyperDriveRun(experiment, run_id, hyperdrive_config=None, **kwargs)

Parâmetros

Nome Description
experiment
Obrigatório

O experimento para a execução do HyperDrive.

run_id
Obrigatório
str

A ID de execução do HyperDrive.

hyperdrive_config

A configuração para esta execução do HyperDrive.

Valor padrão: None
experiment
Obrigatório

O experimento para a execução do HyperDrive.

run_id
Obrigatório
str

A ID de execução do HyperDrive.

hyperdrive_config
Obrigatório

A configuração para esta execução do HyperDrive. Se Nenhum, presumimos que a execução já existe e tentaremos se hidratar da nuvem.

Métodos

cancel

Retornar True se a execução do HyperDrive tiver sido cancelada com êxito.

fail

Não use. Não há suporte para o método fail para a subclasse HyperDriveRun.

get_best_run_by_primary_metric

Localize e retorne a instância Executar que corresponde à execução com melhor desempenho entre todas as execuções filho.

A execução com melhor desempenho é identificada exclusivamente com base no parâmetro de métrica primário especificado no HyperDriveConfig. O PrimaryMetricGoal determina se o mínimo ou o máximo da métrica primária é usado. Para fazer uma análise mais detalhada de todas as métricas do ExperimentRun iniciadas por este HyperDriveRun, use get_metrics. Apenas uma das execuções é retornada, mesmo que várias das Execuções iniciadas por essa execução do HyperDrive atinjam a mesma melhor métrica.

get_children_sorted_by_primary_metric

Retorne uma lista de filhos classificados por sua melhor métrica primária.

A classificação é feita de acordo com a métrica primária e sua meta: se for maximizada, as crianças serão retornadas em ordem decrescente de sua melhor métrica primária. Se inverter for True, a ordem será invertida.

Cada filho no resultado tem id de execução, hiperparâmetros, melhor valor de métrica primária e status.

Crianças sem métrica primária são descartadas quando discard_no_metric é True. Caso contrário, elas serão acrescentadas à lista atrás de outras crianças com métrica primária. Observe que a opção inversa não tem impacto sobre elas.

get_diagnostics

Não use. Não há suporte para o método get_diagnostics para a subclasse HyperDriveRun.

get_hyperparameters

Retorne os hiperparâmetros para todas as execuções filho que foram lançadas por este HyperDriveRun.

get_metrics

Retorne as métricas de todas as execuções que foram iniciadas por este HyperDriveRun.

cancel

Retornar True se a execução do HyperDrive tiver sido cancelada com êxito.

cancel()

Retornos

Tipo Description

Se a execução foi cancelada com êxito ou não.

fail

Não use. Não há suporte para o método fail para a subclasse HyperDriveRun.

fail()

Exceções

Tipo Description

get_best_run_by_primary_metric

Localize e retorne a instância Executar que corresponde à execução com melhor desempenho entre todas as execuções filho.

A execução com melhor desempenho é identificada exclusivamente com base no parâmetro de métrica primário especificado no HyperDriveConfig. O PrimaryMetricGoal determina se o mínimo ou o máximo da métrica primária é usado. Para fazer uma análise mais detalhada de todas as métricas do ExperimentRun iniciadas por este HyperDriveRun, use get_metrics. Apenas uma das execuções é retornada, mesmo que várias das Execuções iniciadas por essa execução do HyperDrive atinjam a mesma melhor métrica.

get_best_run_by_primary_metric(include_failed=True, include_canceled=True, include_resume_from_runs=True) -> Run | None

Parâmetros

Nome Description
include_failed

Se as execuções com falha devem ser incluídas.

Valor padrão: True
include_canceled

Se deve incluir execuções canceladas.

Valor padrão: True
include_resume_from_runs

Se deve incluir execuções de resume_from herdadas.

Valor padrão: True

Retornos

Tipo Description
Run

A melhor Execução ou Nenhuma se nenhum filho tiver a métrica primária.

get_children_sorted_by_primary_metric

Retorne uma lista de filhos classificados por sua melhor métrica primária.

A classificação é feita de acordo com a métrica primária e sua meta: se for maximizada, as crianças serão retornadas em ordem decrescente de sua melhor métrica primária. Se inverter for True, a ordem será invertida.

Cada filho no resultado tem id de execução, hiperparâmetros, melhor valor de métrica primária e status.

Crianças sem métrica primária são descartadas quando discard_no_metric é True. Caso contrário, elas serão acrescentadas à lista atrás de outras crianças com métrica primária. Observe que a opção inversa não tem impacto sobre elas.

get_children_sorted_by_primary_metric(top=0, reverse=False, discard_no_metric=False)

Parâmetros

Nome Description
top
int

Número de filhos principais a serem retornados. Se for 0, todas as crianças serão retornadas.

Valor padrão: 0
reverse

Se for True, a ordem será invertida. Ele só afeta crianças com a métrica primária.

Valor padrão: False
discard_no_metric

Se for False, os filhos sem métrica primária serão acrescentados à lista.

Valor padrão: False

Retornos

Tipo Description

Lista de dicionários com id de execução, hiperparâmetros, melhor métrica primária e status

get_diagnostics

Não use. Não há suporte para o método get_diagnostics para a subclasse HyperDriveRun.

get_diagnostics()

Exceções

Tipo Description

get_hyperparameters

Retorne os hiperparâmetros para todas as execuções filho que foram lançadas por este HyperDriveRun.

get_hyperparameters()

Retornos

Tipo Description

Hiperparâmetros para todas as execuções filho. É um dicionário com run_id como chave.

get_metrics

Retorne as métricas de todas as execuções que foram iniciadas por este HyperDriveRun.

get_metrics()

Retornos

Tipo Description

As métricas para todos os filhos dessa execução.

Atributos

hyperdrive_config

Retorne a configuração de execução do hyperdrive.

Retornos

Tipo Description

A configuração de execução do hyperdrive.

HYPER_DRIVE_RUN_USER_AGENT

HYPER_DRIVE_RUN_USER_AGENT = 'sdk_run_hyper_drive'

RUN_TYPE

RUN_TYPE = 'hyperdrive'