Compartilhar via

Sweep Classe

  • Referência

Classe base para nó de varredura.

Essa classe não deve ser instanciada diretamente. Em vez disso, ele deve ser criado por meio da função de construtor: sweep.

Herança
azure.ai.ml.entities._job.sweep.parameterized_sweep.ParameterizedSweep
Sweep
azure.ai.ml.entities._builders.base_node.BaseNode
Sweep

Construtor

Sweep(*, trial: CommandComponent | str | None = None, compute: str | None = None, limits: SweepJobLimits | None = None, sampling_algorithm: str | SamplingAlgorithm | None = None, objective: Objective | None = None, early_termination: BanditPolicy | MedianStoppingPolicy | TruncationSelectionPolicy | None = None, search_space: Dict[str, Choice | LogNormal | LogUniform | Normal | QLogNormal | QLogUniform | QNormal | QUniform | Randint | Uniform] | None = None, inputs: Dict[str, int | str | float | bool | Input] | None = None, outputs: Dict[str, str | Output] | None = None, identity: ManagedIdentityConfiguration | AmlTokenConfiguration | UserIdentityConfiguration | None = None, queue_settings: QueueSettings | None = None, **kwargs)

Parâmetros

trial
Union[CommandComponent, str]
Obrigatório

A ID ou instância do componente de comando ou trabalho a ser executado para a etapa.

compute
str
Obrigatório

A definição de computação que contém as informações de computação da etapa.

limits
SweepJobLimits
Obrigatório

Os limites para o nó de varredura.

sampling_algorithm
str
Obrigatório

O algoritmo de amostragem a ser usado para amostrar dentro do espaço de pesquisa. Os valores aceitos são: "random", "grid" ou "bayesian".

objective
Objective
Obrigatório

O objetivo usado para determinar a execução de destino com o hiperparâmetro ideal local no espaço de pesquisa.

early_termination_policy
Union[BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]
Obrigatório

A política de término antecipado do nó de varredura.

search_space
Dict[str, Union[Choice, LogNormal, LogUniform, Normal, QLogNormal, QLogUniform, QNormal, QUniform, Randint, Uniform]]
Obrigatório

O espaço de pesquisa do hiperparâmetro no qual executar as avaliações.

inputs
Dict[str, Union[Input, str, bool, int, float]]
Obrigatório

Mapeamento de associações de dados de entrada usadas no trabalho.

outputs
Dict[str, Union[str, Output]]
Obrigatório

Mapeamento de associações de dados de saída usadas no trabalho.

identity
Union[ManagedIdentityConfiguration, AmlTokenConfiguration, UserIdentityConfiguration]
Obrigatório

A identidade que o trabalho de treinamento usará durante a execução na computação.

queue_settings
QueueSettings
Obrigatório

As configurações de fila para o trabalho.

Métodos

clear
copy
dump

Despeja o conteúdo do trabalho em um arquivo no formato YAML.
fromkeys

Crie um novo dicionário com chaves de iteráveis e valores definidos como valor.
get

Retorne o valor da chave se a chave estiver no dicionário, caso contrário, padrão.
items
keys
pop

Se a chave não for encontrada, retorne o padrão se for fornecida; caso contrário, gere um KeyError.
popitem

Remova e retorne um par (chave, valor) como uma tupla de 2.

Os pares são retornados na ordem LIFO (última entrada, primeira saída). Aciona KeyError se o ditado estiver vazio.
set_limits

Definir limites para o nó De varredura. Deixe os parâmetros como Nenhum se você não quiser atualizar os valores correspondentes.
set_objective

Defina o objeto de varredura.. Deixe os parâmetros como Nenhum se você não quiser atualizar os valores correspondentes.

"minimize", "maximize". :type goal: str :palavra-chave primary_metric: nome da métrica a ser otimizada. :p aramtype primary_metric: str
setdefault

Insira a chave com um valor padrão se a chave não estiver no dicionário.

Retorne o valor da chave se a chave estiver no dicionário, caso contrário, padrão.
update

Se E estiver presente e tiver um método .keys(), o fará: para k em E: D[k] = E[k] Se E estiver presente e não tiver um método .keys(), o fará: para k, v em E: D[k] = v Em ambos os casos, isso é seguido por: para k em F: D[k] = F[k]
values

clear 

clear() -> None.  Remove all items from D.

copy 

copy() -> a shallow copy of D

dump

Despeja o conteúdo do trabalho em um arquivo no formato YAML.

dump(dest: str | PathLike | IO, **kwargs) -> None

Parâmetros

dest
Union[<xref:PathLike>, str, IO[AnyStr]]
Obrigatório

O caminho local ou fluxo de arquivos para o qual gravar o conteúdo YAML. Se dest for um caminho de arquivo, um novo arquivo será criado. Se dest for um arquivo aberto, o arquivo será gravado diretamente.

kwargs
dict

Argumentos adicionais a serem passados para o serializador YAML.

Exceções

FileExistsError

Gerado se dest for um caminho de arquivo e o arquivo já existir.

IOError

Gerado se dest for um arquivo aberto e o arquivo não for gravável.

fromkeys

Crie um novo dicionário com chaves de iteráveis e valores definidos como valor.

fromkeys(value=None, /)

Parâmetros

type
Obrigatório
iterable
Obrigatório
value
valor padrão: None

get

Retorne o valor da chave se a chave estiver no dicionário, caso contrário, padrão.

get(key, default=None, /)

Parâmetros

key
Obrigatório
default
valor padrão: None

items 

items() -> a set-like object providing a view on D's items

keys 

keys() -> a set-like object providing a view on D's keys

pop

Se a chave não for encontrada, retorne o padrão se for fornecida; caso contrário, gere um KeyError.

pop(k, [d]) -> v, remove specified key and return the corresponding value.

popitem

Remova e retorne um par (chave, valor) como uma tupla de 2.

Os pares são retornados na ordem LIFO (última entrada, primeira saída). Aciona KeyError se o ditado estiver vazio.

popitem()

set_limits

Definir limites para o nó De varredura. Deixe os parâmetros como Nenhum se você não quiser atualizar os valores correspondentes.

set_limits(*, max_concurrent_trials: int | None = None, max_total_trials: int | None = None, timeout: int | None = None, trial_timeout: int | None = None) -> None

Parâmetros

max_concurrent_trials
int

número máximo de avaliação simultânea.

max_total_trials
int

número máximo de avaliação total.

timeout
int

tempo limite total em segundos para o nó de varredura

trial_timeout
int

tempo limite em segundos para cada avaliação

set_objective

Defina o objeto de varredura.. Deixe os parâmetros como Nenhum se você não quiser atualizar os valores correspondentes.

"minimize", "maximize". :type goal: str :palavra-chave primary_metric: nome da métrica a ser otimizada. :p aramtype primary_metric: str

set_objective(*, goal: str | None = None, primary_metric: str | None = None) -> None

Parâmetros

goal

Define as metas de métrica com suporte para ajuste de hiperparâmetros. Os valores aceitáveis são:

setdefault

Insira a chave com um valor padrão se a chave não estiver no dicionário.

Retorne o valor da chave se a chave estiver no dicionário, caso contrário, padrão.

setdefault(key, default=None, /)

Parâmetros

key
Obrigatório
default
valor padrão: None

update

Se E estiver presente e tiver um método .keys(), o fará: para k em E: D[k] = E[k] Se E estiver presente e não tiver um método .keys(), o fará: para k, v em E: D[k] = v Em ambos os casos, isso é seguido por: para k em F: D[k] = F[k]

update([E], **F) -> None.  Update D from dict/iterable E and F.

values 

values() -> an object providing a view on D's values

Atributos

base_path

O caminho base do recurso.

Retornos

O caminho base do recurso.

Tipo de retorno

str

creation_context

O contexto de criação do recurso.

Retornos

Os metadados de criação do recurso.

Tipo de retorno

Optional[SystemData]

early_termination

A política de término antecipado para o trabalho de varredura.

Tipo de retorno

Union[str, BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]

id

A ID do recurso.

Retornos

A ID global do recurso, uma ID do ARM (Resource Manager do Azure).

Tipo de retorno

Optional[str]

inputs

Obtenha as entradas do objeto .

Retornos

Um dicionário que contém as entradas do objeto .

Tipo de retorno

Dict[str, Union[Input, str, bool, int, float]]

limits

Limites para o trabalho de varredura.

Retornos

Limites para o trabalho de varredura.

Tipo de retorno

SweepJobLimits

log_files

Arquivos de saída do trabalho.

Retornos

O dicionário de nomes de log e URLs.

Tipo de retorno

Optional[Dict[str, str]]

name

Obtenha o nome do nó.

Retornos

O nome do nó.

Tipo de retorno

str

outputs

Obtenha as saídas do objeto .

Retornos

Um dicionário que contém as saídas do objeto .

Tipo de retorno

Dict[str, Union[str, Output]]

sampling_algorithm

Algoritmo de amostragem para o trabalho de varredura.

Retornos

Algoritmo de amostragem para o trabalho de varredura.

Tipo de retorno

SamplingAlgorithm

search_space

Dicionário do espaço de pesquisa do hiperparâmetro.

Cada chave é o nome de um hiperparâmetro e seu valor é a expressão de parâmetro.

Tipo de retorno

Dict[str, Union[Choice, LogNormal, LogUniform, Normal, QLogNormal, QLogUniform, QNormal, QUniform, Randint, Uniform]]

status

O status do trabalho.

Os valores comuns retornados incluem "Running", "Completed" e "Failed". Todos os valores possíveis são:

  • NotStarted - Esse é um estado temporário em que os objetos Run do lado do cliente estão antes do envio na nuvem.

  • Starting – A Execução começou a ser processada na nuvem. O chamador tem uma ID de execução neste ponto.

  • Provisionamento – a computação sob demanda está sendo criada para um determinado envio de trabalho.

  • Preparação – o ambiente de execução está sendo preparado e está em um dos dois estágios:

    • Build de imagem do Docker

    • conda environment setup

  • Enfileirado – o trabalho está na fila no destino de computação. Por exemplo, no BatchAI, o trabalho está em um estado enfileirado

    enquanto aguarda que todos os nós solicitados estejam prontos.

  • Em execução – o trabalho começou a ser executado no destino de computação.

  • Finalização – a execução do código do usuário foi concluída e a execução está em estágios pós-processamento.

  • CancelRequested – O cancelamento foi solicitado para o trabalho.

  • Concluído – a execução foi concluída com êxito. Isso inclui a execução e a execução do código do usuário

    estágios de pós-processamento.

  • Failed – A execução falhou. Normalmente, a propriedade de Erro em uma execução fornecerá detalhes sobre o motivo.

  • Canceled – Segue uma solicitação de cancelamento e indica que a execução foi cancelada com êxito.

  • NotResponding – Para execuções que têm Pulsações habilitadas, nenhuma pulsação foi enviada recentemente.

Retornos

Status do trabalho.

Tipo de retorno

Optional[str]

studio_url

Ponto de extremidade do estúdio do Azure ML.

Retornos

A URL para a página de detalhes do trabalho.

Tipo de retorno

Optional[str]

trial

A ID ou instância do componente de comando ou trabalho a ser executado para a etapa.

Tipo de retorno

CommandComponent

type

O tipo do trabalho.

Retornos

O tipo do trabalho.

Tipo de retorno

Optional[str]