Link to this sectionValidação de Modelo com Ultralytics YOLO#

Link to this sectionIntrodução#

A validação é uma etapa crítica no pipeline de machine learning, permitindo avaliar a qualidade dos teus modelos treinados. O modo Val no Ultralytics YOLO26 oferece um conjunto robusto de ferramentas e métricas para avaliar o desempenho dos teus modelos de object detection. Este guia serve como um recurso completo para entender como usar eficazmente o modo Val para garantir que os teus modelos sejam precisos e confiáveis.

Link to this sectionPor que validar com Ultralytics YOLO?#

Eis por que usar o modo Val do YOLO26 é vantajoso:

• Precisão: Obtém métricas precisas como mAP50, mAP75 e mAP50-95 para avaliar de forma abrangente o teu modelo.
• Conveniência: Utiliza funcionalidades integradas que memorizam as definições de treino, simplificando o processo de validação.
• Flexibilidade: Valida o teu modelo com os mesmos ou diferentes conjuntos de dados e tamanhos de imagem.
• Hyperparameter Tuning: Usa métricas de validação para ajustar o teu modelo para um melhor desempenho.

Link to this sectionPrincipais Funcionalidades do Modo Val#

Estas são as funcionalidades notáveis oferecidas pelo modo Val do YOLO26:

• Definições Automatizadas: Os modelos memorizam as suas configurações de treino para uma validação simples.
• Suporte a Múltiplas Métricas: Avalia o teu modelo com base numa gama de métricas de precisão.
• CLI e Python API: Escolhe entre a interface de linha de comandos ou a API Python, dependendo da tua preferência para a validação.
• Compatibilidade de Dados: Funciona perfeitamente com conjuntos de dados usados durante a fase de treino, bem como com conjuntos de dados personalizados.

Link to this sectionExemplos de uso#

Valida a accuracy de um modelo YOLO26n treinado no conjunto de dados COCO8. Não são necessários argumentos, uma vez que o model retém os seus data de treino e argumentos como atributos do modelo. Consulta a secção de Argumentos abaixo para obter uma lista completa de argumentos de validação.

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom model

# Validate the model
metrics = model.val()  # no arguments needed, dataset and settings remembered
metrics.box.map  # map50-95
metrics.box.map50  # map50
metrics.box.map75  # map75
metrics.box.maps  # a list containing mAP50-95 for each category
metrics.box.image_metrics  # per-image metrics dictionary with precision, recall, F1, TP, FP, and FN

Link to this sectionArgumentos para a Validação de Modelos YOLO#

Ao validar modelos YOLO, vários argumentos podem ser ajustados para otimizar o processo de avaliação. Estes argumentos controlam aspetos como o tamanho da imagem de entrada, o processamento em lote e os limiares de desempenho. Abaixo encontra-se um detalhamento de cada argumento para te ajudar a personalizar as tuas definições de validação de forma eficaz.

Cada uma destas definições desempenha um papel vital no processo de validação, permitindo uma avaliação personalizável e eficiente dos modelos YOLO. Ajustar estes parâmetros de acordo com as tuas necessidades e recursos específicos pode ajudar a alcançar o melhor equilíbrio entre precisão e desempenho.

Link to this sectionExemplo de Validação com Argumentos#

Os exemplos abaixo mostram a validação de modelos YOLO com argumentos personalizados em Python e CLI.

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")

# Customize validation settings
metrics = model.val(data="coco8.yaml", imgsz=640, batch=16, conf=0.25, iou=0.7, device="0")

from ultralytics import YOLO

model = YOLO("yolo26n.pt")

results = model.val(data="coco8.yaml", plots=True)
print(results.confusion_matrix.to_df())

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")

# Validate and access per-image metrics
results = model.val(data="coco8.yaml")

# image_metrics is a dictionary with image filenames as keys
print(results.box.image_metrics)
# Output: {'image1.jpg': {'precision': 0.85, 'recall': 0.92, 'f1': 0.88, 'tp': 17, 'fp': 3, 'fn': 1}, ...}

# Access metrics for a specific image
results.box.image_metrics["image1.jpg"]  # {'precision': 0.85, 'recall': 0.92, 'f1': 0.88, 'tp': 17, 'fp': 3, 'fn': 1}

Para mais detalhes, consulta a documentação da classe DataExportMixin.

Link to this sectionFAQ#

Link to this sectionComo valido o meu modelo YOLO26 com Ultralytics?#

Para validar o teu modelo YOLO26, podes usar o modo Val fornecido pela Ultralytics. Por exemplo, usando a API Python, podes carregar um modelo e executar a validação com:

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")

# Validate the model
metrics = model.val()
print(metrics.box.map)  # map50-95

Em alternativa, podes usar a interface de linha de comandos (CLI):

yolo val model=yolo26n.pt

Para mais personalização, podes ajustar vários argumentos como imgsz, batch e conf tanto nos modos Python como CLI. Consulta a secção Argumentos para a Validação de Modelos YOLO para ver a lista completa de parâmetros.

Link to this sectionQue métricas posso obter da validação do modelo YOLO26?#

A validação do modelo YOLO26 fornece várias métricas-chave para avaliar o desempenho do modelo. Estas incluem:

• mAP50 (Precisão Média média com limiar de IoU de 0,5)
• mAP75 (Precisão Média média com limiar de IoU de 0,75)
• mAP50-95 (Precisão Média média através de múltiplos limiares de IoU de 0,5 a 0,95)

Usando a API Python, podes aceder a estas métricas da seguinte forma:

metrics = model.val()  # assumes `model` has been loaded
print(metrics.box.map)  # mAP50-95
print(metrics.box.map50)  # mAP50
print(metrics.box.map75)  # mAP75
print(metrics.box.maps)  # list of mAP50-95 for each category
print(metrics.box.image_metrics)  # per-image metrics dictionary with precision, recall, F1, TP, FP, and FN

Para uma avaliação completa do desempenho, é crucial rever todas estas métricas. Para mais detalhes, consulta as Principais Funcionalidades do Modo Val.

Link to this sectionQuais são as vantagens de usar Ultralytics YOLO para validação?#

Usar Ultralytics YOLO para validação oferece várias vantagens:

• Precision: O YOLO26 oferece métricas de desempenho precisas, incluindo mAP50, mAP75 e mAP50-95.
• Conveniência: Os modelos memorizam as suas definições de treino, tornando a validação simples.
• Flexibilidade: Podes validar contra os mesmos ou diferentes conjuntos de dados e tamanhos de imagem.
• Hyperparameter Tuning: As métricas de validação ajudam a ajustar os modelos para um melhor desempenho.

Estes benefícios garantem que os teus modelos sejam avaliados minuciosamente e possam ser otimizados para resultados superiores. Aprende mais sobre estas vantagens na secção Por que validar com Ultralytics YOLO.

Link to this sectionPosso validar o meu modelo YOLO26 usando um conjunto de dados personalizado?#

Sim, podes validar o teu modelo YOLO26 usando um conjunto de dados personalizado. Especifica o argumento data com o caminho para o teu ficheiro de configuração do conjunto de dados. Este ficheiro deve incluir o caminho para os dados de validação.

Exemplo em Python:

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")

# Validate with a custom dataset
metrics = model.val(data="path/to/your/custom_dataset.yaml")
print(metrics.box.map)  # map50-95

Exemplo usando CLI:

yolo val model=yolo26n.pt data=path/to/your/custom_dataset.yaml

Para mais opções personalizáveis durante a validação, consulta a secção Exemplo de Validação com Argumentos.

Link to this sectionComo guardo os resultados da validação num ficheiro JSON no YOLO26?#

Para guardar os resultados da validação num ficheiro JSON, podes definir o argumento save_json como True ao executar a validação. Isto pode ser feito tanto na API Python como na CLI.

Exemplo em Python:

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")

# Save validation results to JSON
metrics = model.val(save_json=True)

Exemplo usando CLI:

yolo val model=yolo26n.pt save_json=True

Esta funcionalidade é particularmente útil para análises adicionais ou integração com outras ferramentas. Consulta os Argumentos para a Validação de Modelos YOLO para mais detalhes.