add some new python demos

examples/retinaface/README.md

@@ -0,0 +1,160 @@
+# retinaface
+
+## 1.Overview
+
+
+## 2.Model Download
+
+- **Open Source model**
+
+  - **Open Source projects:** 
+
+  - **Export Model Step:**	
+
+    - **Install ultralytics**
+
+        pip install torch==2.4.1
+
+        pip install torchvision==0.19.1
+
+        pip install ultralytics==8.3.0
+
+    - **Download weights**
+
+      
+
+    - **Export Model**
+
+    
+
+
+- **Exported Model**
+
+  ​	link to amlogic server( **onnx model   or quantized tflite**)
+
+  
+
+## 3. Model Conversion
+
+```
+cd model
+Usage:   ./adla_covnert.sh model_path adla_tookkit_path target_platform
+
+example
+ 
+```
+
+| Parameter         | Discription                                                  |
+| ----------------- | ------------------------------------------------------------ |
+| model_path        | onnx model path                                              |
+| adla_tookkit_path | path to adla_toolkit                                         |
+| target_platform   | Specify target platform. for A311D2 : PRODUCT_PID0XA003. for S905X5:  PRODUCT_PID0XA005 |
+
+
+
+## 4. Demo Run
+
+### CPP
+
+#### 1. Compile
+
+**Prerequisites:**
+- Android NDK (r25e recommended)
+- `ANDROID_NDK_PATH` environment variable set
+
+**Build:**
+```bash
+# Build for arm64-v8a
+cd examples/retinaface/cpp
+./build-android.sh -a arm64-v8a
+```
+
+The executable will be generated at `build/android/retinaface_demo` (Note: executable name may vary, verify in build folder).
+
+#### 2. Run
+
+```bash
+# Push executable to device
+adb push build/android/retinaface_demo /data/local/tmp/
+adb push model/RetinaFace_int8_A311D2.adla /data/local/tmp/
+adb push imgs /data/local/tmp/
+
+# Run on device
+adb shell
+cd /data/local/tmp
+chmod +x retinaface_demo
+export LD_LIBRARY_PATH=/vendor/lib64 or (/vendor/lib)
+
+# Usage: ./retinaface_demo <model_path> <image_dir>
+./retinaface_demo RetinaFace_int8_A311D2.adla ./imgs
+```
+
+**Note:** Replace `RetinaFace_int8_A311D2.adla` with your actual model file path.
+
+### Python
+
+**Prerequisites:**
+- Python 3.10
+- Required packages: `numpy`, `opencv-python`, `amlnnlite`
+
+**Install dependencies:**
+```bash
+pip install numpy opencv-python amlnnlite-1.0.0-cp310-cp310-linux_aarch64.whl
+```
+
+**Run on device:**
+```bash
+python RetinaFace.py \
+    --model-path ./RetinaFace_int8_A311D2.adla \
+    --image-dir ./imgs \
+    --run-cycles 1 \
+    --loglevel INFO
+```
+
+Argument Descriptions:
+| Argument         | Description                                                  |
+| ----------------- | ------------------------------------------------------------ |
+| --board-work-path       | Work path on board, default is /data/local/tmp    |
+| --model-path | path to .adla model  |
+| --image-dir   | Directory containing test images |
+| --run-cycles   | Number of inference cycles, default is 1 |
+| --loglevel   | Logging level: DEBUG / INFO / WARNING / ERROR, default is WARNING |
+
+The script will automatically process all image files (`.jpg`, `.jpeg`, `.png`, `.bmp`) in the current directory and save results to a `{model_name}_result` folder.
+
+## 5.Results
+
+**Performance Feedback**
+
+By setting the loglevel to INFO, the program provides real-time performance metrics upon completion. The console log will display essential hardware and execution details, including:
+- Hardware Information: System and ADLA library versions.
+- Model Overview: Basic input/output configurations.
+- NPU Metrics: Total inference time (latency) and total DRAM bandwidth consumption.
+
+**Detection Output**
+
+The program will print the detection count. The output images, featuring bounding boxes and five facial landmarks (eyes, nose, and mouth corners), will be saved to the `{model_name}_result` folder.
+
+
+You can pull the result folder back to view it:
+```bash
+adb pull /data/local/tmp/RetinaFace_int8_A311D2_result
+```
+![alt text](result.jpg)
+
+
+**Profiling Visualization**
+
+After a successful run of the Python demo, a folder named after the model (e.g., `{model_name}`) will be generated in the script directory. This folder contains 5 HTML files that provide a visual and detailed breakdown of per-layer performance:
+- `hard_op_chart.html` & `soft_op_chart.html`: Hardware/Software op execution details.
+- `dram_rd_chart.html` & `dram_wr_chart.html`: Bandwidth read/write distribution.
+- `pie_charts_distribution.html`: Overall resource allocation.
+
+You can pull the result folder back to view it:
+```bash
+adb pull /data/local/tmp/RetinaFace_int8_A311D2
+```
+
+Taking hard_op_chart.html as an example (shown below), each layer's ADLA operator name includes parentheses containing the index of the corresponding quantized .tflite layer(s); by default, these indices are suppressed, and operators are labeled generically as "hardware" or "software" without numerical suffixes.
+
+![alt text](Visualization.png)

examples/retinaface/cpp/src/main.cpp

@@ -55,7 +55,8 @@ int main(int argc, char** argv) {
     size_t num_priors = priors.size();
     std::vector<float> chw_buffer(kInputW * kInputH * 3);
 
-    const std::string out_dir = "retinaface_result";
+    std::string model_stem = fs::path(argv[1]).stem().string();
+    const std::string out_dir = model_stem + "_result";
     fs::create_directory(out_dir);
 
     std::vector<fs::path> image_paths;

examples/retinaface/py/RetinaFace.py

@@ -107,7 +107,7 @@ def preprocess(img_path, input_size=(320, 320)):
 
 def main():
     parser = argparse.ArgumentParser(description="RetinaFace AMLNNLite Demo")
-    parser.add_argument('--board-work-path', type=str, default='/data/nn')
+    parser.add_argument('--board-work-path', type=str, default='/data/local/tmp')
     parser.add_argument('--model-path', required=True, help='Path to .adla model')
     parser.add_argument('--image-dir', required=True, help='Directory of test images')
     parser.add_argument('--run-cycles', type=int, default=1, help='Inference cycles')
@@ -122,13 +122,18 @@ def main():
     amlnn.init()
 
     priors = PriorBox((320, 320)).forward()
-    image_files = sorted(glob.glob(os.path.join(args.image_dir, "*.[jp][pn][g]")))
+    image_files = []
+    for ext in ["*.jpg", "*.jpeg", "*.png", "*.bmp"]:
+        image_files.extend(glob.glob(os.path.join(args.image_dir, ext)))
+        image_files.extend(glob.glob(os.path.join(args.image_dir, ext.upper())))
+    image_files.sort()
     
     if not image_files:
         print(f"No images found in {args.image_dir}")
         amlnn.uninit(); return
 
-    res_dir = "retinaface_result"
+    model_stem = Path(args.model_path).stem
+    res_dir = f"{model_stem}_result"
     os.makedirs(res_dir, exist_ok=True)
 
     for idx, img_path in enumerate(image_files, start=1):