Sweep Classe

  • Referência

Classe base para varrer o nó.

Esta classe não deve ser instanciada diretamente. Em vez disso, deve ser criada através da função construtora: varrer.

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]
Necessário

O ID ou instância do componente de comando ou tarefa a executar para o passo.

compute
str
Necessário

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

limits
SweepJobLimits
Necessário

Os limites do nó de varrimento.

sampling_algorithm
str
Necessário

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

objective
Objective
Necessário

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

early_termination_policy
Union[BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]
Necessário

A política de cessação antecipada do nó de varrimento.

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

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

inputs
Dict[str, Union[Input, str, bool, int, float]]
Necessário

Mapeamento de enlaces de dados de entrada utilizados na tarefa.

outputs
Dict[str, Union[str, Output]]
Necessário

Mapeamento de enlaces de dados de saída utilizados na tarefa.

identity
Union[ManagedIdentityConfiguration, AmlTokenConfiguration, UserIdentityConfiguration]
Necessário

A identidade que a tarefa de preparação utilizará durante a execução na computação.

queue_settings
QueueSettings
Necessário

As definições de fila para a tarefa.

Métodos

clear
copy
dump

Captura o conteúdo da tarefa num ficheiro no formato YAML.
fromkeys

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

Devolva o valor da chave se a chave estiver no dicionário, caso contrário, predefinição.
items
keys
pop

Se a chave não for encontrada, devolva a predefinição se for dada; caso contrário, crie um KeyError.
popitem

Remova e devolva um par (chave, valor) como uma cadeia de 2 cadeias de identificação.

Os pares são devolvidos por ordem LIFO (último, primeiro a sair). Aumenta o KeyError se o ditado estiver vazio.
set_limits

Defina limites para Varrer nó. Deixe os parâmetros como Nenhum se não quiser atualizar os valores correspondentes.
set_objective

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

"minimizar", "maximizar". :type goal: str :keyword primary_metric: Nome da métrica a otimizar. :p aramtype primary_metric: str
setdefault

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

Devolva o valor da chave se a chave estiver no dicionário, caso contrário, predefinição.
update

Se E estiver presente e tiver um método .keys(), então faz: para k em E: D[k] = E[k] Se E estiver presente e não tiver um método .keys(), então faz: para k, v em E: D[k] = v Em ambos os casos, este procedimento é 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

Captura o conteúdo da tarefa num ficheiro no formato YAML.

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

Parâmetros

dest
Union[<xref:PathLike>, str, IO[AnyStr]]
Necessário

O caminho local ou o fluxo de ficheiros para o qual escrever o conteúdo YAML. Se dest for um caminho de ficheiro, será criado um novo ficheiro. Se dest for um ficheiro aberto, o ficheiro será escrito diretamente.

kwargs
dict

Argumentos adicionais para passar para o serializador YAML.

Exceções

FileExistsError

Gerado se dest é um caminho de ficheiro e o ficheiro já existe.

IOError

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

fromkeys

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

fromkeys(value=None, /)

Parâmetros

type
Necessário
iterable
Necessário
value
valor predefinido: None

get

Devolva o valor da chave se a chave estiver no dicionário, caso contrário, predefinição.

get(key, default=None, /)

Parâmetros

key
Necessário
default
valor predefinido: 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, devolva a predefinição se for dada; caso contrário, crie um KeyError.

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

popitem

Remova e devolva um par (chave, valor) como uma cadeia de 2 cadeias de identificação.

Os pares são devolvidos por ordem LIFO (último, primeiro a sair). Aumenta o KeyError se o ditado estiver vazio.

popitem()

set_limits

Defina limites para Varrer nó. Deixe os parâmetros como Nenhum se 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 varrer o nó

trial_timeout
int

tempo limite em segundos para cada avaliação

set_objective

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

"minimizar", "maximizar". :type goal: str :keyword primary_metric: Nome da métrica a otimizar. :p aramtype primary_metric: str

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

Parâmetros

goal

Define os objetivos de métricas suportados para otimização de hiperparâmetros. Os valores aceitáveis são:

setdefault

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

Devolva o valor da chave se a chave estiver no dicionário, caso contrário, predefinição.

setdefault(key, default=None, /)

Parâmetros

key
Necessário
default
valor predefinido: None

update

Se E estiver presente e tiver um método .keys(), então faz: para k em E: D[k] = E[k] Se E estiver presente e não tiver um método .keys(), então faz: para k, v em E: D[k] = v Em ambos os casos, este procedimento é 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.

Devoluções

O caminho base do recurso.

Tipo de retorno

str

creation_context

O contexto de criação do recurso.

Devoluções

Os metadados de criação do recurso.

Tipo de retorno

Optional[SystemData]

early_termination

A política de cessação antecipada para o trabalho de varrimento.

Tipo de retorno

Union[str, BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]

id

O ID do recurso.

Devoluções

O ID global do recurso, um ID do Azure Resource Manager (ARM).

Tipo de retorno

Optional[str]

inputs

Obtenha as entradas do objeto.

Devoluções

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

Tipo de retorno

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

limits

Limites para tarefas de varrimento.

Devoluções

Limites para tarefas de varrimento.

Tipo de retorno

SweepJobLimits

log_files

Ficheiros de saída da tarefa.

Devoluções

O dicionário de nomes de registo e URLs.

Tipo de retorno

Optional[Dict[str, str]]

name

Obtenha o nome do nó.

Devoluções

O nome do nó.

Tipo de retorno

str

outputs

Obtenha as saídas do objeto.

Devoluções

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 tarefa de varrimento.

Devoluções

Algoritmo de amostragem para tarefa de varrimento.

Tipo de retorno

SamplingAlgorithm

search_space

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

Cada chave é o nome de um hiperparâmetros e o respetivo 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 estado da tarefa.

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

  • NotStarted - este é um estado temporário em que os objetos Run do lado do cliente estão antes da submissão da cloud.

  • A iniciar – a Execução começou a ser processada na cloud. O autor da chamada tem um ID de execução neste momento.

  • Aprovisionamento – a computação a pedido está a ser criada para uma determinada submissão de tarefas.

  • Preparação – o ambiente de execução está a ser preparado e está numa de duas fases:

    • Compilação de imagens do Docker

    • configuração do ambiente conda

  • Em fila – a tarefa está em fila de espera no destino de computação. Por exemplo, no BatchAI, a tarefa está num estado em fila

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

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

  • Finalização – a execução do código do utilizador foi concluída e a execução encontra-se em fases de pós-processamento.

  • CancelRequested - Foi pedido o cancelamento para a tarefa.

  • Concluído – a execução foi concluída com êxito. Isto inclui a execução do código de utilizador e a execução

    fases de pós-processamento.

  • Falha - A execução falhou. Normalmente, a propriedade Erro numa execução irá fornecer detalhes sobre o motivo.

  • Cancelado – segue um pedido de cancelamento e indica que a execução foi cancelada com êxito.

  • NotResponding – para execuções com Heartbeats ativados, não foi enviado nenhum heartbeat recentemente.

Devoluções

Estado da tarefa.

Tipo de retorno

Optional[str]

studio_url

Ponto final do Azure ML Studio.

Devoluções

O URL para a página de detalhes da tarefa.

Tipo de retorno

Optional[str]

trial

O ID ou instância do componente de comando ou tarefa a executar para o passo.

Tipo de retorno

CommandComponent

type

O tipo de tarefa.

Devoluções

O tipo de tarefa.

Tipo de retorno

Optional[str]