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 |
|---|
![]() |
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.
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 windowsArgumentos do DistanceCalculation()#
Aqui tens uma tabela com os argumentos do DistanceCalculation:
| Argumento | Tipo | Predefinição | Descrição |
|---|---|---|---|
model | str | None | Caminho para um ficheiro de modelo YOLO da Ultralytics. |
line_width | int | 2 | Espessura da linha para as caixas, pontos-chave e contagens que a solução desenha. |
verbose | bool | True | Ativa 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.
| Argumento | Tipo | Predefinição | Descrição |
|---|---|---|---|
tracker | str | 'botsort.yaml' | Especifica o algoritmo de rastreamento a utilizar. Opções integradas: botsort.yaml, bytetrack.yaml, ocsort.yaml, deepocsort.yaml, fasttrack.yaml, tracktrack.yaml. |
conf | float | 0.25 | Define o limiar de confiança para as deteções; valores mais baixos permitem que mais objetos sejam rastreados, mas podem incluir falsos positivos. |
iou | float | 0.7 | Define o limiar de Intersection over Union (IoU) para filtrar deteções sobrepostas. |
classes | list | None | Filtra resultados por índice de classe. Por exemplo, classes=[0, 2, 3] rastreia apenas as classes especificadas. |
device | str | None | Especifica 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:
| Argumento | Tipo | Predefinição | Descrição |
|---|---|---|---|
show | bool | False | Se True, exibe as imagens ou vídeos anotados em uma janela. Útil para feedback visual imediato durante o desenvolvimento ou teste. |
show_conf | bool | True | Exibe 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_labels | bool | True | Exibe 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:
- Extrai os centroides (pontos centrais) das bounding boxes selecionadas
- Calcula a distância Euclidiana entre esses centroides em pixels
- 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
DistanceCalculationdo módulosolutionsda 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
DistanceCalculationpara 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
DistanceCalculationno Ultralytics YOLO26 incluem:model: Caminho para o arquivo do modelo YOLO26.tracker: Algoritmo de rastreamento a usar (as Soluções usambotsort.yamlpor 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.
