human_face_detect

Human Face Detection Models

Model list

Chip	MSR_S8_V1 + MNP_S8_V1
ESP32-S3
ESP32-P4

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

HumanFaceDetect *detect = new HumanFaceDetect();

How to Detect Human Faces

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.