---
title: 函数：get_cur_output_dims
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclpythondevg_01_0214.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclpythondevg_01_0214.html
indexId: 318e21fda655657cf1cc97fe8cd4f10804f31aa74545bf3384bf6fa84b1f04c275
---
# 函数：get_cur_output_dims

#### 产品支持情况

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


#### 功能说明

根据模型描述信息获取指定的模型输出tensor的实际维度信息。


#### 函数原型

- C函数原型
  1 aclError aclmdlGetCurOutputDims(const aclmdlDesc *modelDesc, size_t index, aclIODims *dims)

- python函数
  1 dims, ret = acl.mdl.get_cur_output_dims(model_desc, index)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| model\_desc | int，aclmdlDesc类型数据的指针地址。 需提前调用acl.mdl.create\_desc接口创建aclmdlDesc类型的数据。 |
| index | int，指定获取第几个输出的Dims，index值从0开始。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| dims | dict，输出实际维度信息。 若Tensor的“name”长度大于127，则在输出dims["name"]时，会将Tensor的“name”转换为“acl\_modelId\_${id}\_input\_${index}\_${随机字符串} ”格式并在转换后的“name”与原“name”之间建立映射关系，用户可调用acl.mdl.get\_tensor\_real\_name接口，传入转换后的“name”，获取原“name”（若向接口传入原“name”，则获取的还是原“name”）。 说明： 如果转换后的Tensor的“name”与模型中已有的Tensor的“name”冲突，则会在转换后的“name”尾部增加“\_${随机字符串} ”，否则不会增加随机字符串。 若Tensor的“name”长度小于或等于127，则在输出的dims["name"]时，按Tensor的“name”输出。 |
| ret | int，错误码。 返回0表示成功。 返回其它值(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclpythondevg\_01\_0911.html)表示失败。 |


#### 约束说明

当前仅支持通过本接口获取以下场景中的模型输出Tensor的维度信息：

- 通过模型转换设置多档Batch size或分辨率或维度值，实现动态Batch或动态分辨率或动态维度（ND格式）时。

  - 如果用户已调用    acl.mdl.set_dynamic_batch_size
设置Batch或调用    acl.mdl.set_dynamic_hw_size
接口设置输入图片的宽高或调用    acl.mdl.set_input_dynamic_dims
接口设置某动态维度的值，则可通过该接口获取指定模型输出Tensor的实际维度信息。
  - 如果用户未调用    acl.mdl.set_dynamic_batch_size
接口、    acl.mdl.set_dynamic_hw_size
接口或    acl.mdl.set_input_dynamic_dims
接口，则通过该接口可获取最大档的维度信息。
- 固定Shape场景下，通过该接口获取指定的模型输出Tensor的维度信息。