intel oneAPI Math Kernel Library User Guide

intel oneAPI Math Kernel Library

Amata ile Intel® oneAPI Math Kernel Library

O le Intel® oneAPI Math Kernel Library (oneMKL) e fesoasoani ia te oe e ausia le maualuga o le faatinoga i se faletusi faakomepiuta numera o faiga sili ona lelei, faʻatusatusa tutusa mo le PPU ma le GPU. O le faletusi e iai fesoʻotaʻiga C ma Fortran mo le tele o masani ile PPU, ma DPC ++ fesoʻotaʻiga mo nisi masani ile PPU ma le GPU. E mafai ona e mauaina le lagolago atoatoa mo le tele o faʻagaioiga numera i fesoʻotaʻiga eseese e aofia ai:

Mo C ma Fortran i luga ole PPU

• Algebra laina
• Suiga Fast Fourier (FFT)
• Vector numera
• Tu'usa'o ma fa'asolo fa'asolo fo'i
• Fa'afuainumera numera

Mo le DPC++ i luga ole PPU ma le GPU (Va'ai ile Intel® oneAPI Math Kernel Library—Data Parallel C++ Developer Reference mo nisi fa'amatalaga.)

• Algebra laina
  • BLAS
  • Filifilia Sparse BLAS galuega tauave
  • Filifilia galuega faatino LAPACK
• Suiga Fast Fourier (FFT)
  • 1D, 2D, ma le 3D
• Fa'afuainumera numera
  • Galuega filifilia
• Filifilia Vector Math galuega tauave

Ae e te le'i Amata
Asiasi i le itulau Fa'amatalaga Fa'amatalaga mo Fa'amatalaga Fa'ailoa ma fa'amatalaga sili ona lata mai.
Asiasi i le Intel® oneAPI Math Kernel Library System Requirements page mo mana'oga.
Asiasi ile Amata ile Intel® oneAPI DPC++/C++ Compiler mo DPC++ Compiler mana'omia.

Laasaga 1: Faʻapipiʻi le Intel® oneAPI Math Kernel Library
La'u mai le Intel® oneAPI Math Kernel Library mai le Intel® oneAPI Base Toolkit.
Mo fa'asoa Python, fa'asino ile Fa'apipi'iina o le Intel® Distribution mo Python* ma le Intel® Performance Libraries ma pip ma PyPI.
Mo faʻasalalauga Python, ia maitauina le tapulaʻa nei:
O le OneMKL devel package (mkl-devel) mo le tufatufaina atu o le PIP i luga o Linux* ma macOS* e le maua ai ni symlinks o faletusi (mo nisi fa'amatalaga va'ai PIP GitHub lomiga #5919).
I le tulaga o le malosi po'o le tasi faletusi fa'amalosi e feso'ota'i ma le oneMKL devel package (mo nisi fa'amatalaga va'ai le OneMKL Link Line Advisor ) e tatau ona e suia le laina feso'ota'iga ma faletusi oneMKL igoa atoa ma fa'aliliuga.
Va'ai ile Intel® oneAPI Math Kernel Library ma le pkg-config tool mo faʻamatalaga e uiga i le tuʻufaʻatasia ma fesoʻotaʻiga ma le meafaigaluega pkg-config.
tasiMKL feso'ota'iga laina fa'atasiampma le OneAPI Base Toolkit e ala i symlinks:

• Linux:
  icc app.obj -L${MKLROOT}/lib/intel64 -lmkl_intel_lp64-lmkl_intel_thread -lmkl_core -liomp5 -lpthread -lm -ldl
• macOS:
  icc app.obj -L${MKLROOT}/lib -Wl,-rpath,${MKLROOT}/lib-lmkl_intel_lp64 -lmkl_intel_thread -lmkl_core -liomp5 -lpthread
  -lm -ldl
  Ole laina ole so'o ole tasiMKLample ma le PIP devel package e ala i faletusi igoa atoa ma lomiga: Linux:
  icc app.obj ${MKLROOT}/lib/intel64/libmkl_intel_lp64.so.1 ${MKLROOT}/lib/intel64/libmkl_intel_thread.so.1 ${MKLROOT}/lib/intel64/libmkl_core.so.1 -liomp5 -lpthread -lm -ldl
• macOS:
  icc app.obj -Wl,-rpath,${MKLROOT}/lib${MKLROOT}/lib/intel64/libmkl_intel_lp64.1.dylib $ {MKLROOT}/lib/intel64/libmkl_intel_thread.1.dylib
  ${MKLROOT}/lib/intel64/libmkl_core.1.dylib -liomp5 -lpthread -lm-ldl

Laasaga 2: Filifili se Galuega poʻo se masani
Filifili se galuega poʻo se masani mai le tasiMKL e sili ona fetaui mo lou faʻafitauli. Fa'aaoga punaoa nei:

So'otaga Punaoa: Mataupu

OneMKL Developer Guide mo Linux*
OneMKL Developer Guide mo Windows*
OneMKL Developer Guide mo macOS*

O le Developer Guide o loʻo i ai faʻamatalaga auiliili i luga o le tele o autu e aofia ai:

• Tu'ufa'atasi ma feso'ota'iga o talosaga
• Fausia DLL masani
• filo
• Puleaina o Manatu

OneMKL Developer Reference - C
Gagana tasiMKL Developer Reference - Fortran Language
OneMKL Developer Reference - DPC++ Gagana

• Le Fa'asinomaga Fa'atupu (i C, Fortran, ma DPC++ formats) o lo'o iai fa'amatalaga auiliili o galuega ma feso'ota'iga mo vaega uma o faletusi.

Intel® oneAPI Math Kernel Library Fautuaga Su'e Galuega

• Fa'aoga le LAPACK Function Finding Advisor e su'esu'e ai faiga masani a le LAPACK e aoga mo se fa'afitauli fa'apitoa. Mo example, pe afai e te faʻamaonia se gaioiga e pei o:
  • Ituaiga masani: Computational
  • Fa'afitauli fa'akomepiuta: Fa'avasegaina o le Orthogonal
  • Ituaiga matrix: General
  • Fa'agaioiga: Fa'atino QR factorization

Laasaga 3: Feso'ota'i lau Code
Fa'aaoga le OneMKL Link Line Advisor e fa'atulaga ai le so'otaga fa'atonu e tusa ai ma au polokalame.
O nisi tapula'a ma mana'oga faaopoopo:
Intel® oneAPI Math Kernel Library mo DPC++ na'o le lagolagoina o le fa'aogaina o le mkl_intel_ilp64 interface faletusi ma le fa'asologa po'o le TBB threading.

Mo fesoʻotaʻiga DPC ++ ma fesoʻotaʻiga tumau i luga o Linux
icpx -fsycl -fsycl-device-code-split=per_kernel -DMKL_ILP64 ${MKLROOT}/lib/intel64/libmkl_sycl.a -Wl,–amata-vaega ${MKLROOT}/lib/intel64/libmkl_intel_ilp64.a ${MKLROOT}/lib/intel64/
libmkl_ .a ${MKLROOT}/lib/intel64/libmkl_core.a -Wl,–end-group -lsycl -lOpenCL -lpthread -ldl -lm
Mo example, fale/statically feso'ota'i main.cpp ma feso'ota'iga ilp64 ma filo TBB:
icpx -fsycl -fsycl-device-code-split=per_kernel -DMKL_ILP64 -I${MKLROOT}/include main.cpp $
{MKLROOT}/lib/intel64/libmkl_sycl.a -Wl,–amata-vaega ${MKLROOT}/lib/intel64/
libmkl_intel_ilp64.a ${MKLROOT}/lib/intel64/libmkl_tbb_thread.a ${MKLROOT}/lib/intel64/
libmkl_core.a -Wl,–end-group -L${TBBROOT}/lib/intel64/gcc4.8 -ltbb -lsycl -lOpenCL -lpthread -lm -ldl

Mo fesoʻotaʻiga DPC++ ma fesoʻotaʻiga malosi i Linux
icpx -fsycl -DMKL_ILP64 -L$ {MKLROOT}/lib/intel64 -lmkl_sycl -lmkl_intel_ilp64 -lmkl_ -lmkl_core -lsycl -lOpenCL -lpthread -ldl -lm
Mo example, fau/malosi feso'ota'iga main.cpp fa'atasi ai ma feso'ota'iga ilp64 ma filo TBB:
icpx -fsycl -DMKL_ILP64 -I${MKLROOT}/include main.cpp -L${MKLROOT}/lib/intel64 -lmkl_sycl -lmkl_intel_ilp64 -lmkl_tbb_thread -lmkl_core -lsycl -lOpenCL -ltbb -lpthread -ldl

Mo feso'ota'iga DPC++ fa'atasi ai ma feso'ota'iga tumau i luga ole Windows
icpx -fsycl -fsycl-device-code-split=per_kernel -DMKL_ILP64 “%MKLROOT%”\lib\intel64\mkl_sycl.lib
mkl_intel_ilp64.lib mkl_ .lib mkl_core_lib sycl.lib OpenCL.lib
Mo example, fale/statically feso'ota'i main.cpp ma feso'ota'iga ilp64 ma filo TBB:
icpx -fsycl -fsycl-device-code-split=per_kernel -DMKL_ILP64 -I"%MKLROOT%\include" main.cpp"%MKLROOT%"\lib\intel64\mkl_sycl.lib mkl_intel_ilp64.libcore mkl_tbb_thread.lib sy mkcl .lib OpenCL.lib tbb.lib

Mo feso'ota'iga DPC++ ma feso'ota'iga malosi i luga ole Windows
icpx -fsycl -DMKL_ILP64 “%MKLROOT%”\lib\intel64\mkl_sycl_dll.lib mkl_intel_ilp64_dll.lib mkl_ _dll.lib mkl_core_dll.lib tbb.lib sycl.lib OpenCL.lib
Mo example, fau/malosi feso'ota'iga main.cpp fa'atasi ai ma feso'ota'iga ilp64 ma filo TBB:
icpx -fsycl -fsycl-device-code-split=per_kernel -DMKL_ILP64 -I”%MKLROOT%\include” main.cpp “%MKLROOT%”\lib\intel64\mkl_sycl_dll.lib mkl_intel_ilp64_dll.libth mkl_tbb.libth mkl_tbb_libd .lib sycl.lib OpenCL.lib

Mo C/Fortran Interfaces ma OpenMP Offload Support
Fa'aoga le C/Fotran Intel® oneAPI Math Kernel Library feso'ota'iga ma le OpenMP offload feature i le GPU.
Va'ai le C OpenMP Offload Developer Guide mo nisi fa'amatalaga e uiga i lenei vaega.
Faʻaopoopo suiga nei i le C / Fortran oneMKL faʻapipiʻi / laina fesoʻotaʻiga e mafai ai ona faʻaogaina le OpenMP offload i le GPU:

• Fa'aopoopo tu'ufa'atasiga / feso'ota'iga filifiliga: -fiopenmp -fopenmp-targets=spir64 -mllvm -vpo-paropt-use-raw-dev-ptr -fsycl
• Faaopoopo tasiMKL faletusi: tasiMKL DPC++ faletusi

Mo example, fausiaina / fesoʻotaʻi malosi main.cpp i luga o Linux ma fesoʻotaʻiga ilp64 ma OpenMP threading:
icx -fiopenmp -fopenmp-targets=spir64 -mllvm -vpo-paropt-use-raw-dev-ptr -fsycl -DMKL_ILP64 -m64 -I$(MKLROOT)/include main.cpp L${MKLROOT}/lib/intel64 - lmkl_sycl -lmkl_intel_ilp64 -lmkl_intel_thread -lmkl_core -liomp5 -lsycl -lOpenCL -lstdc++ -lpthread -lm -ldl
Mo isi fa'atonuga lagolago uma, va'ai Intel® oneAPI Math Kernel Library Link Line Advisor.

Su'e Sili

Punaoa: Fa'amatalaga

A'oa'oga: Fa'aaogā le Intel® oneAPI Math Kernel Library mo le Fa'ateleina o Matrix:

• Aoaoga – C Gagana
• Aoaoga – Fortran Language

O lenei aʻoaʻoga o loʻo faʻaalia ai pe faʻapefea ona e faʻaogaina le tasiMKL e faʻateleina matrices, fuaina le faʻatinoga o le faʻateleina o matrix, ma pulea filo.

Intel® oneAPI Math Kernel Library (oneMKL) Fa'asalalau Fa'amatalaga e pulea filo.
O faʻamatalaga faʻasalalauga o loʻo i ai faʻamatalaga faʻapitoa i le faʻasalalauga lata mai o le oneMKL e aofia ai foliga fou ma suiga. O fa'amatalaga fa'asalalauga e aofia ai feso'ota'iga i puna'oa fa'amatalaga autu i luga ole laiga e feso'ota'i ma le fa'asalalauga. E mafai foi ona e mauaina faʻamatalaga ile:

• O le a le mea fou i le faʻasalalauga
• O mea o lo'o i totonu
• Mauaina lagolago fa'apitoa
• Fa'amatalaga laisene

Intel® oneAPI Math Kernel Library
Le Intel® oneAPI Math Kernel Library (oneMKL) itulau oloa. Va'ai le itulau lenei mo le lagolago ma fa'amaumauga i luga ole laiga.

Intel® oneAPI Math Kernel Library Cookbook
O le Intel® oneAPI Math Kernel Library o loʻo i ai le tele o faiga masani e fesoasoani ia te oe e foia ai faʻafitauli numera eseese, e pei o le faʻateleina o matrices, foʻia se faiga o faʻatusatusaga, ma le faia o se suiga Fourier.

Fa'amatalaga mo le Intel® oneAPI Math Kernel Library Vector Statistics
O lenei pepa o lo'o aofia ai le fa'asiliview, o se faʻataʻitaʻiga faʻaoga ma faʻataʻitaʻiga faʻataʻitaʻiga o numera faʻafuaseʻi generators aofia i le VS.

Intel® oneAPI Math Kernel Library Vector Statistics Fa'amatalaga Fa'atino Fa'asologa o Fa'asologa o Numera Fa'afuainumera
Fa'amaumauga o fa'atinoga e maua mai i le fa'aogaina o fuainumera fa'afuainumera (VS) fa'atupu numera fa'afuase'i (RNG) e aofia ai le CPE (uati i le elemene) iunite o fua, fa'avae fa'atupu numera fa'atosina (BRNG), fa'atupuina fa'asoa fa'asoa, ma le umi o ve'a fa'atupu.

Intel® oneAPI Math Kernel Library Vector Mathematics Performance and Accuracy Data
Vector Mathematics (VM) e fa'atatau galuega fa'avae ile fa'aupuga vector. VM e aofia ai se seti o faʻatinoga sili ona lelei o galuega faʻa-matematika taugata faʻatusatusa (malosi, trigonometric, exponential, hyperbolic, ma isi) o loʻo faʻaogaina i luga o vete.

Fa'amatalaga Talosaga mo le Intel® oneAPI Math Kernel Library Summary Statistics
Aotelega Fuainumera Faamauina ose vaega itiiti o le Vector Statistics domain ole Intel® oneAPI Math Kernel Library. Aotelega Fa'amaumauga e tu'uina atu ia te oe galuega mo su'esu'ega fa'afuainumera muamua, ma ofo atu fofo mo le fa'agasologa tutusa o fa'amaumauga e tele-dimensional.

LAPACK Examples
O lenei pepa e maua ai le code examples mo le tasiMKL LAPACK (Linear Algebra PACKage) masani.

Fa'asilasilaga ma Fa'asalaga
Polokalama ma galuega mamafa na fa'aaogaina i su'ega fa'atinoga atonu na fa'asilisiliina mo fa'atinoga i luga ole Intel microprocessors. O su'ega fa'atinoga, e pei ole SYSmark ma MobileMark, e fuaina ile fa'aogaina o faiga fa'akomepiuta fa'apitoa, vaega, polokalame, fa'agaioiga ma galuega. So'o se suiga i so'o se tasi o na mea e ono mafua ai ona fesuisuia'i i'uga. E tatau ona e fa'afeso'ota'i isi fa'amatalaga ma su'ega fa'atinoga e fesoasoani ia te oe i le iloiloina atoatoa o au fa'atauga fa'atatau, e aofia ai le fa'atinoga o lena oloa pe a tu'ufa'atasia ma isi oloa. Mo nisi fa'amatalaga atoatoa asiasi www.intel.com/benchmarks.
Atonu e manaʻomia le atamai o tekinolosi Intel e faʻaaogaina masini, polokalama poʻo le tautua faʻagaioia.
E leai se oloa po'o se vaega e mafai ona matua malupuipuia.
E ono fesuisuiai au tau ma taunuuga.
© Intel Corporation. Intel, le Intel logo, ma isi fa'ailoga Intel o fa'ailoga fa'ailoga a le Intel Corporation po'o ona lala. O isi igoa ma fa'ailoga e mafai ona ta'ua o se meatotino a isi.

Oloa ma Fa'amatalaga Fa'atinoga
Fa'atinoga e eseese ile fa'aoga, fa'atulagaina ma isi mea. A'oa'o atili ile www.Intel.com/PerformanceIndex.
Fa'aaliga toe teuteu #20201201
Leai se laisene (fa'aalia pe fa'aali, e le estoppel po'o se isi mea) i so'o se aia tatau tau le atamai ua fa'atagaina e lenei pepa.
O oloa o loʻo faʻamatalaina e ono iai ni faʻaletonu mamanu poʻo ni mea sese e taʻua o le errata e ono mafua ai ona alu ese le oloa mai faʻamatalaga faʻasalalau. O mea sese o lo'o iai nei o lo'o avanoa i luga ole talosaga.
E fa'afitia uma e Intel fa'apolopolo fa'amaonia, e aofia ai e aunoa ma se fa'atapula'aina, fa'amaonia fa'amaonia o le fa'atau, talafeagai mo se fa'amoemoe fa'apitoa, ma le le solia, fa'apea fo'i ma so'o se saisai e tula'i mai i le fa'atinoga, faiga tau fefa'ataua'iga, po'o le fa'aogaina i fefa'ataua'iga.