Definições do Ultralytics

A Ultralytics armazena configurações persistentes por máquina em um arquivo JSON no diretório de configuração do usuário e as disponibiliza pelo objeto settings em Python e pelo comando yolo settings. Elas controlam onde conjuntos de dados, pesos e execuções são armazenados, a chave de API da Ultralytics Platform e quais rastreadores de experimentos estão ativados. Argumentos por execução, como imgsz e epochs, estão documentados na página de configuração.

Ver, atualizar e repor definições

from ultralytics import settings

print(settings)  # ver todas as definições
value = settings["runs_dir"]  # ler uma definição
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False})  # atualizar uma ou mais definições
settings.reset()  # restaurar predefinições

Referência das definições#

Nome	Valor de exemplo	Tipo de dados	Descrição
`settings_version`	`'0.0.8'`	`str`	Versão do esquema de definições, diferente da versão do pacote `ultralytics`
`datasets_dir`	`'/path/to/datasets'`	`str`	Diretório onde os conjuntos de dados são armazenados
`weights_dir`	`'/path/to/weights'`	`str`	Diretório de download para os pesos de modelos por URL e plataforma (`ul://`) e pesquisa alternativa para nomes de modelos sem caminho
`runs_dir`	`'/path/to/runs'`	`str`	Diretório onde são armazenadas as execuções das experiências
`uuid`	`'a1b2c3d4'`	`str`	Identificador anonimizado da máquina (hash SHA-256) usado para análise de dados
`sync`	`True`	`bool`	Envia dados de análise anonimizados e relatórios de falhas à Ultralytics; consulta Privacidade
`api_key`	`''`	`str`	Chave de API da Ultralytics Platform
`openai_api_key`	`''`	`str`	Chave API da OpenAI para a funcionalidade Perguntar à IA do Explorer, disponível até `ultralytics==8.3.11`
`clearml`	`True`	`bool`	Ativa o registo do ClearML
`comet`	`True`	`bool`	Ativa o acompanhamento de experiências do Comet ML
`dvc`	`True`	`bool`	Ativar o acompanhamento de experimentos com DVC
`mlflow`	`True`	`bool`	Ativar o acompanhamento de experimentos com MLflow
`raytune`	`True`	`bool`	Ativar os relatórios de ajuste de hiperparâmetros com Ray Tune
`tensorboard`	`False`	`bool`	Ativar o registro de logs com TensorBoard
`wandb`	`False`	`bool`	Ativar o registro de logs com Weights & Biases
`vscode_msg`	`True`	`bool`	Exibir uma solicitação para instalar a extensão Ultralytics-Snippets quando um terminal do VS Code for detectado
`openvino_msg`	`True`	`bool`	Em CPUs Intel, exibir uma dica sugerindo a exportação para OpenVINO para uma inferência mais rápida

Um nome de modelo sem caminho, como YOLO("yolo26n.pt"), é carregado primeiro a partir do diretório de trabalho atual e, em seguida, a partir de weights_dir; se não estiver em nenhum dos dois, os pesos são descarregados para o diretório de trabalho atual. Para os descarregar em weights_dir, passe o caminho completo, por exemplo, YOLO(Path(settings["weights_dir"]) / "yolo26n.pt").

Colaboradores

glenn-jocher¹

Echoslayer¹

raimbekovm¹

Criado há 2 mesesAtualizado semana passada

Comentários

Faz uma pergunta, partilha os teus resultados ou ajuda alguém.