Skip to main content

Estimativa de Pose

YOLO pose estimation with human body keypoint detection

A estimativa de pose é uma tarefa que envolve identificar a localização de pontos específicos em uma imagem, geralmente chamados de keypoints. Os keypoints podem representar várias partes do objeto, como articulações, marcos ou outras características distintas. As localizações dos keypoints são geralmente representadas como um conjunto de 2D [x, y] ou 3D [x, y, visible].

O resultado de um modelo de estimativa de pose é um conjunto de pontos que representam os keypoints em um objeto na imagem, geralmente junto com pontuações de confiança para cada ponto. A estimativa de pose é uma boa escolha quando você precisa identificar partes específicas de um objeto em uma cena e sua localização em relação umas às outras.



Watch: How to Run Real-Time Pose Estimation with Ultralytics YOLO26 | Tracking & Keypoints Extraction 🕺
Dica

Modelos YOLO26 pose usam o sufixo -pose, isto é, yolo26n-pose.pt. Estes modelos são treinados no conjunto de dados COCO keypoints e são adequados para uma variedade de tarefas de estimativa de pose.

No modelo de pose YOLO26 padrão, existem 17 keypoints, cada um representando uma parte diferente do corpo humano. Aqui está o mapeamento de cada índice para sua respectiva articulação corporal:

  1. Nariz
  2. Olho Esquerdo
  3. Olho Direito
  4. Orelha Esquerda
  5. Orelha Direita
  6. Ombro Esquerdo
  7. Ombro Direito
  8. Cotovelo Esquerdo
  9. Cotovelo Direito
  10. Pulso Esquerdo
  11. Pulso Direito
  12. Quadril Esquerdo
  13. Quadril Direito
  14. Joelho Esquerdo
  15. Joelho Direito
  16. Tornozelo Esquerdo
  17. Tornozelo Direito

Modelos

Modelos de Pose pré-treinados YOLO26 da Ultralytics são mostrados aqui. Modelos de Detecção, Segmentação e Pose são pré-treinados no conjunto de dados COCO , enquanto modelos de Classificação são pré-treinados no conjunto de dados ImageNet.

Modelos baixam automaticamente do mais recente release da Ultralytics no primeiro uso.

Modelotamanho
(pixels)
mAPpose
50-95(e2e)
mAPpose
50(e2e)
Velocidade
CPU ONNX
(ms)
Velocidade
T4 TensorRT10
(ms)
params
(M)
FLOPs
(B)
YOLO26n-pose64057.283.340.3 ± 0.51.8 ± 0.02.97.5
YOLO26s-pose64063.086.685.3 ± 0.92.7 ± 0.010.423.9
YOLO26m-pose64068.889.6218.0 ± 1.55.0 ± 0.121.573.1
YOLO26l-pose64070.490.5275.4 ± 2.46.5 ± 0.125.991.3
YOLO26x-pose64071.691.6565.4 ± 3.012.2 ± 0.257.6201.7
  • mAPval os valores são para modelo único em escala única no conjunto de dados COCO Keypoints val2017 .
    Reproduza por yolo val pose data=coco-pose.yaml device=0
  • Velocidade com média das imagens de validação do COCO usando uma instância Amazon EC2 P4d .
    Reproduza por yolo val pose data=coco-pose.yaml batch=1 device=0|cpu
  • Params e FLOPs valores são para o modelo fundido após model.fuse() , que mescla camadas Conv e BatchNorm e, para modelos end2end, remove o head de detecção auxiliar um-para-muitos. Checkpoints pré-treinados retêm a arquitetura de treinamento completa e podem mostrar contagens mais altas.

Treinar

Treine um modelo YOLO26-pose no conjunto de dados COCO8-pose. O COCO8-pose dataset é um pequeno conjunto de dados de exemplo que é perfeito para testar e depurar seus modelos de estimativa de pose.

Exemplo
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-pose.yaml")  # build a new model from YAML
model = YOLO("yolo26n-pose.pt")  # load a pretrained model (recommended for training)
model = YOLO("yolo26n-pose.yaml").load("yolo26n-pose.pt")  # build from YAML and transfer weights

# Train the model
results = model.train(data="coco8-pose.yaml", epochs=100, imgsz=640)

Veja detalhes completos de train detalhes do modo na página Treinar . Modelos de Pose também podem ser treinados em GPUs na nuvem através do Plataforma Ultralytics.

Formato do conjunto de dados

O formato do conjunto de dados de pose YOLO pode ser encontrado em detalhes no Dataset Guide. Para converter seu conjunto de dados existente de outros formatos (como COCO etc.) para o formato YOLO, por favor use a ferramenta JSON2YOLO da Ultralytics. Plataforma Ultralytics também suporta anotação de pose com modelos de esqueleto integrados para pessoas, mãos, rostos e layouts de keypoints personalizados.

Para tarefas de estimativa de pose personalizadas, você também pode explorar conjuntos de dados especializados como Tiger-Pose para estimativa de pose animal, Hand Keypoints para rastreamento de mãos, ou Dog-Pose para análise de pose canina.

Val

Valida o modelo YOLO26n-pose treinado precisão no dataset COCO8-pose. Nenhum argumento é necessário já que o model retém seus data de treinamento e argumentos como atributos do modelo.

Exemplo
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-pose.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 for box with precision, recall, F1, TP, FP, and FN
metrics.pose.map  # map50-95(P)
metrics.pose.map50  # map50(P)
metrics.pose.map75  # map75(P)
metrics.pose.maps  # a list containing mAP50-95(P) for each category
metrics.pose.image_metrics  # per-image metrics dictionary for pose with precision, recall, F1, TP, FP, and FN

Previsão

Usa um modelo YOLO26n-pose treinado para realizar predições em imagens. O predict mode permite que realizes inferência em imagens, vídeos ou transmissões em tempo real.

Exemplo
from ultralytics import YOLO

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

# Predict with the model
results = model("https://ultralytics.com/images/bus.jpg")  # predict on an image

# Access the results
for result in results:
    xy = result.keypoints.xy  # x and y coordinates
    xyn = result.keypoints.xyn  # normalized
    kpts = result.keypoints.data  # x, y, visibility (if available)

Veja detalhes completos de predict detalhes do modo na página Previsão.

Exportação

Exporta um modelo YOLO26 Pose para um formato diferente como ONNX, CoreML, etc. Isto permite que implementes o teu modelo em várias plataformas e dispositivos para inferência em tempo real.

Exemplo
from ultralytics import YOLO

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

# Export the model
model.export(format="onnx")

Os formatos de exportação disponíveis para YOLO26-pose estão na tabela abaixo. Podes exportar para qualquer formato usando o format, ex: format='onnx' ou format='engine'. Você pode prever ou validar diretamente em modelos exportados, ex: yolo predict model=yolo26n-pose.onnx. Exemplos de uso são apresentados para o teu modelo após a conclusão da exportação.

Formatoformat ArgumentoModeloMetadadosArgumentos
PyTorch-yolo26n-pose.pt-
TorchScripttorchscriptyolo26n-pose.torchscriptimgsz, half, dynamic, optimize, nms, batch, device
ONNXonnxyolo26n-pose.onnximgsz, half, dynamic, simplify, opset, nms, batch, device
OpenVINOopenvinoyolo26n-pose_openvino_model/imgsz, half, dynamic, int8, nms, batch, data, fraction, device
TensorRTengineyolo26n-pose.engineimgsz, half, dynamic, simplify, workspace, int8, nms, batch, data, fraction, device
CoreMLcoremlyolo26n-pose.mlpackageimgsz, dynamic, half, int8, nms, batch, device
TF SavedModelsaved_modelyolo26n-pose_saved_model/imgsz, keras, int8, nms, batch, data, fraction, device
TF GraphDefpbyolo26n-pose.pbimgsz, batch, device
TF Litetfliteyolo26n-pose.tfliteimgsz, half, int8, nms, batch, data, fraction, device
TF Edge TPUedgetpuyolo26n-pose_edgetpu.tfliteimgsz, int8, data, fraction, device
TF.jstfjsyolo26n-pose_web_model/imgsz, half, int8, nms, batch, data, fraction, device
PaddlePaddlepaddleyolo26n-pose_paddle_model/imgsz, batch, device
MNNmnnyolo26n-pose.mnnimgsz, batch, int8, half, device
NCNNncnnyolo26n-pose_ncnn_model/imgsz, half, batch, device
IMX500imxyolo26n-pose_imx_model/imgsz, int8, data, fraction, nms, device
RKNNrknnyolo26n-pose_rknn_model/imgsz, batch, name, device
ExecuTorchexecutorchyolo26n-pose_executorch_model/imgsz, batch, device
Axeleraaxelerayolo26n-pose_axelera_model/imgsz, batch, int8, data, fraction, device

Veja detalhes completos de export na página de Exportação.

FAQ

O que é a Estimativa de Pose com Ultralytics YOLO26 e como funciona?

A estimativa de pose com Ultralytics YOLO26 envolve a identificação de pontos específicos, conhecidos como keypoints, numa imagem. Estes keypoints representam tipicamente articulações ou outras características importantes do objeto. O output inclui as [x, y] coordenadas e pontuações de confiança para cada ponto. Os modelos YOLO26-pose são especificamente concebidos para esta tarefa e usam o -pose sufixo, tal como yolo26n-pose.pt. Estes modelos são pré-treinados em datasets como COCO keypoints e podem ser usados para várias tarefas de estimativa de pose. Para mais informações, visita a Página de Estimativa de Pose.

Como posso treinar um modelo YOLO26-pose num dataset personalizado?

O treino de um modelo YOLO26-pose num dataset personalizado envolve carregar um modelo, seja um novo modelo definido por um ficheiro YAML ou um modelo pré-treinado. Podes então iniciar o processo de treino usando o teu dataset e parâmetros especificados.

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-pose.yaml")  # build a new model from YAML
model = YOLO("yolo26n-pose.pt")  # load a pretrained model (recommended for training)

# Train the model
results = model.train(data="your-dataset.yaml", epochs=100, imgsz=640)

Para detalhes abrangentes sobre o treino, consulta a Secção de Treino. Também podes usar Plataforma Ultralytics para uma abordagem sem código para treinar modelos personalizados de estimativa de pose.

Como valido um modelo YOLO26-pose treinado?

A validação de um modelo YOLO26-pose envolve avaliar a sua precisão usando os mesmos parâmetros de dataset retidos durante o treino. Aqui tens um exemplo:

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-pose.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

Para mais informações, visite a Secção de Val.

Posso exportar um modelo YOLO26-pose para outros formatos, e como?

Sim, podes exportar um modelo YOLO26-pose para vários formatos como ONNX, CoreML, TensorRT, e mais. Isto pode ser feito usando Python ou a Interface de Linha de Comandos (CLI).

from ultralytics import YOLO

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

# Export the model
model.export(format="onnx")

Consulta o Secção de Exportação para mais detalhes. Modelos exportados podem ser implementados em dispositivos edge para aplicações em tempo real como rastreio de fitness, análise desportiva, ou robótica.

Quais são os modelos Ultralytics YOLO26-pose disponíveis e as suas métricas de desempenho?

O Ultralytics YOLO26 oferece vários modelos de pose pré-treinados como YOLO26n-pose, YOLO26s-pose, YOLO26m-pose, entre outros. Estes modelos diferem em tamanho, precisão (mAP), e velocidade. Por exemplo, o modelo YOLO26n-pose alcança um mAPpose50-95 de 50.0 e um mAPpose50 de 81.0. Para uma lista completa e detalhes de desempenho, visita a Secção de Modelos.

Comentários