---
title: 参数概览
description: "本节介绍AOE调优引擎使用到的命令行参数。参数和参数取值之间可以是“=”，也可以是空格，本章节统一以“=”为例。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/devaids/aoe/aoerc_16_0017.html
sourcePath: /source/zh/canncommercial/900/devaids/aoe/aoerc_16_0017.html
indexId: 05172d29cf0ba8928320765129a15b167161bef14d90e769e5667f44f2d0f4c060
---
# 参数概览

本节介绍AOE调优引擎使用到的命令行参数。参数和参数取值之间可以是“=”，也可以是空格，本章节统一以“=”为例。

如果通过aoe --help命令查询出的参数未解释在表1，则说明该参数预留或适用于其他芯片版本，用户无需关注。


**表1 AOE参数概览**

| 参数名称 | 参数简述（具体说明见参数描述章节） | 是否必选 | 默认值 |
| --- | --- | --- | --- |
| \-\-help或\-h | 显示帮助信息。 | 否 | 不涉及 |
| \-\-model或\-m | 原始模型文件路径与文件名。 | 否 | 不涉及 |
| \-\-model\_path | 原始模型文件路径，该路径下可以存放多个模型文件。 | 否 | 不涉及 |
| \-\-weight或\-w | 权重文件路径与文件名。 | 否 | 不涉及 |
| \-\-job\_type或\-j | 调优模式。 | 是 | 不涉及 |
| \-\-framework或\-f | 原始框架类型。 | 否 | 不涉及 |
| \-\-input\_format | 输入数据格式。 | 否 | Caffe和ONNX默认为NCHW TensorFlow默认为NHWC |
| \-\-input\_shape | 指定模型输入数据的shape。 | 否 | 不涉及 |
| \-\-dynamic\_batch\_size | 设置动态Batch档位参数，适用于执行推理时，每次处理图片数量不固定的场景。 | 否 | 不涉及 |
| \-\-dynamic\_image\_size | 设置输入图片的动态分辨率参数。适用于执行推理时，每次处理图片宽和高不固定的场景。 | 否 | 不涉及 |
| \-\-dynamic\_dims | 设置ND格式下动态维度的档位。适用于执行推理时，每次处理任意维度的场景。 | 否 | 不涉及 |
| \-\-ip | NCS服务器IP。 | 是 | 不涉及 |
| \-\-port | NCS服务器端口号。 | 否 | 8000 |
| \-\-reload | 子图调优中断后重载。当前次流程被中断后，希望从上次的已有的调优阶段开始继续调优，使用\-\-reload进入重载模式。 | 否 | 不涉及 |
| \-\-device | 用于指定调优在运行环境上运行时使用的device。 | 否 | 不涉及 |
| \-\-progress\_bar | 用于开启或关闭调优时进度显示功能。 | 否 | on |
| \-\-singleop | 通过配置算子描述文件，对指定的算子（一个或者多个）进行调优。 | 否 | 不涉及 |
| \-\-output | 存放调优后的模型的路径以及文件名。 | 否 | 不涉及 |
| \-\-output\_type | 指定网络输出数据类型或指定某个输出节点的输出类型。 | 否 | 不涉及 |
| \-\-host\_env\_os | 若模型编译环境的操作系统及其架构与模型运行环境不一致时，则需使用本参数设置模型运行环境的操作系统类型。 | 否 | 不涉及 |
| \-\-host\_env\_cpu | 若模型编译环境的操作系统及其架构与模型运行环境不一致时，则需使用本参数设置模型运行环境的操作系统架构。 | 否 | 不涉及 |
| \-\-aicore\_num | 用于设置模型编译时使用的aicore数目。 | 否 | 默认值为最大值 |
| \-\-virtual\_type | 是否支持AOE调优在昇腾虚拟化实例生成的虚拟设备上运行。 该参数仅支持 Atlas 推理系列产品 。 | 否 | 0 |
| \-\-out\_nodes | 指定输出节点。 | 否 | 不涉及 |
| \-\-input\_fp16\_nodes | 指定输入数据类型为FP16的输入节点名称。 | 否 | 不涉及 |
| \-\-insert\_op\_conf | 插入算子的配置文件路径与文件名。 | 否 | 不涉及 |
| \-\-op\_name\_map | 扩展算子（非标准算子）映射配置文件路径和文件名。 | 否 | 不涉及 |
| \-\-is\_input\_adjust\_hw\_layout | 用于指定网络输入数据类型是否为FP16，数据格式是否为NC1HWC0。 | 否 | false |
| \-\-is\_output\_adjust\_hw\_layout | 用于指定网络输出的数据类型是否为FP16，数据格式是否为NC1HWC0。 | 否 | false |
| \-\-disable\_reuse\_memory | 内存复用开关。 | 否 | 0 |
| \-\-fusion\_switch\_file | 融合开关配置文件路径以及文件名。 | 否 | 不涉及 |
| \-\-enable\_scope\_fusion\_passes | 指定编译时需要生效的融合规则列表。 | 否 | 不涉及 |
| \-\-enable\_small\_channel | 是否使能small channel的优化，使能后在channel<=4的卷积层会有性能收益。 | 否 | 0 |
| \-\-compress\_weight\_conf | 要压缩的node节点列表配置文件路径以及文件名。 | 否 | 不涉及 |
| \-\-compression\_optimize\_conf | 模型压缩功能配置文件路径以及文件名，通过该参数使能配置文件中指定的模型压缩特性，从而提升网络性能。 | 否 | 不涉及 |
| \-\-buffer\_optimize | 是否开启buffer优化。 | 否 | l2\_optimize |
| \-\-precision\_mode | 选择算子精度模式。 | 否 | force\_fp16 |
| \-\-op\_select\_implmode | 选择算子是高精度实现还是高性能实现。 | 否 | high\_performance |
| \-\-optypelist\_for\_implmode | 列举算子optype的列表。 | 否 | 不涉及 |
| \-\-op\_debug\_level | TBE算子编译debug功能开关。 | 否 | 0 |
| \-\-log | 设置调优过程中日志的级别。 | 否 | 不涉及 |
| \-\-tune\_ops\_file | 通过配置文件指定算子名称或者算子类型，对指定的算子进行调优。 | 否 | 不涉及 |
| \-\-op\_precision\_mode | 设置具体某个算子的精度模式，通过该参数可以为多个算子设置不同的精度模式。 | 否 | 不涉及 |
| \-\-modify\_mixlist | 混合精度场景下，修改算子使用混合精度名单。 | 否 | 不涉及 |
| \-\-keep\_dtype | 保持原始网络模型编译时个别算子的计算精度不变。 | 否 | 不涉及 |
| \-\-customize\_dtypes | 模型编译时自定义某个或某些算子的计算精度。 | 否 | 不涉及 |
| \-\-tune\_optimization\_level | 调优模式，通过该参数可配置不同模式调优，包括高性能模式和正常模式。 | 否 | O2 |
| \-\-Fdeeper\_opat | 算子深度调优。 | 否 | 不涉及 |
| \-\-Fnonhomo\_split | 子图非均匀切分调优。 | 否 | 不涉及 |
| \-\-Fop\_format | 算子format调优。 | 否 | 不涉及 |
| \-\-sparsity | 使能全局稀疏特性。 | 否 | 0 |
| \-\-init\_bypass | 对于AOE调优框架和调优业务不感知的编译参数，可以通过“\-\-init\_bypass”在模型构建初始化阶段透传，具体透传的参数请参考options参数说明(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/atlasgeapi\_07\_0150.html)。 | 否 | 不涉及 |
| \-\-build\_bypass | 对于AOE调优框架和调优业务不感知的编译参数，可以通过“\-\-build\_bypass”在模型编译阶段透传，具体透传的参数请参考aclgrphBuildModel(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/atlasgeapi\_07\_0078.html)。 | 否 | 不涉及 |