Definições do Ultralytics#
A Ultralytics armazena configurações persistentes específicas de cada máquina num ficheiro JSON no diretório de configuração do utilizador e disponibiliza-as através do objeto settings em Python e do comando yolo settings. Estas configurações controlam onde são armazenados os conjuntos de dados, os pesos e as execuções, a chave da API da Ultralytics Platform e quais os sistemas de acompanhamento de experiências ativados. Os argumentos específicos de cada execução, como imgsz e epochs, estão documentados na página Configuração.
Ver, atualizar e repor as configurações
from ultralytics import settings
print(settings) # ver todas as configurações
value = settings["runs_dir"] # ler uma configuração
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False}) # atualizar uma ou mais configurações
settings.reset() # restaurar predefiniçõesReferência das configurações#
| Nome | Valor de exemplo | Tipo de dados | Descrição |
|---|---|---|---|
settings_version | '0.0.8' | str | Versão do esquema de configurações, distinta da versão do pacote ultralytics |
datasets_dir | '/path/to/datasets' | str | Diretório onde são armazenados os conjuntos de dados |
weights_dir | '/path/to/weights' | str | Diretório onde são armazenados os pesos dos modelos |
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) utilizado para análise |
sync | True | bool | Enviar dados de análise anonimizados e relatórios de falhas à Ultralytics; consulta Privacidade |
api_key | '' | str | Chave da API da Ultralytics Platform |
openai_api_key | '' | str | Chave da API da OpenAI para a funcionalidade Perguntar à IA do Explorer, disponível até ultralytics==8.3.11 |
clearml | True | bool | Ativar o registo no ClearML |
comet | True | bool | Ativar o acompanhamento de experiências do Comet ML |
dvc | True | bool | Ativar o acompanhamento de experiências do DVC |
mlflow | True | bool | Ativar o acompanhamento de experiências do MLflow |
raytune | True | bool | Ativar a geração de relatórios do ajuste de hiperparâmetros do Ray Tune |
tensorboard | False | bool | Ativar o registo no TensorBoard |
wandb | False | bool | Ativar o registo no Weights & Biases |
vscode_msg | True | bool | Mostrar uma mensagem para instalar a extensão Ultralytics-Snippets quando for detetado um terminal do VS Code |
openvino_msg | True | bool | Em CPUs Intel, mostrar uma sugestão para exportar com OpenVINO e obter inferência mais rápida |