昇腾CANN/ge：AddInput API文档

AddInput

【免费下载链接】geGE（Graph Engine）是面向昇腾的图编译器和执行器，提供了计算图优化、多流并行、内存复用和模型下沉等技术手段，加速模型执行效率，减少模型内存占用。 GE 提供对 PyTorch、TensorFlow 前端的友好接入能力，并同时支持 onnx、pb 等主流模型格式的解析与编译。项目地址: https://gitcode.com/cann/ge

产品支持情况

全量芯片支持。

头文件/库文件

• 头文件：#include <graph/named_io_node_builder.h>
• 库文件：libgraph.so、libgraph_static.a

功能说明

添加输入实例端口。用户按IR定义顺序依次添加输入实例，普通/可选输入使用IR名，动态输入使用ir_name0、ir_name1、……形式的连续实例名。

函数原型

NamedIoNodeBuilder &AddInput(const char_t *name) NamedIoNodeBuilder &AddInput(const char_t *name, const TensorDesc &desc)

• 第一个原型：添加输入实例端口，使用默认TensorDesc（DT_FLOAT + FORMAT_ND）。
• 第二个原型：添加带描述的输入实例端口，可指定数据类型、格式和形状。

参数说明

返回值说明

返回构建器引用，支持链式调用。

约束说明

• 输入实例需按IR定义顺序添加。

• 可选输入（OPTIONAL_INPUT）的使用方式：

  • 不传递可选输入：仅添加必选输入，跳过该可选输入即可。
  • 传递有效可选输入：按IR顺序在对应位置添加，使用默认TensorDesc。
  • 传递占位可选输入：使用带TensorDesc的重载，传入DT_UNDEFINED和FORMAT_RESERVED。
  • 可选输入最多只能提供一个实例，重复添加会导致校验失败。

• 若传递动态输入实例，实例名需从ir_name0开始连续编号，不能跳过中间序号。

• 若传入nullptr为name，该输入不会被添加。

调用示例

ge::Graph graph("test_graph"); ge::AscendString error_msg; // 构建一个Add算子节点 auto node = ge::NamedIoNodeBuilder(graph) .Type("Add") .Name("add_node") .AddInput("x1") .AddInput("x2") .AddOutput("y") .Build(error_msg); if (node != nullptr) { // 构建成功，节点已被添加到graph中 } else { // 构建失败，查看error_msg获取错误信息 }

【免费下载链接】geGE（Graph Engine）是面向昇腾的图编译器和执行器，提供了计算图优化、多流并行、内存复用和模型下沉等技术手段，加速模型执行效率，减少模型内存占用。 GE 提供对 PyTorch、TensorFlow 前端的友好接入能力，并同时支持 onnx、pb 等主流模型格式的解析与编译。项目地址: https://gitcode.com/cann/ge