AIPP

功能介绍

AIPP（AI PreProcessing）用于在AI Core上完成图像预处理，包括色域转换（转换图像格式）、图像归一化（减均值/乘系数）和抠图（指定抠图起始点，抠出神经网络需要大小的图片）。AIPP区分为静态AIPP和动态AIPP，只能二选一，不能同时支持。

• 静态AIPP：模型编译时设置AIPP模式为静态，同时设置AIPP参数，模型生成后，AIPP参数值被保存在离线模型中，每次模型推理过程采用固定的AIPP预处理参数（无法修改）。
• 动态AIPP：模型编译时设置AIPP模式为动态，每次模型推理前，根据需求，在执行模型前设置动态AIPP参数值，然后在模型执行时可使用不同的AIPP参数。动态AIPP在根据业务要求改变预处理参数的场合下使用（如不同摄像头采用不同的归一化参数，输入图片格式需要兼容YUV420和RGB等）。

  关于AIPP功能的详细介绍请参考《ATC工具使用指南》。

使用方法

下面介绍如何在模型构建时支持AIPP功能：

1. Data算子输入数据的Channel维度的元素个数和图片实际保持一致。

   auto shape_data = vector<int64_t>({ 1,10,12,12 });
   TensorDesc desc_data(ge::Shape(shape_data), FORMAT_NCHW, DT_FLOAT16);
   auto data = op::Data("data");
   data.update_input_desc_x(desc_data);
   data.update_output_desc_y(desc_data);

2. 准备AIPP配置文件，配置说明请参考《ATC工具使用指南》，下面给出一些配置示例：
   静态AIPP配置文件示例：

   aipp_op {
   aipp_mode:static          # 表示静态AIPP
   input_format:YUV420SP_U8
   csc_switch:true
   var_reci_chn_0:0.00392157
   var_reci_chn_1:0.00392157
   var_reci_chn_2:0.00392157
   }

   动态AIPP配置文件示例（除了以下字段外，其他无需配置）：

   aipp_op {
   aipp_mode:dynamic         # 表示动态AIPP
   related_input_rank: 0     # 可选，标识对模型的第几个输入做AIPP处理，从0开始，默认为0
   max_src_image_size:752640 # 输入图像最大的size，动态AIPP必须配置
   }

3. 模型编译时，在aclgrphBuildModel接口options中设置INSERT_OP_FILE和INPUT_FORMAT。

   void PrepareOptions(std::map<Ascendstring, Ascendstring>& options) {
       options.insert({
           {ge::ir_option::EXEC_DISABLE_REUSED_MEMORY, "1"},
          {ge::ir_option::INSERT_OP_FILE, PATH + "aipp_nv12_img.cfg"},
          {ge::ir_option::INPUT_FORMAT, "NCHW"} 
           });
   }

4. 编译生成的离线模型自动插入aipp算子。