函数：get_dataset_num_buffers
函数：destroy_dataset
| C函数原型 | aclError aclmdlDestroyDataset(const aclmdlDataset *dataset) |
|---|---|
| Python函数 | ret = acl.mdl.destroy_dataset(dataset) |
| 函数功能 | 销毁aclmdlDataset类型的数据。 |
| 输入说明 | dataset：int，待销毁的aclmdlDataset的指针地址。 |
| 返回值说明 | ret：int，错误码 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 销毁类接口：调用该接口后，不能继续使用已释放或销毁的资源，建议调用该接口后，将相关资源设置为无效值（例如，置为0或None)。 |
父主题： aclmdlDataset
函数：add_dataset_buffer
| C函数原型 | aclError **aclmdlAddDatasetBuffer(**aclmdlDataset *dataset, aclDataBuffer *dataBuffer) |
|---|---|
| Python函数 | dataset, ret = acl.mdl.add_dataset_buffer(dataset, data_buffer) |
| 函数功能 | 向aclmdlDataset中增加aclDataBuffer。 |
| 输入说明 | dataset：int，待增加aclDataBuffer的aclmdlDataset地址。 data_buffer：int，待增加的aclDataBuffer地址。 |
| 返回值说明 | dataset：int，待增加aclDataBuffer的aclmdlDataset地址。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： aclmdlDataset
函数：get_dataset_num_buffers
| C函数原型 | size_t aclmdlGetDatasetNumBuffers(const aclmdlDataset *dataset) |
|---|---|
| Python函数 | index = acl.mdl.get_dataset_num_buffers(dataset) |
| 函数功能 | 获取aclmdlDataset中aclDataBuffer的个数。 |
| 输入说明 | dataset：int，aclmdlDataset数据对象的指针地址。 |
| 返回值说明 | index：int，aclDataBuffer数据类型的个数。 |
| 约束说明 | 无 |
父主题： aclmdlDataset
函数：get_dataset_buffer
| C函数原型 | aclDataBuffer***** aclmdlGetDatasetBuffer(const aclmdlDataset *dataset, size_t index) |
|---|---|
| Python函数 | data_buffer = acl.mdl.get_dataset_buffer(dataset, index) |
| 函数功能 | 获取aclmdlDataset中的第n个aclDataBuffer。 |
| 输入说明 | dataset：int，aclmdlDataset数据对象的指针地址。 index：int，表明获取的是第几个aclDataBuffer。 |
| 返回值说明 | data_buffer：int，aclDataBuffer数据对象指针地址。 - 获取成功，返回aclDataBuffer的指针地址。 - 获取失败返回空地址。 |
| 约束说明 | 无 |
父主题： aclmdlDataset
函数：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
在线提单