guides/trackzone/

[giscus[bot]]

guides/trackzone/

Discover how TrackZone leverages Ultralytics YOLO11 to precisely track objects within specific zones, enabling real-time insights for crowd analysis, surveillance, and targeted monitoring.

Code Sample

Python

import cv2

from ultralytics import solutions

cap = cv2.VideoCapture("path/to/video/file.mp4")
assert cap.isOpened(), "Error reading video file"
w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS))

# Define region points
region_points = [(150, 150), (1130, 150), (1130, 570), (150, 570)]

# Video writer
video_writer = cv2.VideoWriter("object_counting_output.avi", cv2.VideoWriter_fourcc(*"mp4v"), fps, (w, h))

# Init TrackZone (Object Tracking in Zones, not complete frame)
trackzone = solutions.TrackZone(
    show=True,  # Display the output
    region=region_points,  # Pass region points
    model="yolo11n.pt",  # You can use any model that Ultralytics support, i.e. YOLOv9, YOLOv10
    # line_width=2,  # Adjust the line width for bounding boxes and text display
    # classes=[0, 2],  # If you want to count specific classes i.e. person and car with COCO pretrained model.
)

# Process video
while cap.isOpened():
    success, im0 = cap.read()
    if not success:
        print("Video frame is empty or video processing has been successfully completed.")
        break
    im0 = trackzone.trackzone(im0)
    video_writer.write(im0)

cap.release()
video_writer.release()
cv2.destroyAllWindows()

CLI

# Run a trackzone example
yolo solutions trackzone show=True

# Pass a source video
yolo solutions trackzone show=True source="path/to/video/file.mp4"

# Pass region coordinates
yolo solutions trackzone show=True region=[(150, 150), (1130, 150), (1130, 570), (150, 570)]

Documentation

https://docs.ultralytics.com/guides/trackzone/

[UltralyticsAssistant]

👋 Hello, thank you for your interest in Ultralytics 🚀! We recommend exploring the TrackZone Guide for more details on how TrackZone leverages Ultralytics YOLO models for precise object tracking in designated zones. Additionally, you may find the Docs helpful for discovering more Python and CLI usage examples, as well as answers to frequently asked questions.

If this is a 🐛 Bug Report, kindly provide a minimum reproducible example to help us investigate effectively.

If this is a custom usage ❓ Question, please share more specific details regarding your use case, such as the types of objects you want to track, zone definitions, and logs or examples if available. This will help us provide more targeted support.

Join the Ultralytics community to connect with other users and developers! You can chat in real-time on Discord 🎧, participate in in-depth discussions on Discourse, or contribute to threads on our Subreddit. Sharing knowledge and ideas with the community is always encouraged!

Upgrade

Ensure your ultralytics package and dependencies are up-to-date. Run the following command in a Python>=3.8 environment with PyTorch>=1.8:

pip install -U ultralytics

Environments

YOLO works in multiple verified environments with pre-installed dependencies:

• Notebooks with free GPU:
• Google Cloud Deep Learning VM. Refer to the GCP Quickstart Guide
• Amazon Deep Learning AMI. Check out the AWS Quickstart Guide
• Docker Image. See the Docker Quickstart Guide

Status

If the above badge is green, it means all Ultralytics CI tests are passing. These tests verify proper functionality of YOLO Modes and Tasks on macOS, Windows, and Ubuntu with daily and per-commit checks.

This is an automated response 🤖, but rest assured that an Ultralytics engineer will review and assist you further soon!

[moshiour]

Hi,
Its a nice feature to yolo! How do make it counting on top of it? Thank you in advance!

[glenn-jocher]

@moshiour thank you for your kind words! To add counting functionality on top of tracking with YOLO11, you can use the persist argument in TrackZone to maintain unique object IDs, or for region-based counting, define zones and count objects entering or exiting them. Here's a helpful guide for object counting in zones: https://docs.ultralytics.com/guides/trackzone/. Let us know if you have more questions!

[RizwanMunawar]

@Muhammad-237 Hi, We currently don't support the counting feature with TrackZone, but It's on our TODO's list, and we will release this feature soon! Thank you! In the meantime, you can explore our documentation available at: https://docs.ultralytics.com/guides/object-counting/#__tabbed_1_1

[Muhammad-237]

can we do this on two or more different region in the same frame

[Muhammad-237]

also how can we combine both the trackzone and counting object

[glenn-jocher]

@Muhammad-237 to combine TrackZone and object counting, you can use TrackZone to track objects in specific zones of interest and integrate an object counting mechanism by tallying the tracked objects for each frame. Implement multiple TrackZone instances or process distinct regions for targeted counting. Both features can leverage YOLO11's capabilities simultaneously, keeping their regions and logic distinct as needed. Let me know if you need further assistance implementing this!

[Muhammad-237]

code you please provide a code example for using both trackzone and counting

[RizwanMunawar]

@Muhammad-237 Hi, We currently don't support the counting feature with TrackZone, but It's on our TODO's list, and we will release this feature soon! Thank you! In meantime, you can explore our documentation available at: https://docs.ultralytics.com/guides/object-counting/#__tabbed_1_1