Link to this sectionCálculo de distância usando Ultralytics YOLO26#
Link to this sectionO que é Cálculo de distância?#
O cálculo de distância é o processo de medir o espaço entre dois objetos detectados dentro de uma imagem ou frame de vídeo. No caso do Ultralytics YOLO26, o centroide da bounding box é usado para calcular a distância entre as bounding boxes destacadas pelo usuário.
Watch: How to estimate distance between detected objects with Ultralytics YOLO in Pixels 🚀
Link to this sectionVisuais#
| Cálculo de distância usando Ultralytics YOLO26 |
|---|
![]() |
Link to this sectionVantagens 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 a estimativa do tamanho do objeto para uma melhor compreensão contextual.
- Compreensão da cena: Melhora a compreensão de cenas em 3D para uma melhor tomada de decisão em aplicações como veículos autônomos 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.
Link to this sectionCalcula distâncias com YOLO26#
A solução DistanceCalculation rastreia objetos através de quadros e mede a distância euclidiana, em pixels, entre os centroides de quaisquer duas caixas delimitadoras que selecionares com o rato. Executa o exemplo abaixo e, em seguida, clica com o botão esquerdo em dois objetos para desenhar a linha de conexão e ler a distância; clica com o botão direito para limpar a tua 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 windowsLink to this sectionArgumentos da DistanceCalculation()#
Aqui está uma tabela com os argumentos da DistanceCalculation:
| Argumento | Tipo | Predefinição | Descrição |
|---|---|---|---|
model | str | None | Caminho para um ficheiro de modelo YOLO da Ultralytics. |
Você também pode fazer uso de vários argumentos de track na solução DistanceCalculation.
| Argumento | Tipo | Predefinição | Descrição |
|---|---|---|---|
tracker | str | 'botsort.yaml' | Especifica o algoritmo de rastreamento a ser usado. As opções integradas são: botsort.yaml, bytetrack.yaml, ocsort.yaml, deepocsort.yaml, fasttrack.yaml, tracktrack.yaml. |
conf | float | 0.1 | 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. |
verbose | bool | True | Controla a exibição dos resultados de rastreio, fornecendo uma saída visual dos objetos rastreados. |
device | str | None | Especifica o dispositivo para inferência (p. ex., 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 numa janela. Útil para feedback visual imediato durante o desenvolvimento ou teste. |
line_width | int or None | None | Especifica a largura da linha das caixas delimitadoras. Se None, a largura da linha é ajustada automaticamente com base no tamanho da imagem. Proporciona personalização visual para maior clareza. |
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. |
Link to this sectionDetalhes de implementação#
A classe DistanceCalculation funciona rastreando objetos através de frames de vídeo e calculando a distância Euclidiana entre os centroides das bounding boxes 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 frame a frame, rastreando objetos e calculando distâncias.
Link to this sectionAplicaçõ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
Link to this sectionFAQ#
Link to this sectionComo calculo distâncias entre objetos usando Ultralytics YOLO26?#
Para calcular distâncias entre objetos usando o Ultralytics YOLO26, você precisa identificar os centroides das bounding boxes dos objetos detectados. Esse processo envolve inicializar a classe DistanceCalculation do módulo solutions da Ultralytics e usar as saídas de rastreamento do modelo para calcular as distâncias.
Link to this sectionQuais são as vantagens de usar o cálculo de distância com Ultralytics YOLO26?#
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 YOLO26, como rastreamento de objetos e estimativa de velocidade.
Link to this sectionPosso realizar cálculo de distância em streams de vídeo em tempo real com Ultralytics YOLO26?#
Sim, podes realizar o cálculo de distâncias 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 de deteção de objetos com o YOLO26 e o uso da classe DistanceCalculation para calcular distâncias entre objetos em quadros sucessivos. Para uma implementação detalhada, vê o exemplo de fluxo de vídeo.
Link to this sectionComo excluo pontos desenhados durante o cálculo de distância usando Ultralytics YOLO26?#
Para eliminar pontos desenhados durante o cálculo de distância com o Ultralytics YOLO26, podes usar um clique com o botão direito do rato. Esta ação limpará todos os pontos que desenhaste. Para mais detalhes, consulta a secção de notas sob o exemplo de cálculo de distância.
Link to this sectionQuais são os principais argumentos para inicializar a classe DistanceCalculation no Ultralytics YOLO26?#
Os principais argumentos para inicializar a classe DistanceCalculation no Ultralytics YOLO26 incluem:
model: Caminho para o arquivo de modelo YOLO26.tracker: Algoritmo de rastreamento a ser usado (o padrão é 'botsort.yaml').conf: Limite de confiança para detecções.show: Sinalizador para exibir a saída.
Para uma lista exaustiva e valores padrão, veja os argumentos de DistanceCalculation.
