函数：create_desc
函数：set_dataset_tensor_desc
| C函数原型 | aclError **aclmdlSetDatasetTensorDesc(**aclmdlDataset *dataset, aclTensorDesc *tensorDesc, size_t index) |
|---|---|
| Python函数 | dataset, ret = acl.mdl.set_dataset_tensor_desc(dataset, tensorDesc, index) |
| 函数功能 | 如果模型输入或输出的Shape是动态的，在模型执行之前调用本接口设置模型输入或输出的Tensor描述信息，同步接口。 Atlas 200/500 A2推理产品，不支持该接口。 |
| 输入说明 | **dataset：**待增加aclTensorDesc的aclmdlDataset地址，表示模型执行的输入或输出数据结构。 需提前调用acl.mdl.create_dataset接口创建aclmdlDataset类型的数据，再调用acl.mdl.add_dataset_buffer接口向aclmdlDataset中增加aclDataBuffer。 **tensorDesc：**待增加的aclTensorDesc地址，表示模型执行时对应的输入或输出的Tensor描述。 需提前调用acl.create_tensor_desc接口创建aclTensorDesc类型的数据，当前只有设置模型输入、输出Tensor描述信息中的维度信息有效（对应acl.create_tensor_desc接口中的代表维度个数的numDims参数、代表维度大小的dims参数），设置数据类型、Format无效。 此处设置的维度个数、维度大小必须在模型构建时设置的输入Shape范围内，模型构建的详细说明请参见模型构建。 **index：**表示第几个输入或输出的序号。 模型存在多个输入、输出时，为避免序号出错，可以先调用acl.mdl.get_input_name_by_index、acl.mdl.get_output_name_by_index接口获取输入、输出的名称，根据输入、输出名称所对应的index来设置。 |
| 返回值说明 | **dataset：**待增加aclTensorDesc的aclmdlDataset指针地址，表示模型执行的输入或输出数据结构。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 对同一个模型，acl.mdl.set_dynamic_batch_size接口、acl.mdl.set_dynamic_hw_size接口、acl.mdl.set_input_dynamic_dims接口、acl.mdl.set_dataset_tensor_desc接口，只能调用其中一个接口。 |
父主题： aclmdlDataset
函数：get_dataset_tensor_desc
| C函数原型 | aclTensorDesc *aclmdlGetDatasetTensorDesc(const aclmdlDataset *dataset, size_t index) |
|---|---|
| Python函数 | tensorDesc =acl.mdl.get_dataset_tensor_desc(dataset, index) |
| 函数功能 | 如果模型输入或输出的Shape是动态的，模型在模型执行之后可以调用本接口从aclmdlDataset类型的数据（该类型用于描述模型推理时的输入数据、输出数据）中获取指定的输入或者输出的Tensor描述信息。 典型场景举例：如果模型输入Shape是动态的，在模型执行之前调acl.mdl.set_dataset_tensor_desc设置该输入的tensor描述信息，在模型执行之后，调用acl.mdl.get_dataset_tensor_desc接口获取模型动态输出的Tensor描述信息。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | **dataset：**表示模型执行的输入或输出数据结构。 **index：**表示第几个输入或输出的序号。 模型存在多个输入、输出时，为避免序号出错，可以先调用acl.mdl.get_input_name_by_index、acl.mdl.get_output_name_by_index接口获取输入、输出的名称，根据输入、输出名称所对应的index来设置。 |
| 返回值说明 | **tensorDesc：**返回指定输入或输出的tensor描述信息。 |
父主题： aclmdlDataset
函数：create_desc
| C函数原型 | aclmdlDesc***** aclmdlCreateDesc() |
|---|---|
| Python函数 | desc = acl.mdl.create_desc() |
| 函数功能 | 创建aclmdlDesc类型的数据。同步接口。 |
| 输入说明 | 无 |
| 返回值说明 | desc：int，aclmdlDesc类型对象的地址。 |
| 约束说明 | 无 |
父主题： aclmdlDesc
函数：destroy_desc
| C函数原型 | aclError **aclmdlDestroyDesc(**aclmdlDesc *modelDesc) |
|---|---|
| Python函数 | ret = acl.mdl.destroy_desc(model_desc) |
| 函数功能 | 销毁aclmdlDesc类型的数据。同步接口。 |
| 输入说明 | model_desc：int，待销毁的aclmdlDesc的指针地址。 |
| 返回值说明 | ret：int，错误码 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： aclmdlDesc
函数：get_desc
| C函数原型 | aclError **aclmdlGetDesc(**aclmdlDesc *modelDesc, uint32_t modelId) |
|---|---|
| Python函数 | ret = acl.mdl.get_desc(model_desc, model_id) |
| 函数功能 | 根据模型ID获取该模型的aclmdlDesc类型数据。同步接口。 |
| 输入说明 | model_desc：int，aclmdlDesc类型数据的指针地址。 model_id：int，模型ID。 |
| 返回值说明 | ret：int，错误码 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： aclmdlDesc
函数：get_num_inputs
| C函数原型 | size_t **aclmdlGetNumInputs(**aclmdlDesc *modelDesc) |
|---|---|
| Python函数 | size = acl.mdl.get_num_inputs(model_desc) |
| 函数功能 | 根据aclmdlDesc类型的数据，获取模型的输入个数。同步接口。 |
| 输入说明 | model_desc：int，aclmdlDesc类型数据的指针地址。 |
| 返回值说明 | size：int，模型的输入个数。 |
| 约束说明 | 无 |
父主题： aclmdlDesc
在线提单