The oneAPI-samples repository contains samples for the Intel® oneAPI Toolkits.

The contents of the default branch in this repository are meant to be used with the most recent released version of the Intel® oneAPI Toolkits.

You can find samples by browsing the oneAPI Samples Catalog. Using the catalog you can search on the sample titles or descriptions.

You can refine your browsing or searching through filtering on the following:

• Expertise (Getting Started, Tutorial, etc.)
• Programming language (C++, Python, or Fortran)
• Target device (CPU GPU, and FPGA)

Clone the repository by entering the following command:

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

Alternatively, you can download a zip file containing the primary branch in repository.

1. Click the Code button.
2. Select Download ZIP from the menu options.
3. After downloading the file, unzip the repository contents.

If you need samples for an earlier version of any of the Intel® oneAPI Toolkits, then use a tagged version of the repository that corresponds with the toolkit version.

Clone an earlier version of the repository using Git by entering a command similar to the following:

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

where <tag> is the GitHub tag corresponding to the toolkit version number, like 2023.2.0.

Alternatively, you can download a zip file containing a specific tagged version of the repository.

1. Select the appropriate tag.
2. Click the Code button.
3. Select Download ZIP from the menu options.
4. After downloading the file, unzip the repository contents.

The best oneAPI sample to start with depends on what you are trying to learn or types of problems you are trying to solve.

Note: The README.md included with each sample provides build instructions for all supported operating system. For samples run in Jupyter Notebooks, you might need to install or configure additional frameworks or package managers if you do not already have them on your system.

If you prefer to use an Integrated Development Environment (IDE) with these samples, you can download Visual Studio Code for use on Windows*, Linux*, and macOS*.

The oneAPI-sample repository is organized by high-level categories.

• AI-and-Analytics
  • End-to-End-Workloads
  • Features-and-Functionality
  • Getting-Started-Samples
  • Jupyter
• DirectProgramming
  • C++
  • C++SYCL
  • C++SYCL_FPGA
  • Fortran
• Libraries
• Publications
• RenderingToolkit
• Tools

Samples in this release are validated on the following platforms.

Intel(R) Xeon(R) Platinum 8352Y CPU @ 2.20GHz
Intel(R) OpenCL Graphics, Intel(R) Data Center GPU Max 1550 3.0, (pvc)
Opencl driver: Intel(R) FPGA Emulation Platform for OpenCL(TM), Intel(R) FPGA Emulation Device 1.2 [2023.16.6.0.22_223734]
Level Zero driver: Intel(R) Level-Zero, Intel(R) Data Center GPU Max 1550 1.3 [1.3.26241]
oneAPI package version:
- Intel oneAPI Base Toolkit Build Version: 2023.2.0.49397
- Intel oneAPI HPC Toolkit Build Version: 2023.2.0.49440
- Intel oneAPI Rendering Toolkit Build Version: 2023.2.0.49367

12th Gen Intel(R) Core(TM) i9-12900
Intel(R) UHD Graphics 770 3.0 ; (gen12, AlderLake-S GT1 [8086:4680])
Opencl driver: Intel(R) FPGA Emulation Platform for OpenCL(TM), Intel(R) FPGA Emulation Device 1.2 [2023.16.6.0.22_223734]
Level Zero driver: Intel(R) Level-Zero, Intel(R) UHD Graphics 750 1.3 [1.3.26241]
oneAPI package version:
- Intel oneAPI Base Toolkit Build Version: 2023.2.0.49397
- Intel oneAPI HPC Toolkit Build Version: 2023.2.0.49440
- Intel oneAPI Rendering Toolkit Build Version: 2023.2.0.49367

11th Gen Intel(R) Core(TM) i7-11700
Intel(R) UHD Graphics 750 3.0, (gen12, RocketLake)
Opencl driver: Intel(R) FPGA Emulation Platform for OpenCL(TM), Intel(R) FPGA Emulation Device 1.2 [2023.16.6.0.22_223734]
Level Zero driver: Intel(R) Level-Zero, Intel(R) UHD Graphics 750 1.3 [1.3.26241]
oneAPI package version:
- Intel oneAPI Base Toolkit Build Version: 2023.2.0.49397
- Intel oneAPI HPC Toolkit Build Version: 2023.2.0.49440
- Intel oneAPI Rendering Toolkit Build Version: 2023.2.0.49367

12th Gen Intel(R) Core(TM) i9-12900 Intel(R) UHD Graphics 770 3.0 ; (gen12, AlderLake-S GT1 [8086:4680])
Opencl driver: Intel(R) FPGA Emulation Platform for OpenCL(TM), Intel(R) FPGA Emulation Device 1.2 [2023.16.6.0.28_042959]
Level Zero driver: Intel(R) Level-Zero, Intel(R) UHD Graphics 750 1.3 [1.3.26561]
oneAPI package version:
- Intel oneAPI Base Toolkit Build Version: 2023.2.0.49396
- Intel oneAPI HPC Toolkit Build Version: 2023.2.0.49441
- Intel oneAPI Rendering Toolkit Build Version: 2023.2.0.49368

11th Gen Intel(R) Core(TM) i7-11700
Intel(R) UHD Graphics 750 3.0, (gen12, RocketLake)
Opencl driver: Intel(R) FPGA Emulation Platform for OpenCL(TM), Intel(R) FPGA Emulation Device 1.2 [2023.16.6.0.28_042959]
Level Zero driver: Intel(R) Level-Zero, Intel(R) UHD Graphics 750 1.3 [1.3.26370]
oneAPI package version:
- Intel oneAPI Base Toolkit Build Version: 2023.2.0.49396
- Intel oneAPI HPC Toolkit Build Version: 2023.2.0.49441
- Intel oneAPI Rendering Toolkit Build Version: 2023.2.0.49368

Intel(R) Core(TM) i5-8500B CPU @ 3.00GHz
- Intel oneAPI Base Toolkit Build Version: 2023.2.0.49370
- Intel oneAPI HPC Toolkit Build Version: 2023.2.0.49443
- Intel oneAPI Rendering Toolkit Build Version: 2023.2.0.49398

• If you are using Microsoft Visual Studio* 2019, you must use Microsoft Visual Studio 2019 version 16.4.0 or newer.
• Windows support for the FPGA code samples is limited to the FPGA emulator and optimization reports. Only Linux supports FPGA hardware compilation. See any FPGA code sample README.md for more details.
• If you encounter Error MSB6003 The specified task executable ... could not be run... when building a sample program, it might be due to the length of the directory path. Move the build directory to a location with a shorter path. Build the sample in the new location.

Code samples are licensed under the MIT license. See License.txt for details.

Third-party program licenses can be found here: third-party-programs.txt.

© Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.