CANN/ge 离线编译API文档

发布时间:2026/11/8 2:20:10

CANN/ge 离线编译API文档 OfflineCompile【免费下载链接】geGEGraph Engine是面向昇腾的图编译器和执行器提供了计算图优化、多流并行、内存复用和模型下沉等技术手段加速模型执行效率减少模型内存占用。 GE 提供对 PyTorch、TensorFlow 前端的友好接入能力并同时支持 onnx、pb 等主流模型格式的解析与编译。项目地址: https://gitcode.com/cann/ge产品支持情况产品是否支持Atlas A3 训练系列产品/Atlas A3 推理系列产品√Atlas A2 训练系列产品/Atlas A2 推理系列产品√模块导入from ge.offline_compile import ( build_initialize, build_finalize, build_model, save_model, bundle_build_model, bundle_save_model, GraphWithOptions, ModelBuffer ) from ge.error import GeError功能说明离线编译模块提供将计算图编译为离线模型.om文件的能力。支持单图编译build_model和多图 bundle 编译bundle_build_model。使用流程如下调用build_initialize初始化离线编译资源。调用build_model编译单个图或调用bundle_build_model编译多图为 bundle 离线模型。调用save_model或bundle_save_model将编译结果保存为.om文件。调用build_finalize释放离线编译资源。build_options中的配置优先级高于build_initialize中的global_options。当 GE 底层接口执行失败时build_initialize、build_model、save_model、bundle_build_model、bundle_save_model将抛出GeError。GeError继承自RuntimeError 异常信息包含 GE 内部错误信息和接口上下文。数据类GraphWithOptions一个图与其对应的编译选项的组合用于 bundle 编译场景。dataclass class GraphWithOptions: graph: Graph build_options: Dict[str, str]属性类型说明graphGraph待编译的计算图对象build_optionsDict[str, str]该图对应的编译选项字典键和值均为字符串默认为空字典类ModelBuffer离线模型缓冲区类用于存储编译后的离线模型数据。该类不支持直接实例化由build_model或bundle_build_model返回。方法/属性说明lengthproperty获取模型缓冲区长度字节返回 intget_length()获取模型缓冲区长度字节返回 int函数原型build_initializedef build_initialize(global_options: Optional[dict] None) - None初始化离线编译所需的资源。build_finalizedef build_finalize() - None释放离线编译资源。build_modeldef build_model(graph: Graph, build_options: Optional[dict] None) - ModelBuffer编译单个计算图为离线模型模型数据保存在内存中。save_modeldef save_model(output_file: str, model: ModelBuffer) - None将内存中的离线模型序列化为.om文件。bundle_build_modeldef bundle_build_model(graph_with_options: List[GraphWithOptions]) - ModelBuffer编译多个图为 bundle 离线模型。bundle_save_modeldef bundle_save_model(output_file: str, model: ModelBuffer) - None将内存中的 bundle 离线模型序列化为.om文件。参数说明build_initialize参数类型必选说明global_optionsOptional[dict]否全局编译配置字典键和值均为字符串。默认为 None表示不传入额外配置build_model参数类型必选说明graphGraph是待编译的计算图对象build_optionsOptional[dict]否图级别的编译配置字典键和值均为字符串。配置优先级见约束说明。默认为 Nonesave_model参数类型必选说明output_filestr是输出模型文件的基础名称。生成的离线模型文件名自动以.om为后缀。若文件名中包含操作系统和架构信息则该 OM 文件仅可在对应的操作系统和架构的运行环境中使用modelModelBuffer是离线模型缓冲区对象bundle_build_model参数类型必选说明graph_with_optionsList[GraphWithOptions]是包含多个GraphWithOptions的列表每个元素包含一个计算图及其编译选项。列表中必须包含 2 个及以上图bundle_save_model参数类型必选说明output_filestr是输出模型文件的基础名称。生成的离线模型文件名自动以.om为后缀。若文件名中包含操作系统和架构信息则该 OM 文件仅可在对应的操作系统和架构的运行环境中使用modelModelBuffer是bundle 离线模型缓冲区对象返回值说明build_model返回值类型说明modelModelBuffer包含编译后离线模型数据的缓冲区对象bundle_build_model返回值类型说明modelModelBuffer包含编译后 bundle 离线模型数据的缓冲区对象其他函数build_initialize、build_finalize、save_model、bundle_save_model无返回值。约束说明使用离线编译模块前必须先调用build_initialize初始化资源使用完毕后必须调用build_finalize释放资源。build_options中键和值必须均为字符串类型。bundle_build_model的graph_with_options列表中必须包含 2 个及以上图。ModelBuffer对象不支持拷贝copy和深拷贝deepcopy也不支持直接实例化。save_model和bundle_save_model的output_file参数为输出文件的基础名称系统会自动添加.om后缀。build_options中的配置优先级高于build_initialize中的global_options。GE 底层接口执行失败时将抛出 GeError异常信息包含 GE 内部错误信息和接口上下文。使用示例from ge.offline_compile import ( build_initialize, build_finalize, build_model, save_model, bundle_build_model, bundle_save_model, GraphWithOptions ) from ge.graph import Graph # 初始化离线编译资源 build_initialize({log_level: 0}) # 单图编译 model build_model(graph, {input_format: ND}) save_model(output_model, model) print(f模型大小{model.length} 字节) # 多图 bundle 编译 gwo_list [ GraphWithOptions(graph1, {input_format: ND}), GraphWithOptions(graph2, {input_format: NCHW}), ] bundle_model bundle_build_model(gwo_list) bundle_save_model(bundle_output, bundle_model) # 释放离线编译资源 build_finalize()【免费下载链接】geGEGraph Engine是面向昇腾的图编译器和执行器提供了计算图优化、多流并行、内存复用和模型下沉等技术手段加速模型执行效率减少模型内存占用。 GE 提供对 PyTorch、TensorFlow 前端的友好接入能力并同时支持 onnx、pb 等主流模型格式的解析与编译。项目地址: https://gitcode.com/cann/ge创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/8 5:05:59

Claude 官方系统提示词归档:34 个版本怎么读不迷路

Claude 官方系统提示词归档:34 个版本怎么读不迷路 【免费下载链接】system_prompts_leaks Extracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, …

2026/11/8 21:47:30

德州电工证去哪报名 老电工告诉你在哪考不走弯路

德州电工证去哪报名 老电工告诉你在哪考不走弯路 之前考的证在外省能不能转过来?这几乎是所有想在德州从事电工工作的人都会问的问题。尤其是在山东德州,很多外地人因为工作调动或就业需求,需要把之前在别的省份考的电工证转过来,但流程和政策并不透明。…

2026/11/8 21:47:30

电工证年审在哪里考真实经历告诉你别怕挂科

电工证年审在哪里考真实经历告诉你别怕挂科 实操考试心里没底怕挂科,我身边好几个朋友在考电工证的时候都因为实操没过,浪费了不少时间和钱。今天就以一个洛阳中小施工企业的负责人身份,讲讲我们是怎么搞定电工证年审的,也希望能帮到正在备考或准备年审的…

2026/11/8 21:47:30

邢台哪里考电工证值不值得考 证书过期了不知道怎么复审延期

邢台哪里考电工证值不值得考 证书过期了不知道怎么复审延期 证书过期了不知道怎么复审延期,你不是一个人。身边很多电工朋友都遇到过这个问题,特别是那些在工地、工厂、维修单位从事一线工作的电工,特种作业操作证一旦过期,不仅影响日常工作,还可能面临…

2026/11/8 21:47:30

五常哪里考电工证内部消息全公开 电工证怎么考最靠谱

五常哪里考电工证内部消息全公开 电工证怎么考最靠谱 急需特种作业证才能上岗找工作,你是不是也正为【五常哪里考电工证】头疼?别急,我来给你内部消息,告诉你怎么考电工证最靠谱,不走弯路,直接上岗。 五常电工证考试最新政策和报考渠道…

2026/11/8 21:47:30

电工证理论多少分及格?多久拿证?别怕考不过白交培训费!

电工证理论多少分及格?多久拿证?别怕考不过白交培训费! 怕考不过白交培训费?这是很多想考电工证的人最担心的问题。尤其是像济源的建筑工人,平时工作忙,抽空备考都难,一想到培训费打了水漂就心疼。今天就来说说电工证理论考试多少分及格、多久能拿证,…

2026/11/8 21:42:30

定州市电工证培训时间怎么安排?郑州报考避坑指南全解析

定州市电工证培训时间怎么安排?郑州报考避坑指南全解析 你正准备上岗找工作,却发现没有电工证,企业直接pass?别急,今天就来聊聊【定州市电工证培训时间】怎么安排最合理,还有郑州报考避坑指南,带你避开那些踩坑的弯路。 为什么电工证这么重要?…

2026/11/8 0:00:27

电工证丢失还能补吗?千万别踩坑,丢了证等于失业

电工证丢失还能补吗?千万别踩坑,丢了证等于失业 你正在找工作,但手里的电工证突然丢了,这下怎么办?别急,先别慌, 电工证丢失还能补吗 ?答案是肯定的,但 千万别踩坑 ,补办流程如果不了解,可能会耽误你上岗、甚至影响到你的收入。…

2026/11/8 0:00:27

电工证丢失还能补吗?千万别踩坑,丢了证等于失业

电工证丢失还能补吗?千万别踩坑,丢了证等于失业 你正在找工作,但手里的电工证突然丢了,这下怎么办?别急,先别慌, 电工证丢失还能补吗 ?答案是肯定的,但 千万别踩坑 ,补办流程如果不了解,可能会耽误你上岗、甚至影响到你的收入。…

2026/11/7 14:54:47

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/7 14:50:12

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑