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 centroide da caixa delimitadora é usado para calcular a distância das caixas delimitadoras destacadas pelo usuário.

Elementos visuais#

Cálculo de distância usando Ultralytics YOLO26

Vantagens do cálculo de distância#

• Precisão de localização: melhora o posicionamento espacial preciso em tarefas de visão computacional.
• Estimativa de tamanho: permite estimar o tamanho dos objetos para uma melhor compreensão contextual.
• Compreensão da cena: melhora a compreensão de cenas 3D para uma tomada de decisões mais eficaz em aplicações como veículos autônomos e sistemas de vigilância.
• Prevenção de colisões: permite que os sistemas detectem possíveis colisões monitorando as distâncias entre objetos em movimento.
• Análise espacial: facilita a análise das relações e interações entre objetos no ambiente monitorado.

Calcule distâncias com YOLO26#

A solução DistanceCalculation rastreia objetos entre os quadros e mede a distância euclidiana, em pixels, entre os centroides de duas caixas delimitadoras quaisquer 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 que os conecta e ver a distância; clique com o botão direito para limpar a seleção.

import cv2

from ultralytics import solutions

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

# Gravador de vídeo
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))

# Inicializa o objeto de cálculo de distância
distancecalculator = solutions.DistanceCalculation(
    model="yolo26n.pt",  # caminho para o arquivo do modelo YOLO26.
    show=True,  # # Apresenta o resultado
)

# Processa o vídeo
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)  # acessa a saída

    video_writer.write(results.plot_im)  # escreve o quadro processado.

cap.release()
video_writer.release()
cv2.destroyAllWindows()  # fecha todas as janelas abertas

Argumentos de DistanceCalculation()#

Aqui está uma tabela com os argumentos de DistanceCalculation:

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

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

Detalhes da implementação#

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

1. Extrai os centroides (pontos centrais) das caixas delimitadoras selecionadas
2. Calcula a distância euclidiana entre esses centroides em pixels
3. Exibe a distância no quadro com uma linha conectando os objetos

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

Aplicações#

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

• Análise do varejo: mede a proximidade dos clientes aos produtos e analisa a eficácia do layout da loja
• Segurança industrial: monitora as distâncias seguras entre trabalhadores e máquinas
• Gestão do trânsito: analisa o espaçamento entre veículos e detecta quando um veículo segue outro muito de perto
• Análise esportiva: calcula as distâncias entre jogadores, a bola e posições importantes no campo
• Saúde: garante o distanciamento adequado em áreas de espera e monitora a movimentação dos pacientes
• Robótica: permite que os robôs mantenham distâncias adequadas de obstáculos e pessoas

Perguntas frequentes#