espressif/human_face_detect

0.2.3

Latest
uploaded 3 months ago
human face detect model.
Readme Dependencies 1 Dependents 1 Examples 0 Versions 7

readme

Human Face Detection Models

Model list

Chip MSR_S8_V1 +
MNP_S8_V1
ESP32-S3 alt text
ESP32-P4 alt text

MSR_S8_V1 + MNP_S8_V1 is a two stage model. First stage model MSR_S8_V1 predicts some candidates, then every candidate go through the next stage model MNP_S8_V1.

Model Latency

name input(hwc) preprocess(us) model(us) postprocess(us)
msr_s8_v1_s3 120 * 160 * 3 10221 32403 222
msr_s8_v1_p4 120 * 160 * 3 5261 14611 150
mnp_s8_v1_s3 48 * 48 * 3 1110 5551 63
mnp_s8_v1_p4 48 * 48 * 3 637 2659 45

Model Usage

How to New HumanFaceDetect

Cpp

HumanFaceDetect *detect = new HumanFaceDetect();

How to Detect Human Faces

Cpp

dl::image::img_t img = {.data=DATA, .width=WIDTH, .height=HEIGHT, .pix_type=PIX_TYPE};
detect->run(img);

More detail about dl::image::img_t, see dl_image_define.hpp.

Configurable Options in Menuconfig

See Kconfig.

Model Location

  • CONFIG_HUMAN_FACE_DETECT_MODEL_IN_FLASH_RODATA
  • CONFIG_HUMAN_FACE_DETECT_MODEL_IN_FLASH_PARTITION
  • CONFIG_HUMAN_FACE_DETECT_MODEL_IN_SDCARD

This component supports to load model from three different locations.

note: If model location is set to FLASH partition, partition.csv must contain a partition named human_face_det, and the partition should be big enough to hold the model file.

SDCard Directory

  • CONFIG_HUMAN_FACE_DETECT_MODEL_SDCARD_DIR

When model locates in sdcard, you can change the model directory relative to the sdcard mount point.

The default value of this option is models/s3 for ESP32S3 and models/p4 for ESP32P4. When using default value, just copy models folder to sdcard root directory.

note: Do not change the model name when copy the models to sdcard.

Links

Supports all targets

License: MIT

To add this component to your project, run:

idf.py add-dependency "espressif/human_face_detect^0.2.3"

or download archive

Stats

  • Archive size
    Archive size ~ 225.44 KB
  • Downloaded in total
    Downloaded in total 2.1k times
  • Downloaded this version
    This version: 702 times

Badge

espressif/human_face_detect version: 0.2.3
|
report abuse