文章目录
- Github
- 官网
- 简介
- 模式
- 数据集
- Python 环境
- Conda 环境
- Docker 环境
- 部署 CPU 版本
- 官方 CLI 示例
- 官方 Python 示例
- 任务
- 目标检测
- 姿势估计
- 图像分类
- Ultralytics HUB
- 视频流示例
Github
- https://github.com/ultralytics/ultralytics
官网
- https://docs.ultralytics.com/zh
- https://docs.ultralytics.com/zh/quickstart/
简介
Ultralytics 是一个软件公司,专注于开发计算机视觉和深度学习工具。他们的主要产品是 YOLOv5,这是一个快速、高效的目标检测模型,特别适用于实时应用。YOLOv5 是对经典的 YOLO(You Only Look Once)系列模型的升级,采用了现代化的深度学习技术和优化策略,以提供更好的性能和更低的计算成本。
Ultralytics 还开发了其他一些工具和库,帮助研究人员和开发者在计算机视觉和深度学习领域更高效地工作。他们的开源项目广受欢迎,为社区提供了强大的工具和资源,以推动计算机视觉技术的发展和应用。
模式
- https://docs.ultralytics.com/zh/modes/
Ultralytics YOLOv8 不只是另一种对象检测模型;它是一个多功能框架,旨在覆盖机器学习模型的整个生命周期–从数据摄取和模型训练到验证、部署和实际跟踪。每种模式都有特定的用途,其设计旨在为您提供不同任务和用例所需的灵活性和效率。
- 训练模式:在自定义或预载数据集上对模型进行微调。
- Val模式:用于验证模型性能的训练后检查点。
- 预测模式:释放模型对真实世界数据的预测能力。
- 导出模式:让您的模型以各种格式部署就绪。
- 跟踪模式:将物体检测模式扩展到实时跟踪应用中。
- 基准模式:在不同的部署环境中分析模型的速度和准确性。
数据集
- https://docs.ultralytics.com/zh/datasets/
Ultralytics 为各种数据集提供支持,以促进检测、实例分割、姿态估计、分类和多目标跟踪等计算机视觉任务。下面列出了Ultralytics 的主要数据集,然后是每个计算机视觉任务和相应数据集的摘要。
-
物体检测: 边界框物体检测是一种计算机视觉技术,它通过在每个物体周围绘制一个边界框来检测和定位图像中的物体。
-
实例分割: 实例分割是一种计算机视觉技术,涉及在像素级别识别和定位图像中的对象。
-
姿势估计: 姿态估计是一种用于确定物体相对于摄像机或世界坐标系的姿态的技术。
-
分类: 图像分类是一项计算机视觉任务,包括根据图像的视觉内容将其归入一个或多个预定义的类别。
-
定向边框(OBB): 定向包围盒(OBB)是计算机视觉中一种利用旋转包围盒检测图像中倾斜物体的方法,通常应用于航空和卫星图像。
-
多目标跟踪: 多目标跟踪是一种计算机视觉技术,涉及在视频序列中检测和跟踪多个目标。
Python 环境
# 怕包冲突可以清理当前环境所有安装包
pip freeze | xargs pip uninstall -y
pip install --upgrade pip
pip install ultralytics
# 显示预测结果图片
pip install matplotlib
Conda 环境
- Anaconda:https://www.anaconda.com/
- Miniconda:https://docs.anaconda.com/miniconda/
# 创建 Conda 环境
conda create --name ultralytics-env python=3.8 -y
# 激活新环境
conda activate ultralytics-env
# 安装 Ultralytics
conda install -c conda-forge ultralytics
- CUDA 环境说明
如果您在CUDA 环境中工作,最好安装 ultralytics, pytorch和 pytorch-cuda 共同解决任何冲突
conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics
Docker 环境
- 镜像:https://hub.docker.com/r/ultralytics/ultralytics
# 推荐用于训练的 GPU 映像。
docker pull ultralytics/ultralytics:latest
docker pull ultralytics/ultralytics:8.2.59
# 基于 Ubuntu 的仅 CPU 版本,适用于推理和无 GPU 的环境。
docker pull ultralytics/ultralytics:latest-cpu
docker pull ultralytics/ultralytics:8.2.59-cpu
# 仅包含Python 和必要依赖项的最小镜像,是轻量级应用和开发的理想选择。
docker pull ultralytics/ultralytics:latest-python
docker pull ultralytics/ultralytics:8.2.59-python
- 仅使用CPU
docker run -it --rm ultralytics/ultralytics:8.2.59-cpu
- 使用图形处理器
# Run with all GPUs
sudo docker run -it --ipc=host --gpus all ultralytics/ultralytics:8.2.59# Run specifying which GPUs to use
sudo docker run -it --ipc=host --gpus '"device=2,3"' ultralytics/ultralytics:8.2.59
部署 CPU 版本
docker run -it --rm --name yolo ultralytics/ultralytics:8.2.59-cpu
# 拷贝 ultralytics 源码
docker cp yolo:/usr/src/ultralytics ./yolo# 部署 yolo
docker run -it --rm --name yolo \
-v ./yolo/ultralytics:/usr/src/ultralytics \
ultralytics/ultralytics:8.2.59-cpu
注意: 以下脚本与CLI命令都是在容器内执行。
官方 CLI 示例
YOLO 命令行界面 (CLI) 允许使用简单的单行命令,而无需Python 环境。CLI 不需要定制或Python 代码。您只需使用 yolo 指挥。
yolo predict model=yolov8n.pt source='https://ultralytics.com/images/bus.jpg'
官方 Python 示例
pip install matplotlib
import matplotlib.pyplot as plt
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n.yaml") # 从头开始构建一个新模型
model = YOLO("yolov8n.pt") # 加载预训练模型(推荐用于训练)# 使用模型
model.train(data="coco8.yaml", epochs=3) # 训练模型
metrics = model.val() # 在验证集上评估模型性能
results = model("https://ultralytics.com/images/bus.jpg") # 对一张图片进行预测
path = model.export(format="onnx") # 将模型导出为ONNX格式# 显示预测结果图片
plt.figure(figsize=(10, 8))
plt.imshow(results[0].plot()) # 显示预测结果图片
plt.axis('off') # 关闭坐标轴
plt.show()
- 使用 matplotlib 显示预测结果
任务
- https://docs.ultralytics.com/zh/tasks/
YOLOv8 是一个支持多种计算机视觉任务的人工智能框架。该框架可用于执行检测、分割、obb、分类和姿态估计。每种任务都有不同的目标和用例。
目标检测
- https://docs.ultralytics.com/zh/tasks/detect/
- 训练模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n.yaml") # 从 YAML 文件构建一个新模型
model = YOLO("yolov8n.pt") # 加载预训练模型(推荐用于训练)
model = YOLO("yolov8n.yaml").load("yolov8n.pt") # 从 YAML 文件构建模型,并加载预训练权重# 训练模型
results = model.train(data="coco8.yaml", epochs=3, imgsz=640)
- 验证模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/detect/train/weights/best.pt") # 加载自定义模型# 验证模型
metrics = model.val() # 无需参数,数据集和设置已被记录
metrics.box.map # mAP50-95,所有类别的平均精度(Average Precision)
metrics.box.map50 # mAP50,所有类别的平均精度(Average Precision)在IoU阈值为50%时
metrics.box.map75 # mAP75,所有类别的平均精度(Average Precision)在IoU阈值为75%时
metrics.box.maps # 一个包含每个类别的mAP50-95的列表,即每个类别的平均精度(Average Precision)
- 测试模型
import matplotlib.pyplot as plt
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/detect/train/weights/best.pt") # 加载自定义模型# 使用模型进行预测
results = model("https://ultralytics.com/images/bus.jpg") # 对一张图片进行预测# 显示预测结果图片
plt.figure(figsize=(10, 8))
plt.imshow(results[0].plot()) # 显示预测结果图片
plt.axis('off') # 关闭坐标轴
plt.show()
yolo pose predict model=/usr/src/ultralytics/runs/detect/train/weights/best.pt source='https://ultralytics.com/images/bus.jpg'
- 导出模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/detect/train/weights/best.pt") # 加载自定义训练模型# 导出模型为 ONNX 格式
model.export(format="onnx") # 将模型导出为ONNX格式
- 测试导出的 ONNX 模型
from ultralytics import YOLO# 加载导出的 ONNX 模型
onnx_model = YOLO("/usr/src/ultralytics/runs/detect/train/weights/best.onnx")# 运行推理
results = onnx_model("https://ultralytics.com/images/bus.jpg") # 对一张图片进行推理
- CLI 命令方式
yolo predict model=/usr/src/ultralytics/runs/detect/train/weights/best.onnx source='https://ultralytics.com/images/bus.jpg'
姿势估计
- https://docs.ultralytics.com/zh/tasks/pose/
- 训练模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-pose.yaml") # 从 YAML 文件构建一个新模型
model = YOLO("yolov8n-pose.pt") # 加载预训练模型(推荐用于训练)
model = YOLO("yolov8n-pose.yaml").load("yolov8n-pose.pt") # 从 YAML 文件构建模型,并加载预训练权重# 训练模型
results = model.train(data="coco8-pose.yaml", epochs=3, imgsz=640)
- 验证模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-pose.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/pose/train/weights/best.pt") # 加载自定义模型# 验证模型
metrics = model.val() # 无需参数,数据集和设置已被记录
metrics.box.map # mAP50-95,所有类别的平均精度(Average Precision)
metrics.box.map50 # mAP50,所有类别的平均精度(Average Precision)在IoU阈值为50%时
metrics.box.map75 # mAP75,所有类别的平均精度(Average Precision)在IoU阈值为75%时
metrics.box.maps # 一个包含每个类别的mAP50-95的列表,即每个类别的平均精度(Average Precision)
- 测试模型
import matplotlib.pyplot as plt
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-pose.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/pose/train/weights/best.pt") # 加载自定义模型# 使用模型进行预测
results = model("https://ultralytics.com/images/bus.jpg") # 对一张图片进行预测# 显示预测结果图片
plt.figure(figsize=(10, 8))
plt.imshow(results[0].plot()) # 显示预测结果图片
plt.axis('off') # 关闭坐标轴
plt.show()
- 使用 matplotlib 显示预测结果
- CLI 命令方式
yolo pose predict model=/usr/src/ultralytics/runs/pose/train/weights/best.pt source='https://ultralytics.com/images/bus.jpg'
- 导出模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-pose.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/pose/train/weights/best.pt") # 加载自定义训练模型# 导出模型为 ONNX 格式
model.export(format="onnx") # 导出模型为ONNX格式
图像分类
- https://docs.ultralytics.com/zh/tasks/classify/
- 训练模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-cls.yaml") # 从 YAML 文件构建一个新模型
model = YOLO("yolov8n-cls.pt") # 加载预训练模型(推荐用于训练)
model = YOLO("yolov8n-cls.yaml").load("yolov8n-cls.pt") # 从 YAML 文件构建模型,并加载预训练权重# 训练模型
results = model.train(data="mnist160", epochs=3, imgsz=64)
- 验证模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-cls.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/classify/train/weights/best.pt") # 加载自定义模型# 验证模型
metrics = model.val() # 无需参数,数据集和设置已被记录
metrics.top1 # top1 准确率(accuracy)
metrics.top5 # top5 准确率(accuracy)
- 测试模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-cls.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/classify/train/weights/best.pt") # 加载自定义模型# 使用模型进行预测
results = model("https://ultralytics.com/images/bus.jpg") # 对一张图片进行预测
- CLI 命令方式
yolo classify predict model=/usr/src/ultralytics/runs/classify/train/weights/best.pt source='https://ultralytics.com/images/bus.jpg'
- 导出模型
from ultralytics import YOLO# 加载模型
model = YOLO("yolov8n-cls.pt") # 加载官方模型
model = YOLO("/usr/src/ultralytics/runs/classify/train/weights/best.pt") # 加载自定义训练模型# 导出模型
model.export(format="onnx") # 导出模型为ONNX格式
Ultralytics HUB
- https://hub.ultralytics.com/home
在 Ultralytics HUB 上创建和训练复杂的模型,无需代码,只需几秒钟即可完成,适用于网络和移动设备。
注: Ultralytics HUB 具体用法将在下篇文章介绍敬请关注。
视频流示例
- 使用 OpenCV 和 YOLO 模型进行实时目标检测并在视频流中显示检测结果