oneAPI samples

Oneapi样品

Oneapi-Samples存储库包含Intel®Oneapi工具包的样品。

该存储库中默认分支的内容旨在与最新发布的Intel®oneapi工具包一起使用。

查找Oneapi样品

您可以通过浏览ONEAPI样品目录来找到样品。使用目录，您可以在示例标题或描述上搜索。

您可以通过以下过滤来完善浏览或搜索：

• 专业知识（入门，教程等）
• 编程语言（C ++，Python或Fortran）
• 目标设备（CPU GPU和FPGA）

获取oneapi样品

通过输入以下命令来克隆存储库：

git clone https://github.com/oneapi-src/oneAPI-samples.git

另外，您可以下载包含存储库中主要分支的zip文件。

1. 单击代码按钮。
2. 从菜单选项中选择下载ZIP 。
3. 下载文件后，解压缩存储库内容。

获取更早的Oneapi样品版本

如果您需要任何Intel®Oneapi工具包的较早版本的示例，请使用与工具包版本相对应的存储库的标记版本。

通过输入类似于以下命令来使用GIT克隆较早的存储库版本：

git clone -b <tag> https://github.com/oneapi-src/oneAPI-samples.git

其中<tag>是对应于工具包版本号的github标签，例如2024.2.0 。

另外，您可以下载包含存储库特定标记版本的zip文件。

1. 选择适当的标签。
2. 单击代码按钮。
3. 从菜单选项中选择下载ZIP 。
4. 下载文件后，解压缩存储库内容。

开始使用Oneapi样品

首先，最好的ONEAPI样本取决于您要学习的内容或要解决的问题类型。

如果您想了解...	从...开始
CPU，GPU或FPGA的写作，编译和建筑计划的基础知识	简单添加或矢量添加样品 （您可以通过删除不必要的元素并添加代码和构建要求来将这些样本用作入门项目。）
使用人工智能的基础知识	AI工具的入门样品
图像渲染工作负载和射线跟踪的基础知识	intel®Oneapi渲染工具包（渲染套件）入门样品
如何修改或创建符合SYCL项目的构建文件	向量添加样品

注意：每个样本中包含的readme.md提供了所有受支持操作系统的构建说明。对于在Jupyter笔记本电脑中运行的示例，如果您尚未在系统上使用它们，则可能需要安装或配置其他框架或软件包管理器。

使用集成的开发环境（IDE）

如果您希望与这些样本一起使用集成开发环境（IDE），则可以下载可在Windows*，Linux*和MacOS*上使用的Visual Studio代码。

存储库结构

ONEAPI样本存储库由高级类别组织。

• AI和分析
  • 端到端工作负载
  • 功能和功能
  • 获取启动样本
  • Jupyter
• 直接程序
  • C ++
  • C ++ SYCL
  • C ++ SYCL_FPGA
  • Fortran
• 库
• 出版物
• RenderingToolkit
• 工具

平台验证

Ubuntu 22.04

英特尔（R）Xeon（R）Platinum 8468V
英特尔（R）数据中心GPU最大1100
OPENCL驱动程序：Intel（R）Opencl，Intel（R）Xeon（R）Platinum 8468V Opencl 3.0（构建0）[2024.18.7.0.0.11_160000]
级零驱动程序：Intel（R）Level-Zero，Intel（R）数据中心GPU Max 1100 1.3 [1.3.28202]
Oneapi软件包版本：
- Intel Oneapi HPC工具包构建版本：2025.0.0.825

Windows 11

第11代英特尔（R）核心（TM）I7-1185G7 @ 3.00GHz
Intel（R）Iris（R）XE图形OPENCL 3.0 NEO
OPENCL驱动程序：Intel（R）OpenCl，第11代英特尔（R）Core（TM）I7-1185G7 @ 3.00GHz OpenCL 3.0（构建0）[2024.18.9.0.28_160000]
级零驱动程序：Intel（r）Oneapi统一运行时，超过Zero，Intel（R）Iris（R）XE Graphics 12.0.0 [1.3.27193]
Oneapi软件包版本：
- Intel Oneapi HPC工具包构建版本：2025.0.0.822

已知问题和限制

视窗

• 如果您使用的是Microsoft Visual Studio* 2019，则必须使用Microsoft Visual Studio 2019版本16.4.0或更新。
• Windows对FPGA代码样本的支持仅限于FPGA仿真器和优化报告。只有Linux支持FPGA硬件汇编。有关更多详细信息，请参见任何FPGA代码示例readme.md。
• 如果遇到Error MSB6003 The specified task executable ... could not be run...构建示例程序时，可能是由于目录路径的长度。将build目录移至带有较短路径的位置。在新位置构建样本。

代码样本的其他资源

来自基于ONEAPI的项目，库和工具的样本列表。此外，这里还列出了其他不一定基于Oneapi的AI项目的最激动人心的样本，还可以为您提供提高生产率的最新和宝贵的资源。

• OpenVino™笔记本：用于学习和实验OpenVino™Toolkit的现成运行的Jupyter笔记本，这是一个开源AI工具包，它使得更易于编写一次，在任何地方部署。这些笔记本介绍了OpenVino基础知识，并教授开发人员如何利用API来优化深度学习推断。
• Intel®Gaudi®教程：带有分步说明的教程，用于在Intel Gaudi AI处理器上运行Pytorch和Pytorch Lightning模型，用于培训和推断，从初学者级别到高级用户。
• 按智能排行榜驱动的排行榜：该排行榜庆祝并提高了AI开发人员社区在英特尔硬件上开发的模型的可发现性。我们为开发人员提供示例代码和资源（开发人员程序），以部署（推理）AI PC，Intel®Xeon®可伸缩处理器，Intel®Gaudi®处理器，Intel®ARC™GPU和Intel®DataCenter GPU。
• 英特尔®AI参考模型：此存储库包含与许多流行的开源机器学习模型，该模型链接到预先训练的模型，示例脚本，最佳实践和分步教程，该模型由Intel优化，以在Intel®Xeon®可扩展处理器和Intel®DataCenter GPU上运行。
• Awesome-oneapi：一个社区来源的ONEAPI和SYCL项目列表，用于各种行业领域的解决方案。
• 生成的AI示例：诸如Chenqna，Copilot之类的Genai示例集，其中说明了企业AI（OPEA）项目开放平台的管道功能。 OPEA是一个生态系统编排框架，旨在整合性能的Genai技术和工作流程，从而使Genai的采用和业务价值更快。

许可证

代码样本是根据MIT许可证的。有关详细信息，请参见License.txt。

可以在此处找到第三方计划许可证：第三方Programs.txt。

通知和免责声明

©英特尔公司。英特尔，英特尔徽标和其他英特尔商标是英特尔公司或其子公司的商标。其他名称和品牌可能被认为是他人的财产。