oneAPI-samples

项目介绍：oneAPI-samples

项目概述

oneAPI-samples 项目是一个代码样例库，专为 Intel® oneAPI 工具包设计。这些样例旨在展示如何使用这些工具包处理不同的计算任务。项目的默认分支包含与最新发布版本的工具包兼容的代码样本。

如何查找oneAPI样例

想要查找某个特定的样例，可以通过浏览 oneAPI 样例目录。用户可以根据样例的标题或描述进行搜索。目录还提供了多种过滤选项，帮助用户更快速地定位到所需的样例类型。可以根据以下几种条件进行筛选：

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

获取oneAPI样例

用户可以通过以下命令克隆此代码库：

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

或者，用户也可以下载该项目主分支的 ZIP 文件：

1. 点击 Code 按钮。
2. 从菜单选项中选择 Download ZIP。
3. 下载文件后，解压缩其中的内容即可。

早期版本样例获取

如果需要早期版本的 oneAPI 工具包样例，可以使用与工具包版本对应的标记版本。通过 Git 命令克隆早期版本，请输入类似以下的命令：

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

其中，<tag> 是对应的 GitHub 标签，比如 2024.2.0。

样例使用入门

选择哪个样例开始学习，取决于您希望学习的内容或解决的问题类型。以下是一些推荐的起始样例：

• 想学习 CPU、GPU 或 FPGA 上编程的基础，可以从 [Simple Add] 或 [Vector Add] 样例开始。
• 想学习人工智能的基本知识，可以参考 [AI 工具的入门样例]。
• 对图像渲染和光线追踪感兴趣，可以查看 [Intel® oneAPI 渲染工具包的入门样例]。

每个样例的 README.md 文件中都提供了在所有支持操作系统上构建的说明。如果样例是在 Jupyter Notebooks 中运行的，可能需要安装或配置额外的框架或包管理器。

使用集成开发环境 (IDE)

如果用户偏好使用集成开发环境（IDE），可以下载适用于 Windows、Linux 和 macOS 的 Visual Studio Code。

代码库结构

oneAPI-samples 仓库按照高层次的类别进行组织，包括：

• AI-and-Analytics
• DirectProgramming
• Libraries
• Publications
• RenderingToolkit
• Tools

平台验证

oneAPI-samples 已在几种环境中进行验证，包括 Ubuntu 22.04 和 Windows 11，详尽的硬件和驱动程序信息展示了项目在不同平台上的支持。

已知问题和限制

在 Windows 平台上，使用 Microsoft Visual Studio 2019 时，版本必须是 16.4.0 或更高版本。FPGA 代码样例在 Windows 平台上的支持仅限于 FPGA 模拟器和优化报告，而 FPGA 硬件编译仅支持 Linux。

其他资源

oneAPI-samples 除了一些精选的样例外，还提供了一些有价值的资源，以帮助提升生产力，比如 OpenVINO™ 笔记本、Intel® Gaudi® 教程及 Intel® AI 参考模型等。

许可证

本项目中的代码样例是基于 MIT 许可证授权的。第三方程序的许可证信息同样可以在项目中找到。

Intel、Intel 标识及其它 Intel 标志是 Intel Corporation 或其子公司的商标。其他名称和品牌可能被声明为其他所有者的财产。