espressif/pedestrian_detect

readme

# Pedestrian Detection Models

## Model list
[supported]: https://img.shields.io/badge/-supported-green "supported"

| Chip     | PICO_S8_V1             |
|----------|------------------------|
| ESP32-S3 | ![alt text][supported] |
| ESP32-P4 | ![alt text][supported] |

## Model Latency

| name          | input(h*w*c)  | preprocess(us) | model(us) | postprocess(us) |
|---------------|---------------|----------------|-----------|-----------------|
| pico_s8_v1_s3 | 224 * 224 * 3 | 27693          | 118350    | 2389            |
| pico_s8_v1_p4 | 224 * 224 * 3 | 14342          | 55585     | 1410            |

## Model Usage

### How to New `PedestrianDetect`

```cpp
PedestrianDetect *detect = new PedestrianDetect();
```
### How to Detect

```cpp
dl::image::img_t img = {.data=DATA, .width=WIDTH, .height=HEIGHT, .pix_type=PIX_TYPE};
std::list<dl::detect::result_t> &res = dl::detect->run(img);
```

More details, see [`dl::image::img_t`](https://github.com/espressif/esp-dl/blob/master/esp-dl/vision/image/dl_image_define.hpp) and [`dl::detect::result_t`](https://github.com/espressif/esp-dl/blob/master/esp-dl/vision/detect/dl_detect_define.hpp).

# Configurable Options in Menuconfig

See [Kconfig](Kconfig).

## Model Location

- CONFIG_PEDESTRIAN_DETECT_MODEL_IN_FLASH_RODATA
- CONFIG_PEDESTRIAN_DETECT_MODEL_IN_FLASH_PARTITION
- CONFIG_PEDESTRIAN_DETECT_MODEL_IN_SDCARD

This component supports to [load model](https://docs.espressif.com/projects/esp-dl/en/latest/tutorials/how_to_load_test_profile_model.html) from three different locations.

> [!NOTE] 
> If model location is set to FLASH partition, `partition.csv` must contain a partition named `pedestrian_det`, and the partition should be big enough to hold the model file.

## SDCard Directory

- CONFIG_PEDESTRIAN_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](models) folder to sdcard root directory.

> [!NOTE] 
> Do not change the model name when copy the models to sdcard.