产品支持情况

产品	是否支持
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√
Atlas 200/300/500 推理产品	√

功能说明

编译指定算子。在编译算子前，可以调用aclSetCompileopt接口设置编译选项。

每个算子的输入、输出组织不同，需要应用在调用时严格按照算子输入、输出参数来组织算子，用户在调用aclopCompile时，AscendCL根据optype、输入tensor的描述、输出tensor的描述、attr等信息查找对应的任务，再编译算子。

函数原型

aclError aclopCompile(const char *opType,
int numInputs,
const aclTensorDesc *const inputDesc[],
int numOutputs,
const aclTensorDesc *const outputDesc[],
const aclopAttr *attr,
aclopEngineType engineType,
aclopCompileType compileFlag,
const char *opPath)

参数说明

参数名	输入/输出	说明
opType	输入	算子类型名称的指针。
numInputs	输入	算子输入tensor的数量。
inputDesc	输入	算子输入tensor的描述的指针数组。需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。 inputDesc数组中的元素个数必须与numInputs参数值保持一致。
numOutputs	输入	算子输出tensor的数量。
outputDesc	输入	算子输出tensor的描述的指针数组。需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。 outputDesc数组中的元素个数必须与numOutputs参数值保持一致。
attr	输入	算子属性的指针。需提前调用aclopCreateAttr接口创建aclopAttr类型。
engineType	输入	算子执行引擎。
compileFlag	输入	算子编译标识。
opPath	输入	算子实现文件（*.py）的路径的指针，不包含文件名。预留参数，当前仅支持设置为nullptr。

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

约束说明

编译动态Shape的算子时，如果Shape具体值不明确，但Shape范围明确，则在调用aclCreateTensorDesc接口创建aclTensorDesc类型时，需要将dims数组的表示动态维度的元素值设置为-1，再调用aclSetTensorShapeRange接口设置tensor的各个维度的取值范围；如果Shape具体值以及Shape范围都不明确（该场景预留），则在调用aclCreateTensorDesc接口创建aclTensorDesc类型时，需要将dims数组的值设置为-2，例如：int64_t dims[] = {-2}。
编译有可选输入的算子时，如果可选输入不使用，则需按此种方式创建aclTensorDesc类型的数据：aclCreateTensorDesc(ACL_DT_UNDEFINED, 0, nullptr, ACL_FORMAT_UNDEFINED)，表示数据类型设置为ACL_DT_UNDEFINED，Format设置为ACL_FORMAT_UNDEFINED，Shape信息为nullptr。
编译有constant输入的算子时，需要先调用aclSetTensorConst接口设置constant输入。调用aclopCompile接口、aclopExecuteV2接口前，设置的constant输入数据必须保持一致。