aclopCompile

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√

功能说明

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

每个算子的输入、输出组织不同，在调用接口时严格按照算子输入、输出参数来组织算子，用户在调用aclopCompile时，接口会根据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输入数据必须保持一致。