---
title: --singleop
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/devaids/atctool/atlasatcparam_16_0021.html
sourcePath: /source/zh/canncommercial/900/devaids/atctool/atlasatcparam_16_0021.html
indexId: 23ad9f6cb9306f2b04cf4ab2bb9c16c729f945bd50d815998d7347d28bb6f55272
---
# --singleop

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明


单算子描述文件，将单个算子描述文件（JSON格式）转换成适配AI处理器的离线模型，以便进行后续的单算子功能验证。

兼容性说明：

动态shape算子场景和昇腾虚拟化实例场景，om离线模型转换环境的CANN软件包版本，必须与运行环境的CANN软件包版本相同。

（昇腾虚拟化实例主要是指NPU资源虚拟化的场景，其主要目的是为了通过相互隔离的vNPU虚拟实例提升物理NPU资源利用率。）


#### 关联参数

使用该参数时，只有如下参数可以配合使用，其中--output、--soc_version为必填。

- Atlas 200I/500 A2 推理产品可配合使用的参数：

  -     --output

  -     --soc_version

  -     --precision_mode

  -     --precision_mode_v2

  -     --op_select_implmode

  -     --optypelist_for_implmode

  -     --enable_small_channel

  -     --sparsity

  -     --log

  -     --debug_dir

  -     --op_compiler_cache_mode

  -     --op_compiler_cache_dir

  -     --atomic_clean_policy

  -     --customize_dtypes

  -     --is_weight_clip

- Atlas 推理系列产品可配合使用的参数：

  -     --output

  -     --soc_version

  -     --core_type

  -     --aicore_num

  -     --precision_mode

  -     --precision_mode_v2

  -     --op_select_implmode

  -     --optypelist_for_implmode

  -     --log

  -     --debug_dir

  -     --op_compiler_cache_mode

  -     --op_compiler_cache_dir

  -     --atomic_clean_policy

  -     --customize_dtypes

  -     --is_weight_clip

- Atlas 训练系列产品可配合使用的参数：

  -     --output

  -     --soc_version

  -     --precision_mode

  -     --precision_mode_v2

  -     --op_select_implmode

  -     --optypelist_for_implmode

  -     --enable_small_channel

  -     --log

  -     --debug_dir

  -     --op_compiler_cache_mode

  -     --op_compiler_cache_dir

  -     --atomic_clean_policy

  -     --customize_dtypes

  -     --is_weight_clip

- Atlas A2 训练系列产品 / Atlas A2 推理系列产品可配合使用的参数：

  -     --output

  -     --soc_version

  -     --precision_mode

  -     --precision_mode_v2

  -     --op_select_implmode

  -     --optypelist_for_implmode

  -     --enable_small_channel

  -     --sparsity

  -     --allow_hf32

  -     --log

  -     --debug_dir

  -     --op_compiler_cache_mode

  -     --op_compiler_cache_dir

  -     --atomic_clean_policy

  -     --customize_dtypes

  -     --is_weight_clip

- Atlas A3 训练系列产品 / Atlas A3 推理系列产品可配合使用的参数：

  -     --output

  -     --soc_version

  -     --precision_mode

  -     --precision_mode_v2

  -     --op_select_implmode

  -     --optypelist_for_implmode

  -     --enable_small_channel

  -     --sparsity

  -     --allow_hf32

  -     --log

  -     --debug_dir

  -     --op_compiler_cache_mode

  -     --op_compiler_cache_dir

  -     --atomic_clean_policy

  -     --customize_dtypes

  -     --is_weight_clip

- Atlas 350 加速卡可配合使用的参数：

  -     --output

  -     --soc_version

  -     --precision_mode

  -     --precision_mode_v2

  -     --op_select_implmode

  -     --optypelist_for_implmode

  -     --enable_small_channel

  -     --sparsity

  -     --allow_hf32

  -     --log

  -     --debug_dir

  -     --op_compiler_cache_mode

  -     --op_compiler_cache_dir

  -     --atomic_clean_policy

  -     --customize_dtypes

  -     --is_weight_clip


#### 参数取值

参数值：单算子描述文件（JSON格式）格式以及参数配置请参见单算子模型转换。

参数值约束：该参数指定的单算子都是基于Ascend IR定义的，关于单算子的详细定义请参见“Ascend IR算子规格说明(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/aolapi/operatorlist_00093.html)”章节。


#### 推荐配置及收益

无。


#### 示例

下面以Add单算子为例进行说明，该单算子对应的描述文件为add.json ，将该文件上传到ATC工具所在服务器任意目录，例如上传到$HOME/singleop，使用示例如下：

```
--singleop=
$HOME/singleop/add.json
--output=
$HOME/singleop/out/op_model
--soc_version=
<soc_version>
```


#### 依赖约束

- 使用约束
  单算子JSON文件转换成离线模型场景，如果希望模型转换时只使用TBE算子（不查找AI CPU算子，找不到TBE算子则报错），还需设置如下环境变量：

```
export ASCEND_ENGINE_PATH=${INSTALL_DIR}/lib64/plugin/opskernel/libfe.so:${INSTALL_DIR}/lib64/plugin/opskernel/libge_local_engine.so:${INSTALL_DIR}/lib64/plugin/opskernel/librts_engine.so
```


  执行上述命令后，如果用户想要执行其他操作，需要删除上述环境变量：执行unset ASCEND_ENGINE_PATH命令，使其失效。

  其中，${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。


- 接口约束
  单算子描述文件转换后的om离线模型文件，使用应用工程进行模型推理时，需调用单算子模型加载接口加载算子模型（例如aclopSetModelDir接口），最后调用单算子执行接口执行算子（例如aclopExecuteV2接口）。

  接口详细说明请参见“单算子模型执行(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/aclcppdevg_03_0244.html)”章节。