Intel® oneAPI Base Toolkit supports direct programming and API programming, and delivers a unified language and libraries that offer full native code support across a range of hardware including Intel® and compatible processors, Intel® Processor Graphics Gen9, Gen11, Gen12, Intel® Iris® Xe MAX graphics, Intel® Data Center GPU Max Seriesand Intel® Arria® 10 or Intel® Stratix® 10 SX FPGAs. It offers direct programming model as well as API-based programming model, and it also contains analysis & debug tools for development and performance tuning.
Major Features Supported
Please visit Intel® oneAPI Toolkit and Component Versioning Schema for semantic versioning schema detail.
New in Intel® oneAPI Base Toolkit 2023.0.0
Toolkit Level Updates
- The oneAPI 2023 tools empower developers to maximize the advanced capabilities of 4th Gen Intel® Xeon® Scalable Processors (formerly codenamed Sapphire Rapids) with Intel® Advanced Matrix Extensions (Intel® AMX), Quick assist Technology (QAT), Intel® AVX-512, bfloat16, and more as well as Intel® Data Center GPU Max Series (formerly codenamed Ponte Vecchio) with datatype flexibility, Intel® Xe Matrix Extensions (Intel® XMX), vector engine, XE Link, and other features.
- Improved support for SYCL: To aid code portability across architectures and new architecture adoption, improved SYCL support was added to the Intel® oneAPI DPC++/C++ Compiler. Intel® oneAPI DPC++ Library expands support of the C++ standard library in SYCL kernels with additional functions to simplify coding of common algorithms.
- Easier CUDA code migration: CUDA-to-SYCL code migration is enhanced to create single source code for multiarchitecture systems. The Intel® DPC++ Compatibility Tool (based on the open source SYCLomatic project) adds more than 100 new CUDA APIs migrating to the equivalent SYCL language and library functions including runtime, math, neural network domains.
Intel® oneAPI DPC++ Compiler 2023.0.0
- Improve accelerated computing support with more SYCL2020 and OpenMP 5.0, 5.1 features
- Improve SYCL CPU and GPU offload performance
- SYCL/DPC++ is on-par with OpenMP on CPU. E.g. Geomean of SYCL/DPC++ HCPBench 25 WLs is 106% of OpenMP
- SYCL/DPC++ HCPBench (25 WLs) shows better geomean performance on PVC over CUDA@A100, e.g. HCPBench@PVC is 138% of CUDA@A100, oneBench@PVC is 110% of CUDA@A100.
Intel® oneAPI DPC++ Library 2022.0.0
- oneDPL adds the ability to use OpenMP for thread-level parallelism. This allows developers who already use OpenMP on multicore CPUs to also use oneDPL high-level parallel algorithms in their codes without introducing extra dependencies and performance risks
Intel® DPC++ Compatibility Tool 2023.0.0
- The Intel® DPC++ Compatibility Tool (based on the open source SYCLomatic project) adds more than 100 new CUDA APIs migrating to the equivalent SYCL language and library functions including runtime, math, and neural network domains.
Intel® oneAPI Math Kernel Library 2023.0.0
- Intel® oneAPI Math Kernel Library increases CUDA library function API compatibility coverage for BLAS and FFT; for Sapphire Rapids, leverages Intel® XMX to optimize matrix multiply computations for TF32, FP16, BF16, and INT8 data types; and provides interfaces for SYCL and C/Fortran OpenMP offload programming.
Intel® oneAPI Video Processing Library 2023.0.0
- The Intel oneAPI Video Processing Library supports the industry’s only hardware AV1 codec in the Intel Data Center GPU Flex Series and Intel® Arc™ processors; expands OS support for RHEL9, CentOS, Stream 9, SLES15Sp4, and Rocky 9 Linux; and adds parallel encoding feature to sample_multi_transcode.
Intel® Distribution for GDB* 2023.0.0
- Intel® Distribution for GDB* allows developers now to efficiently debug applications running on discrete GPUs using the L0 graphics drivers.
- Intel® Distribution for GDB* has been updated with more functional and stability improvements.
Intel® Distribution for Python 2023.0
- To reduce the default download size of the Intel Base Toolkit, Intel Distribution for Python* is now available via separate download.
Intel® VTune™ Profiler 2023.0.0
- Intel® VTune™ Profiler enables ability to identify MPI imbalance issues via its Application Performance Snapshot feature; and adds support for Sapphire Rapids, Ponte Vecchio, and 13th Gen Intel® Core™ processors.
Intel® Advisor 2023.0.0
Intel® Advisor adds automated roofline analysis for Intel Data Center GPU MAX Series to identify and prioritize memory, cache, or compute bottlenecks and understand their causes, and delivers actionable recommendations for optimizing data-transfer reuse costs of CPU-to-GPU offloading.
Intel® oneAPI Threading Building Blocks 2021.8.0
- Intel® oneAPI Threading Building Blocks improves support and use of the latest C++ standard for parallel_sort, offers an improved synchronization mechanism to reduce contention when multiple task_arena calls are used concurrently, and adds support for Microsoft Visual Studio 2022 and Windows Server 2022.
Intel® Integrated Performance Primitives 2021.7.0
- The latest Intel® Integrated Performance Primitives release adds optimization for lossless compression method, zlib 1.2.13 in Intel® IPP Data compression. These new optimizations help improve the quality and speed of compression/decompression, in various data compression applications.
- Fixed errors in planar YCbCr to RGB conversion in Intel® IPP Image Processing Color Conversions functions
- Ongoing performance improvements and implementations of customer reported requests.
Intel® oneAPI Collective Communications Library 2021.8.0
- Provides optimized performance for Intel® Data Center GPU Max Series utilizing oneCCL.
- Enables support for Allreduce, Allgather, Reduce, and Alltoall connectivity for GPUs on the same node
Intel® oneAPI Data Analytics Library 2023.0.0
- There are no new features for oneDAL in the 2023.0 release.
Intel® oneAPI Deep Neural Networks Library 2023.0.0
- Deliver production quality optimizations for Sapphire Rapids, Ponte Vecchio, DG2, and ATS-M with support for S8/S8 weights and activations allowing greater input influence on the outcomes on Intel SPR hardware with AMX, and wider operators - BF32 on Saphire Rapids CPUs and TF32 Pone Vechio GPUs yield more accurate inferencing
- Limited support for FP64 operators on PVC GPUs for high precision model deployment
- Deliver Graph API support to simplify integration to frameworks and extend optimization capabilities
- Intel® C++ Compiler Classic (icc) is deprecated and will be removed in a oneAPI release in the second half of 2023. Intel recommends that customers transition now to using the LLVM-based Intel® oneAPI DPC++/C++ Compiler (icx) for continued Windows* and Linux* support, new language support, new language features, and optimizations. Note that starting with release 2021.7, macOS* support is limited to Mac* computers with Intel® Processors. For more information on icx, see the Intel® oneAPI DPC++/C++ Compiler Developer Guide and Reference.
- Intel FPGA Add-on for OneAPI Base Toolkit has been deprecated. However, Intel continues to support FPGA developmental flow. For more information, refer to the main oneAPI-specific Intel FPGA development flow webpage and Intel® oneAPI Toolkits Installation Guides for Linux and Windows.
Please visit Installation Guide for Intel oneAPI Toolkits
How to Start Using the Tools
- Get Started with the Intel® oneAPI Toolkits for Linux*
- Get Started with the Intel® oneAPI Toolkits for Windows*
Known Issues, Limitations and Workarounds
- Known Issue: Installation of Intel® Distribution of Python will fail if bzip2 is not installed on a Linux machine.Bzip2 is required to extract packages, and a system without this software will result in an installation failure
- Please read the whitepaper on Challenges, tips, and known issues when debugging heterogeneous programs using DPC++ or OpenMP offload
- Running any GPU code on a Virtual Machine is not supported at this time.
- If you have chosen to download the Get Started Guide to use offline, viewing it in Chrome may cause the text to disappear when the browser window is resized. To fix this problem, resize your browser window again, or use a different browser.
- Eclipse* 4.12: the code sample project created by IDE plugin from Makefile will not build. It is a known issue with Eclipse 4.12. Please use Eclipse 4.9, 4.10 or 4.11.
Known issue for FPGA and GPU regarding libtinfo.so.5 library - clang: error while loading shared libraries: libtinfo.so.5: cannot open shared object file: No such file or directory
When compiling for FPGA or GPU, you might see this error. To work around this issue, you must install the required compatibility library by executing one of the following OS-specific commands:
On Ubuntu 20.04: sudo apt install -y libncurses5 libncurses5-dev libncursesw5-dev
On RHEL/CentOS 8: sudo yum install ncurses-compat-libs
On SUSE 15: sudo zypper install libcurses5 ncurses5-devel
Known issue - the installation error on Windows "LoadLibrary failed with error 126: the specified module could not be found" in certain environment only
Impacted environment: Windows with AMD graphics card
Details:When a Windows system has AMD* graphics cards or AMD Radeon Vega* graphics units, the installer of oneAPI Toolkits may report the error "LoadLibrary failed with error 126: the specified module could not be found". This has been reported and is being investigated. Please use the workaround for this release.
Temporarily disable the Intel® HD Graphics during the installation of oneAPI Toolkits with the steps below:
Open the Device Manager > Display Adapters; Right click on the listed display (common is the intel integrated graphics accelerator) and select DISABLE.
- Known issue - "Debug Error!" from Microsoft Visual C++ Runtime Library
- Impacted environment: Windows, "Debug" build only, mixed use of DPC++ & oneAPI libraries (except oneTBB)
- Details: This error may occur only when the DPC++ program is built in "Debug" configuration and it uses one of the oneAPI libraries that do not have a dynamic debug libraries, e.g. oneVPL; The oneTBB is not impacted by this issue.
- The error is similar to the following:
- Use "Release" configuration to build the program for now.
Release Notes for All Tools included in Intel® oneAPI Base Toolkit
- Intel® oneAPI DPC++ Compiler Release Notes
- Intel® DPC++ Compatibility Tool Release Notes
- Intel® oneAPI DPC++ Library Release Notes
- Intel® FPGA Add-On for oneAPI Base Toolkit Release Notes
- Intel® Distribution for GDB* Release Notes
- Intel® oneAPI Math Kernel Library Release Notes
- Intel® oneAPI Threading Building Blocks Library Release Notes
- Intel® Integrated Performance Primitives Release Notes
- Intel® oneAPI Data Analytics Library Release Notes
- Intel® Distribution for Python* Release Notes
- Intel® VTune™ Profiler Release Notes
- Intel® Advisor Release Notes
- Intel® oneAPI Deep Neural Network Library Release Notes
- Intel® oneAPI Collective Communications Library Release Notes
- Intel® oneAPI Video Processing Library Release Notes
Previous oneAPI Releases
Notices and Disclaimers
Intel technologies may require enabled hardware, software or service activation.
No product or component can be absolutely secure.
Your costs and results may vary.
© 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.
No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.
The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.
Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.
Product and Performance Information
Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.