=== "CLI"

    ```bash
    # Run a trackzone example
    yolo solutions trackzone show=True

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

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

    TrackZone relies on the `region` list to know which part of the frame to monitor. Define the polygon to match the physical zone you care about (doors, gates, etc.), and keep `show=True` enabled while configuring so you can verify the overlay aligns with the video feed.

=== "Python"

    ```python
    import cv2

    from ultralytics import solutions

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

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

    # 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("trackzone_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="yolo26n.pt",  # use any model that Ultralytics supports, e.g., YOLOv9, YOLOv10
        # line_width=2,  # adjust the line width for bounding boxes and text display
    )

    # Process video
    while cap.isOpened():
        success, im0 = cap.read()
        if not success:
            print("Video frame is empty or processing is complete.")
            break

        results = trackzone(im0)

        # print(results)  # access the output

        video_writer.write(results.plot_im)  # write the video file

    cap.release()
    video_writer.release()
    cv2.destroyAllWindows()  # destroy all opened windows
    ```

- Each entry in `region` is an `(x, y)` pixel coordinate in the video frame. List the points in the order they should be connected around the perimeter of the area you want to monitor.
- Coordinates are tied to the frame resolution, so a region sized for a 1280×720 feed will not line up with a 640×480 one. Keep `show=True` while configuring so you can confirm the overlay matches your feed.
- `TrackZone` reduces the points to their [convex hull](https://en.wikipedia.org/wiki/Convex_hull), so a concave shape is simplified to the smallest convex polygon that contains all of its points. For non-convex shapes or several separate areas, use the [RegionCounter](region-counting.md) solution instead.
- If you omit `region` entirely, a default zone of `[(75, 75), (565, 75), (565, 285), (75, 285)]` is used.

import cv2

from ultralytics import solutions

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

region_points = [(150, 150), (1130, 150), (1130, 570), (150, 570)]
trackzone = solutions.TrackZone(show=False, region=region_points, model="yolo26n.pt")

while cap.isOpened():
    success, im0 = cap.read()
    if not success:
        break
    results = trackzone(im0)
    print(f"Objects currently in zone: {results.total_tracks}")  # live zone occupancy

cap.release()

yolo solutions trackzone source="path/to/video.mp4" show=True

import cv2

from ultralytics import solutions

cap = cv2.VideoCapture("path/to/video.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))
video_writer = cv2.VideoWriter("trackzone_output.avi", cv2.VideoWriter_fourcc(*"mp4v"), fps, (w, h))

trackzone = solutions.TrackZone(
    show=True, region=[(150, 150), (1130, 150), (1130, 570), (150, 570)], model="yolo26n.pt"
)

while cap.isOpened():
    success, im0 = cap.read()
    if not success:
        break
    results = trackzone(im0)
    video_writer.write(results.plot_im)

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

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

# Initialize trackzone
trackzone = solutions.TrackZone(
    show=True,  # display the output
    region=region_points,  # pass region points
)