diff --git a/docs/mtnn_guide_v1.5.1.md b/docs/mtnn_guide_v1.5.1.md index b548f48d6353088a19668f812c1a489501158617..931032a8680a64b25d7bfa9bc3d0a8caffc67502 100644 --- a/docs/mtnn_guide_v1.5.1.md +++ b/docs/mtnn_guide_v1.5.1.md @@ -812,6 +812,7 @@ mtc [-h] | hybrid | 是否启用混合量化, 可选项为: true/false | | quantize_file | 设置用于混合量化的配置文件 | | static_quantization | 输入模型是否为static onnx quantization model,可选项为:true/false,默认为false | +| skip_preprocess_input | 对输入数据做量化操作时,是否跳过前处理操作,可选项为:true/false,默认为false | | TestEnable | 暂未使用 | | UseSingleCore | 是否编译单核上使用的模型. (默认值为1) | @@ -985,6 +986,27 @@ mtc_wrap --model_path=../example/onnx/mobilenet_v2/mobilenet_v2_1.0_224_slim.onn - `iterations: 1--32`:快速 smoke test - `iterations: 64--128`:平衡速度与精度 - `iterations: 256+`:追求最佳量化质量 + +**QuantConfig.skip_preprocess_input** +- 类型:布尔值 (`bool`) +- 含义: + - 控制在对输入数据做量化前,是否跳过预处理(preprocess)操作。 + - 设为 `false` 时,框架会先按既定前处理流程处理输入数据,再进行量化;设为 `true` 时,直接对输入数据做量化。 +- 作用: + - 适用于输入数据已经完成前处理的场景,避免重复执行归一化、减均值、缩放等操作; + - 若输入数据仍是原始图片或原始张量,通常应保持为 `false`,以保证量化使用的数据分布与实际推理流程一致。 +- 典型值: + - `skip_preprocess_input: false`:默认推荐,适用于输入仍需走标准前处理流程的场景 + - `skip_preprocess_input: true`:适用于输入数据已提前完成前处理、可直接参与量化的场景 +- 示例: + - `skip_preprocess_input: false` 配置示例(114.npy是从原始图片转换过来的): + +![](res/quant_skipinputpreproc_false.png) + + - `skip_preprocess_input: true` 配置示例(000000000009.npy是对原始图片做过前处理的张量): + +![](res/quant_skipinputpreproc_true.png) +

diff --git a/docs/res/quant_skipinputpreproc_false.png b/docs/res/quant_skipinputpreproc_false.png new file mode 100644 index 0000000000000000000000000000000000000000..fed92a85fd5d95ba23b4f30eba09be224e907725 Binary files /dev/null and b/docs/res/quant_skipinputpreproc_false.png differ diff --git a/docs/res/quant_skipinputpreproc_true.png b/docs/res/quant_skipinputpreproc_true.png new file mode 100644 index 0000000000000000000000000000000000000000..6f07d9cf412aa3fd870d0e063a2aa0a70e709473 Binary files /dev/null and b/docs/res/quant_skipinputpreproc_true.png differ