YOLO Vision 2026:

Cálculo de distância usando Ultralytics YOLO26#

O que é Cálculo de distância?#

O cálculo de distância é o processo de medir o espaço entre dois objetos detectados em uma imagem ou quadro de vídeo. No caso do Ultralytics YOLO26, o centróide da bounding box é empregado para calcular a distância para as caixas delimitadoras destacadas pelo usuário.



Watch: How to estimate distance between detected objects with Ultralytics YOLO in Pixels 🚀

Visuais#

Cálculo de distância usando Ultralytics YOLO26
Ultralytics YOLO26 Distance Calculation

Vantagens do Cálculo de distância#

  • Precisão de Localização: Melhora o posicionamento espacial preciso em tarefas de computer vision.
  • Estimativa de tamanho: Permite a estimativa do tamanho do objeto para uma melhor compreensão contextual.
  • Compreensão de Cena: Melhora a compreensão de cenas 3D para uma melhor tomada de decisão em aplicações como autonomous vehicles e sistemas de vigilância.
  • Prevenção de colisões: Permite que os sistemas detectem colisões potenciais monitorando distâncias entre objetos em movimento.
  • Análise espacial: Facilita a análise das relações e interações entre objetos dentro do ambiente monitorado.
Cálculo de distância
  • Clique em quaisquer duas bounding boxes com o botão esquerdo do mouse para calcular a distância.
  • Use o botão direito do mouse para excluir todos os pontos desenhados.
  • Clique com o botão esquerdo em qualquer lugar do frame para adicionar novos pontos.
A distância é uma estimativa

A distância é uma estimativa e pode não ser totalmente precisa porque é calculada usando dados 2D, que carecem de informações de profundidade.

Calcula distâncias com YOLO26#

A solução DistanceCalculation rastreia objetos entre quadros e mede a distância Euclidiana, em pixels, entre os centróides de quaisquer duas caixas delimitadoras que você selecionar com o mouse. Execute o exemplo abaixo e, em seguida, clique com o botão esquerdo em dois objetos para desenhar a linha de conexão e ler a distância; clique com o botão direito para limpar sua seleção.

Cálculo de distância usando Ultralytics YOLO
import cv2

from ultralytics import solutions

cap = cv2.VideoCapture("path/to/video.mp4")
assert cap.isOpened(), "Error reading video file"

# Video writer
w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS))
video_writer = cv2.VideoWriter("distance_output.avi", cv2.VideoWriter_fourcc(*"mp4v"), fps, (w, h))

# Initialize distance calculation object
distancecalculator = solutions.DistanceCalculation(
    model="yolo26n.pt",  # path to the YOLO26 model file.
    show=True,  # display the output
)

# Process video
while cap.isOpened():
    success, im0 = cap.read()

    if not success:
        print("Video frame is empty or processing is complete.")
        break

    results = distancecalculator(im0)

    print(results)  # access the output

    video_writer.write(results.plot_im)  # write the processed frame.

cap.release()
video_writer.release()
cv2.destroyAllWindows()  # destroy all opened windows

Argumentos do DistanceCalculation()#

Aqui tens uma tabela com os argumentos do DistanceCalculation:

ArgumentoTipoPredefiniçãoDescrição
modelstrNoneCaminho para um ficheiro de modelo YOLO da Ultralytics.
line_widthint2Espessura da linha para as caixas, pontos-chave e contagens que a solução desenha.
verboseboolTrueAtiva o registro por quadro da solução contendo formato de entrada, contagens de classes e velocidade de processamento. A chamada de rastreamento em si é sempre silenciosa.

Você também pode fazer uso de vários argumentos do track na solução DistanceCalculation.

ArgumentoTipoPredefiniçãoDescrição
trackerstr'botsort.yaml'Especifica o algoritmo de rastreamento a utilizar. Opções integradas: botsort.yaml, bytetrack.yaml, ocsort.yaml, deepocsort.yaml, fasttrack.yaml, tracktrack.yaml.
conffloat0.25Define o limiar de confiança para as deteções; valores mais baixos permitem que mais objetos sejam rastreados, mas podem incluir falsos positivos.
ioufloat0.7Define o limiar de Intersection over Union (IoU) para filtrar deteções sobrepostas.
classeslistNoneFiltra resultados por índice de classe. Por exemplo, classes=[0, 2, 3] rastreia apenas as classes especificadas.
devicestrNoneEspecifica o dispositivo para inferência (por exemplo, cpu, cuda:0 ou 0). Permite aos utilizadores selecionar entre CPU, uma GPU específica ou outros dispositivos de computação para a execução do modelo.

Além disso, os seguintes argumentos de visualização estão disponíveis:

ArgumentoTipoPredefiniçãoDescrição
showboolFalseSe True, exibe as imagens ou vídeos anotados em uma janela. Útil para feedback visual imediato durante o desenvolvimento ou teste.
show_confboolTrueExibe a pontuação de confiança para cada detecção ao lado do rótulo. Fornece uma visão sobre a certeza do modelo para cada detecção.
show_labelsboolTrueExibe rótulos para cada detecção na saída visual. Fornece compreensão imediata dos objetos detectados.

Detalhes de implementação#

A classe DistanceCalculation funciona rastreando objetos entre quadros de vídeo e calculando a distância Euclidiana entre os centróides das caixas delimitadoras selecionadas. Quando você clica em dois objetos, a solução:

  1. Extrai os centroides (pontos centrais) das bounding boxes selecionadas
  2. Calcula a distância Euclidiana entre esses centroides em pixels
  3. Exibe a distância no frame com uma linha conectando os objetos

A implementação usa o método mouse_event_for_distance para lidar com interações do mouse, permitindo que os usuários selecionem objetos e limpem seleções conforme necessário. O método process lida com o processamento quadro a quadro, rastreando objetos e calculando distâncias.

Aplicações#

O cálculo de distância com YOLO26 tem inúmeras aplicações práticas:

  • Análise de varejo: Meça a proximidade do cliente com os produtos e analise a eficácia do layout da loja
  • Segurança industrial: Monitore distâncias seguras entre trabalhadores e máquinas
  • Gerenciamento de tráfego: Analise o espaçamento entre veículos e detecte direção perigosa (tailgating)
  • Análise esportiva: Calcule distâncias entre jogadores, a bola e posições-chave no campo
  • Saúde: Garanta o distanciamento adequado em áreas de espera e monitore o movimento do paciente
  • Robótica: Permita que robôs mantenham distâncias adequadas de obstáculos e pessoas

FAQ#

  • Para calcular distâncias entre objetos usando Ultralytics YOLO26, você precisa identificar os centróides das caixas delimitadoras dos objetos detectados. Este processo envolve a inicialização da classe DistanceCalculation do módulo solutions da Ultralytics e o uso das saídas de rastreamento do modelo para calcular as distâncias.

  • Usar o cálculo de distância com Ultralytics YOLO26 oferece várias vantagens:

    • Precisão de localização: Fornece posicionamento espacial preciso para objetos.
    • Estimativa de tamanho: Ajuda a estimar tamanhos físicos, contribuindo para uma melhor compreensão contextual.
    • Compreensão da cena: Melhora a compreensão de cenas 3D, auxiliando na melhor tomada de decisão em aplicações como direção autônoma e vigilância.
    • Processamento em tempo real: Realiza cálculos instantaneamente, tornando-o adequado para análise de vídeo ao vivo.
    • Capacidades de Integração: Funciona perfeitamente com outras soluções do YOLO26, como object tracking e speed estimation.
  • Sim, você pode realizar o cálculo de distância em fluxos de vídeo em tempo real com o Ultralytics YOLO26. O processo envolve a captura de quadros de vídeo usando OpenCV, a execução da object detection do YOLO26 e o uso da classe DistanceCalculation para calcular distâncias entre objetos em quadros sucessivos. Para uma implementação detalhada, consulte o video stream example.

  • Para excluir pontos desenhados durante o cálculo de distância com o Ultralytics YOLO26, você pode usar um clique com o botão direito do mouse. Esta ação limpará todos os pontos que você desenhou. Para mais detalhes, consulte a seção de notas sob o distance calculation example.

  • Os principais argumentos para inicializar a classe DistanceCalculation no Ultralytics YOLO26 incluem:

    • model: Caminho para o arquivo do modelo YOLO26.
    • tracker: Algoritmo de rastreamento a usar (as Soluções usam botsort.yaml por padrão).
    • conf: Limiar de confiança para detecções.
    • show: Sinalizador para exibir a saída.

    Para uma lista exaustiva e valores padrão, consulte os arguments of DistanceCalculation.

Comentários