ultralytics/docs/en/guides/region-counting.md

comments	description	keywords
true	Learn how to use Ultralytics YOLOv8 for precise object counting in specified regions, enhancing efficiency across various applications.	object counting, regions, YOLOv8, computer vision, Ultralytics, efficiency, accuracy, automation, real-time, applications, surveillance, monitoring

Object Counting in Different Regions using Ultralytics YOLOv8 🚀

What is Object Counting in Regions?

Object counting in regions with Ultralytics YOLOv8 involves precisely determining the number of objects within specified areas using advanced computer vision. This approach is valuable for optimizing processes, enhancing security, and improving efficiency in various applications.

Watch: Ultralytics YOLOv8 Object Counting in Multiple & Movable Regions

Advantages of Object Counting in Regions?

• Precision and Accuracy: Object counting in regions with advanced computer vision ensures precise and accurate counts, minimizing errors often associated with manual counting.
• Efficiency Improvement: Automated object counting enhances operational efficiency, providing real-time results and streamlining processes across different applications.
• Versatility and Application: The versatility of object counting in regions makes it applicable across various domains, from manufacturing and surveillance to traffic monitoring, contributing to its widespread utility and effectiveness.

Real World Applications

Retail	Market Streets
People Counting in Different Region using Ultralytics YOLOv8	Crowd Counting in Different Region using Ultralytics YOLOv8

Steps to Run

Step 1: Install Required Libraries

Begin by cloning the Ultralytics repository, installing dependencies, and navigating to the local directory using the provided commands in Step 2.

# Clone Ultralytics repo
git clone https://github.com/ultralytics/ultralytics

# Navigate to the local directory
cd ultralytics/examples/YOLOv8-Region-Counter

Step 2: Run Region Counting Using Ultralytics YOLOv8

Execute the following basic commands for inference.

???+ tip "Region is Movable"

During video playback, you can interactively move the region within the video by clicking and dragging using the left mouse button.

# Save results
python yolov8_region_counter.py --source "path/to/video.mp4" --save-img

# Run model on CPU
python yolov8_region_counter.py --source "path/to/video.mp4" --device cpu

# Change model file
python yolov8_region_counter.py --source "path/to/video.mp4" --weights "path/to/model.pt"

# Detect specific classes (e.g., first and third classes)
python yolov8_region_counter.py --source "path/to/video.mp4" --classes 0 2

# View results without saving
python yolov8_region_counter.py --source "path/to/video.mp4" --view-img

Optional Arguments

Name	Type	Default	Description
--source	str	None	Path to video file, for webcam 0
--line_thickness	int	2	Bounding Box thickness
--save-img	bool	False	Save the predicted video/image
--weights	str	yolov8n.pt	Weights file path
--classes	list	None	Detect specific classes i.e. --classes 0 2
--region-thickness	int	2	Region Box thickness
--track-thickness	int	2	Tracking line thickness

FAQ

What is object counting in specified regions using Ultralytics YOLOv8?

Object counting in specified regions with Ultralytics YOLOv8 involves detecting and tallying the number of objects within defined areas using advanced computer vision. This precise method enhances efficiency and accuracy across various applications like manufacturing, surveillance, and traffic monitoring.

How do I run the object counting script with Ultralytics YOLOv8?

Follow these steps to run object counting in Ultralytics YOLOv8:

1. Clone the Ultralytics repository and navigate to the directory:

   git clone https://github.com/ultralytics/ultralytics
   cd ultralytics/examples/YOLOv8-Region-Counter
   

2. Execute the region counting script:

   python yolov8_region_counter.py --source "path/to/video.mp4" --save-img
   

For more options, visit the Run Region Counting section.

Why should I use Ultralytics YOLOv8 for object counting in regions?

Using Ultralytics YOLOv8 for object counting in regions offers several advantages:

• Precision and Accuracy: Minimizes errors often seen in manual counting.
• Efficiency Improvement: Provides real-time results and streamlines processes.
• Versatility and Application: Applies to various domains, enhancing its utility.

Explore deeper benefits in the Advantages section.

Can the defined regions be adjusted during video playback?

Yes, with Ultralytics YOLOv8, regions can be interactively moved during video playback. Simply click and drag with the left mouse button to reposition the region. This feature enhances flexibility for dynamic environments. Learn more in the tip section for movable regions.

What are some real-world applications of object counting in regions?

Object counting with Ultralytics YOLOv8 can be applied to numerous real-world scenarios:

• Retail: Counting people for foot traffic analysis.
• Market Streets: Crowd density management.

Explore more examples in the Real World Applications section.