opencv/human_segmentation_pphumanseg
By opencv · ↓ 0 · ♥ 1 · Updated 2025-06-20
What's in this repo
This page lists the files in opencv/human_segmentation_pphumanseg, including human_segmentation_pphumanseg_2023mar.onnx, human_segmentation_pphumanseg_2023mar_int8.onnx, human_segmentation_pphumanseg_2023mar_int8bq.onnx.
- 3 ONNX models (.onnx files)
- 13 files, including 3 .onnx, 2 .py, 1 .txt, 1 .md, 1 .cpp, 1 .jpg
- Last updated 2025-06-20
ONNX files
| File | Size | Download |
|---|---|---|
| human_segmentation_pphumanseg_2023mar.onnx | — | Download |
| human_segmentation_pphumanseg_2023mar_int8.onnx | — | Download |
| human_segmentation_pphumanseg_2023mar_int8bq.onnx | — | Download |
How to use
These ONNX files can be loaded with ONNX Runtime. To inspect a model graph, upload the file to the Netron viewer. Download links point to the original files on Hugging Face.
README
PPHumanSeg
This model is ported from PaddleHub using this script from OpenCV.
Note:
human_segmentation_pphumanseg_2023mar_int8bq.onnxrepresents the block-quantized version in int8 precision and is generated using block_quantize.py withblock_size=64.
Demo
Python
Run the following command to try the demo:
# detect on camera input
python demo.py
# detect on an image
python demo.py --input /path/to/image -v
# get help regarding various parameters
python demo.py --help
C++
Install latest OpenCV and CMake >= 3.24.0 to get started with:
# A typical and default installation path of OpenCV is /usr/local
cmake -B build -D OPENCV_INSTALLATION_PATH=/path/to/opencv/installation .
cmake --build build
# detect on camera input
./build/opencv_zoo_human_segmentation
# detect on an image
./build/opencv_zoo_human_segmentation -i=/path/to/image
# get help messages
./build/opencv_zoo_human_segmentation -h
Example outputs


Results of accuracy evaluation with tools/eval.
| Models | Accuracy | mIoU |
|---|---|---|
| PPHumanSeg | 0.9656 | 0.9164 |
| PPHumanSeg block | 0.9655 | 0.9162 |
| PPHumanSeg quant | 0.7285 | 0.3642 |
*: 'quant' stands for 'quantized'. **: 'block' stands for 'blockwise quantized'.
License
All files in this directory are licensed under Apache 2.0 License.
Reference
- https://arxiv.org/abs/1512.03385
- https://github.com/opencv/opencv/tree/master/samples/dnn/dnn_model_runner/dnn_conversion/paddlepaddle
- https://github.com/PaddlePaddle/PaddleHub
Model info
Created: 2025-06-09
Updated: 2025-06-20
View on Hugging FaceFiles (13)
Related models
More from opencv
More models
No task type declared.