Definições do Ultralytics#
A Ultralytics armazena definições persistentes por 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 definições controlam onde são armazenados os conjuntos de dados, os pesos e as execuções, a chave API da Plataforma Ultralytics e quais os sistemas de acompanhamento de experiências ativados. Os argumentos por execução, como imgsz e epochs, estão documentados na página 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çõesReferê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 onde os pesos dos modelos são armazenados |
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 API da Plataforma Ultralytics |
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 |