Mapas de calor de seguimiento de objetos con Ultralytics YOLO26#
La Heatmap solution en Ultralytics YOLO26 rastrea objetos a través de fotogramas de vídeo y superpone su intensidad de movimiento acumulada en cada fotograma, de modo que las zonas con mucho tráfico brillan en tonos cálidos mientras que las áreas tranquilas se mantienen frías. Construida sobre el object tracking de YOLO26, convierte cualquier vídeo en un mapa de actividad espacial que revela el flujo de tráfico, el movimiento de multitudes y las zonas de permanencia con una sola llamada en Python o comando de CLI.
Watch: Heatmaps using Ultralytics YOLO26
¿Por qué usar mapas de calor para el análisis de vídeo?#
- Detecta patrones de actividad de un vistazo: La intensidad se acumula donde los objetos rastreados pasan tiempo, por lo que los carriles de mucho tráfico, los estantes populares o los cuellos de botella de multitudes destacan sin necesidad de revisar fotograma a fotograma manualmente.
- Seguimiento integrado: La solución ejecuta la detección y el seguimiento de YOLO26 internamente, por lo que no hay una canalización de seguimiento separada que configurar.
- Recuento en la misma pasada: Pasa un
regionpara contar los objetos que entran y salen de una zona mientras se genera el mapa de calor, combinando dos tareas analíticas en una sola ejecución.
Aplicaciones en el mundo real#
| Transporte | Comercio minorista |
|---|---|
![]() | ![]() |
| Mapa de calor de transporte de Ultralytics YOLO | Mapa de calor minorista de Ultralytics YOLO |
Cómo generar mapas de calor con Ultralytics YOLO#
Ejecuta la solución de mapa de calor en una fuente de vídeo desde la CLI o Python. El ejemplo de Python escribe los fotogramas procesados en un archivo de vídeo de salida:
# Run a heatmap example
yolo solutions heatmap show=True
# Pass a source video
yolo solutions heatmap source="path/to/video.mp4"
# Pass a custom colormap
yolo solutions heatmap colormap=cv2.COLORMAP_INFERNO
# Heatmaps + object counting
yolo solutions heatmap region="[(20, 400), (1080, 400), (1080, 360), (20, 360)]"Argumentos de Heatmap()#
Aquí tienes una tabla con los argumentos de Heatmap:
| Argumento | Tipo | Predeterminado | Descripción |
|---|---|---|---|
model | str | None | Ruta a un archivo de modelo YOLO de Ultralytics. |
colormap | int | cv2.COLORMAP_DEEPGREEN | Mapa de colores a usar para el mapa de calor. |
show_in | bool | True | Flag para controlar si se muestran los conteos de entrada en la transmisión de vídeo. |
show_out | bool | True | Flag para controlar si se muestran los conteos de salida en la transmisión de vídeo. |
region | list o dict | None | Puntos que definen la región de interés, ya sea una lista de tuplas (x, y) o un diccionario que mapea nombres de regiones a listas de puntos para múltiples regiones (solo RegionCounter). Cuando es None, las soluciones que requieren una región recurren a un valor predeterminado. |
line_width | int | 2 | Grosor de línea para las cajas, puntos clave y recuentos que dibuja la solución. |
verbose | bool | True | Habilita el registro por fotograma de la solución sobre la forma de entrada, los recuentos de clases y la velocidad de procesamiento. La llamada de seguimiento en sí siempre es silenciosa. |
También puedes aplicar diferentes argumentos de track en la solución Heatmap.
| Argumento | Tipo | Predeterminado | Descripción |
|---|---|---|---|
tracker | str | 'botsort.yaml' | Especifica el algoritmo de seguimiento que se va a utilizar. Opciones integradas: botsort.yaml, bytetrack.yaml, ocsort.yaml, deepocsort.yaml, fasttrack.yaml, tracktrack.yaml. |
conf | float | 0.25 | Establece el umbral de confianza para las detecciones; valores más bajos permiten el seguimiento de más objetos, pero pueden incluir falsos positivos. |
iou | float | 0.7 | Establece el umbral de Intersection over Union (IoU) para filtrar detecciones superpuestas. |
classes | list | None | Filtra los resultados por índice de clase. Por ejemplo, classes=[0, 2, 3] solo realiza el seguimiento de las clases especificadas. |
device | str | None | Especifica el dispositivo para la inferencia (por ejemplo, cpu, cuda:0 o 0). Permite a los usuarios seleccionar entre CPU, una GPU específica u otros dispositivos de computación para la ejecución del modelo. |
Además, los argumentos de visualización compatibles se enumeran a continuación:
| Argumento | Tipo | Predeterminado | Descripción |
|---|---|---|---|
show | bool | False | Si es True, muestra las imágenes o vídeos anotados en una ventana. Es útil para obtener retroalimentación visual inmediata durante el desarrollo o las pruebas. |
show_conf | bool | True | Muestra la puntuación de confianza para cada detección junto a la etiqueta. Proporciona información sobre la certeza del modelo para cada detección. |
show_labels | bool | True | Muestra las etiquetas para cada detección en la salida visual. Proporciona una comprensión inmediata de los objetos detectados. |
Mapas de colores de mapas de calor#
El argumento colormap acepta cualquier OpenCV colormap. Pasa la constante del módulo cv2, por ejemplo colormap=cv2.COLORMAP_INFERNO:
| Nombre del mapa de colores | Descripción |
|---|---|
cv2.COLORMAP_AUTUMN | Mapa de colores Autumn |
cv2.COLORMAP_BONE | Mapa de colores Bone |
cv2.COLORMAP_JET | Mapa de colores Jet |
cv2.COLORMAP_WINTER | Mapa de colores Winter |
cv2.COLORMAP_RAINBOW | Mapa de colores Rainbow |
cv2.COLORMAP_OCEAN | Mapa de colores Ocean |
cv2.COLORMAP_SUMMER | Mapa de colores Summer |
cv2.COLORMAP_SPRING | Mapa de colores Spring |
cv2.COLORMAP_COOL | Mapa de colores Cool |
cv2.COLORMAP_HSV | Mapa de colores HSV (Tono, Saturación, Valor) |
cv2.COLORMAP_PINK | Mapa de colores Pink |
cv2.COLORMAP_HOT | Mapa de colores Hot |
cv2.COLORMAP_PARULA | Mapa de colores Parula |
cv2.COLORMAP_MAGMA | Mapa de colores Magma |
cv2.COLORMAP_INFERNO | Mapa de colores Inferno |
cv2.COLORMAP_PLASMA | Mapa de colores Plasma |
cv2.COLORMAP_VIRIDIS | Mapa de colores Viridis |
cv2.COLORMAP_CIVIDIS | Mapa de colores Cividis |
cv2.COLORMAP_TWILIGHT | Mapa de colores Twilight |
cv2.COLORMAP_TWILIGHT_SHIFTED | Mapa de colores Twilight desplazado |
cv2.COLORMAP_TURBO | Mapa de colores Turbo |
cv2.COLORMAP_DEEPGREEN | Mapa de colores Deep Green |
Cómo funcionan los mapas de calor#
La Heatmap solution amplía la clase ObjectCounter. En el primer fotograma procesado, crea una capa de intensidad en blanco que coincide con el tamaño del fotograma. A continuación, cada fotograma se procesa en dos pasos:
- El seguimiento de YOLO26 detecta y sigue a cada objeto en el fotograma
- Para cada objeto rastreado, la intensidad del mapa de calor aumenta dentro de una región circular centrada en su cuadro delimitador
Una vez por fotograma, la capa de intensidad acumulada se normaliza, se colorea con el mapa de colores seleccionado y se combina con el fotograma original. La superposición aparece tan pronto como se rastrea al menos un objeto; los fotogramas sin objetos rastreados se muestran sin la superposición del mapa de calor.
El resultado es una visualización dinámica que se acumula con el tiempo, revelando patrones de tráfico, movimientos de multitudes u otros comportamientos espaciales en tus datos de vídeo. Cuando se establece un region, la solución también cuenta objetos que entran y salen de esa región mientras se genera el mapa de calor.
Conclusión#
La solución Ultralytics YOLO26 Heatmap convierte los resultados de seguimiento de objetos en una superposición de actividad intuitiva con unas pocas líneas de código. Para ir más allá, combínala con el object counting, explora otras Ultralytics Solutions o lee sobre el tracking mode subyacente.
FAQ#
Ultralytics YOLO26 genera mapas de calor rastreando objetos a través de los fotogramas de vídeo y acumulando un valor de intensidad en la ubicación de cada objeto rastreado; luego, colorea el resultado y lo fusiona con el fotograma original. Las áreas donde los objetos aparecen con frecuencia o se detienen acumulan una mayor intensidad y se renderizan en colores más cálidos. Para ver las opciones de configuración, consulta la sección
Heatmap()Arguments.Usa
cv2.VideoWriterde OpenCV y escriberesults.plot_impara cada fotograma procesado, tal como se muestra en el main example. El atributoplot_imcontiene el fotograma con la superposición del mapa de calor ya aplicada.Sí. Pasa un argumento
regionaHeatmap()con puntos de línea, rectángulo o polígono, y la solución contará los objetos que entran y salen de esa región mientras se genera el mapa de calor. Los resultados devueltos incluyenin_count,out_county recuentos por clase. Consulta la object counting guide para obtener detalles sobre la configuración de regiones.Pasa el argumento
classesaHeatmap()con los índices de clase que deseas conservar. Por ejemplo,classes=[0, 2]genera el mapa de calor únicamente a partir de personas y coches (índices de clase de COCO 0 y 2):import cv2 from ultralytics import solutions cap = cv2.VideoCapture("path/to/video.mp4") heatmap = solutions.Heatmap(show=True, model="yolo26n.pt", classes=[0, 2]) while cap.isOpened(): success, im0 = cap.read() if not success: break results = heatmap(im0) cap.release() cv2.destroyAllWindows()Los mapas de calor de Ultralytics YOLO26 integran object detection, seguimiento, acumulación de intensidad y renderizado de superposición en una sola llamada, mientras que las herramientas genéricas como OpenCV o Matplotlib exigen que construyas ese flujo de trabajo por tu cuenta. La solución procesa secuencias de vídeo en tiempo real y admite seguimiento persistente y mapas de calor personalizables de serie. Para obtener detalles sobre el modelo subyacente, consulta la YOLO26 model page.

