README_en.md

简体中文 | English

Product Update

• 🔥 2022.11.15：SOTA rotated object detector and small object detector based on PP-YOLOE

  • Rotated object detector PP-YOLOE-R
    • SOTA Anchor-free rotated object detection model with high accuracy and efficiency
    • A series of models, named s/m/l/x, for cloud and edge devices
    • Avoiding using special operators to be deployed friendly with TensorRT.
  • Small object detector PP-YOLOE-SOD
    • End-to-end detection pipeline based on sliced images
    • SOTA model on VisDrone based on original images.

• 2022.8.26：PaddleDetection releasesrelease/2.5 version

  • 🗳 Model features：

    • Release PP-YOLOE+: Increased accuracy by a maximum of 2.4% mAP to 54.9% mAP, 3.75 times faster model training convergence rate, and up to 2.3 times faster end-to-end inference speed; improved generalization for multiple downstream tasks
    • Release PicoDet-NPU model which supports full quantization deployment of models; add PicoDet layout analysis model
    • Release PP-TinyPose Plus. With 9.1% AP accuracy improvement in physical exercise, dance, and other scenarios, our PP-TinyPose Plus supports unconventional movements such as turning to one side, lying down, jumping, and high lifts

  • 🔮 Functions in different scenarios

    • Release the pedestrian analysis tool PP-Human v2. It introduces four new behavior recognition: fighting, telephoning, smoking, and trespassing. The underlying algorithm performance is optimized, covering three core algorithm capabilities: detection, tracking, and attributes of pedestrians. Our model provides end-to-end development and model optimization strategies for beginners and supports online video streaming input.
    • First release PP-Vehicle, which has four major functions: license plate recognition, vehicle attribute analysis (color, model), traffic flow statistics, and violation detection. It is compatible with input formats, including pictures, online video streaming, and video. And we also offer our users a comprehensive set of tutorials for customization.

  • 💡 Cutting-edge algorithms：

    • Release PaddleYOLO which overs classic and latest models of YOLO family: YOLOv3, PP-YOLOE (a real-time high-precision object detection model developed by Baidu PaddlePaddle), and cutting-edge detection algorithms such as YOLOv4, YOLOv5, YOLOX, YOLOv6, YOLOv7 and YOLOv8
    • Newly add high precision detection model based on ViT backbone network, with a 55.7% mAP accuracy on COCO dataset; newly add multi-object tracking model OC-SORT; newly add ConvNeXt backbone network.

  • 📋 Industrial applications: Newly add Smart Fitness, Fighting recognition, and Visitor Analysis.

• 2022.3.24：PaddleDetection releasedrelease/2.4 version

  • Release high-performanace SOTA object detection model PP-YOLOE. It integrates cloud and edge devices and provides S/M/L/X versions. In particular, Verson L has the accuracy as 51.4% on COCO test 2017 dataset, inference speed as 78.1 FPS on a single Test V100. It supports mixed precision training, 33% faster than PP-YOLOv2. Its full range of multi-sized models can meet different hardware arithmetic requirements, and adaptable to server, edge-device GPU and other AI accelerator cards on servers.
  • Release ultra-lightweight SOTA object detection model PP-PicoDet Plus with 2% improvement in accuracy and 63% improvement in CPU inference speed. Add PicoDet-XS model with a 0.7M parameter, providing model sparsification and quantization functions for model acceleration. No specific post processing module is required for all the hardware, simplifying the deployment.
  • Release the real-time pedestrian analysis tool PP-Human. It has four major functions: pedestrian tracking, visitor flow statistics, human attribute recognition and falling detection. For falling detection, it is optimized based on real-life data with accurate recognition of various types of falling posture. It can adapt to different environmental background, light and camera angle.
  • Add YOLOX object detection model with nano/tiny/S/M/L/X. X version has the accuracy as 51.8% on COCO Val2017 dataset.

• More releases

Brief Introduction

PaddleDetection is an end-to-end object detection development kit based on PaddlePaddle. Providing over 30 model algorithm and over 300 pre-trained models, it covers object detection, instance segmentation, keypoint detection, multi-object tracking. In particular, PaddleDetection offers high- performance & light-weight industrial SOTA models on servers and mobile devices, champion solution and cutting-edge algorithm. PaddleDetection provides various data augmentation methods, configurable network components, loss functions and other advanced optimization & deployment schemes. In addition to running through the whole process of data processing, model development, training, compression and deployment, PaddlePaddle also provides rich cases and tutorials to accelerate the industrial application of algorithm.

Features

• Rich model library: PaddleDetection provides over 250 pre-trained models including object detection, instance segmentation, face recognition, multi-object tracking. It covers a variety of global competition champion schemes.
• Simple to use: Modular design, decoupling each network component, easy for developers to build and try various detection models and optimization strategies, quick access to high-performance, customized algorithm.
• Getting Through End to End: PaddlePaddle gets through end to end from data augmentation, constructing models, training, compression, depolyment. It also supports multi-architecture, multi-device deployment for cloud and edge device.
• High Performance: Due to the high performance core, PaddlePaddle has clear advantages in training speed and memory occupation. It also supports FP16 training and multi-machine training.

Exchanges

• If you have any question or suggestion, please give us your valuable input via GitHub Issues

  Welcome to join PaddleDetection user groups on WeChat (scan the QR code, add and reply "D" to the assistant)

  

Kit Structure

Model Performance

Performance comparison of Cloud models

The comparison between COCO mAP and FPS on Tesla V100 of representative models of each architectures and backbones.

Clarification：

• ViT stands for ViT-Cascade-Faster-RCNN, which has highest mAP on COCO as 55.7%
• Cascade-Faster-RCNNstands for Cascade-Faster-RCNN-ResNet50vd-DCN, which has been optimized to 20 FPS inference speed when COCO mAP as 47.8% in PaddleDetection models
• PP-YOLOE are optimized PP-YOLO v2. It reached accuracy as 51.4% on COCO dataset, inference speed as 78.1 FPS on Tesla V100
• PP-YOLOE+ are optimized PP-YOLOE. It reached accuracy as 53.3% on COCO dataset, inference speed as 78.1 FPS on Tesla V100
• The models in the figure are available in the model library

Performance omparison on mobiles

The comparison between COCO mAP and FPS on Qualcomm Snapdragon 865 processor of models on mobile devices.

Clarification：

• Tests were conducted on Qualcomm Snapdragon 865 (4 *A77 + 4 *A55) batch_size=1, 4 thread, and NCNN inference library, test script see MobileDetBenchmark
• PP-PicoDet and PP-YOLO-Tiny are self-developed models of PaddleDetection, and other models are not tested yet.

Model libraries

Document tutorials

Introductory tutorials

• Installation
• Quick start
• Data preparation
• Geting Started on PaddleDetection
• FAQ

Advanced tutorials

• Configuration

  • RCNN Configuration
  • PP-YOLO Configuration

• Compression based on PaddleSlim

  • Pruning/Quantization/Distillation Tutorial

• Inference deployment

  • Export model for inference

  • Paddle Inference deployment

    • Inference deployment with Python
    • Inference deployment with C++

  • Paddle-Lite deployment

  • Paddle Serving deployment

  • ONNX model export

  • Inference benchmark

• Advanced development

  • Data processing module
  • New object detection models
  • Custumization
    • Object detection
    • Keypoint detection
    • Multiple object tracking
    • Action recognition
    • Attribute recognition

Courses

• [Theoretical foundation] Object detection 7-day camp: Overview of object detection tasks, details of RCNN series object detection algorithm and YOLO series object detection algorithm, PP-YOLO optimization strategy and case sharing, introduction and practice of AnchorFree series algorithm

• [Industrial application] AI Fast Track industrial object detection technology and application: Super object detection algorithms, real-time pedestrian analysis system PP-Human, breakdown and practice of object detection industrial application

• [Industrial features] 2022.3.26 Smart City Industry Seven-Day Class : Urban planning, Urban governance, Smart governance service, Traffic management, community governance.

• [Academic exchange] 2022.9.27 YOLO Vision Event: As the first YOLO-themed event, PaddleDetection was invited to communicate with the experts in the field of Computer Vision around the world.

Industrial tutorial examples

• Rotated object detection based on PP-YOLOE-R

• Aerial image detection based on PP-YOLOE-SOD

• Fall down recognition based on PP-Human v2

• Intelligent fitness recognition based on PP-TinyPose Plus

• Road litter detection based on PP-PicoDet Plus

• Visitor flow statistics based on FairMOT

• Guest analysis based on PP-Human

• More examples

Applications

• Fitness app on android mobile
• PP-Tracking GUI Visualization Interface

Recommended third-party tutorials

• Deployment of PaddleDetection for Windows I
• Deployment of PaddleDetection for Windows II
• Deployment of PaddleDetection on Jestson Nano
• How to deploy YOLOv3 model on Raspberry Pi for Helmet detection
• Use SSD-MobileNetv1 for a project -- From dataset to deployment on Raspberry Pi

Version updates

Please refer to the Release note for more details about the updates

License

PaddlePaddle is provided under the Apache 2.0 license

Contribute your code

We appreciate your contributions and your feedback！

• Thank Mandroide for code cleanup and
• Thank FL77N for Sparse-RCNNmodel
• Thank Chen-Song for Swin Faster-RCNNmodel
• Thank yangyudong, hchhtc123 for developing PP-Tracking GUI interface
• Thank Shigure19 for developing PP-TinyPose fitness APP
• Thank manangoel99 for Wandb visualization methods

Quote

@misc{ppdet2019,
title={PaddleDetection, Object detection and instance segmentation toolkit based on PaddlePaddle.},
author={PaddlePaddle Authors},
howpublished = {\url{https://github.com/PaddlePaddle/PaddleDetection}},
year={2019}
}