Інтэл OneAPI Threading Building Blocks

Інфармацыя аб прадукце

адзін API Threading Building Blocks (адзін ТБ)

OneAPI Threading Building Blocks (oneTBB) - гэта мадэль паралельнага праграмавання на аснове часу выканання для кода C++, які выкарыстоўвае патокі. Гэта бібліятэка часу выканання на аснове шаблонаў, прызначаная для выкарыстання схаванай прадукцыйнасці шмат'ядравых працэсараў. oneTBB спрашчае паралельнае праграмаванне, разбіваючы вылічэнні на паралельныя задачы. Паралелізм ажыццяўляецца ў рамках аднаго працэсу праз патокі, механізм аперацыйнай сістэмы, які дазваляе адначасова выконваць аднолькавыя або розныя наборы інструкцый.

oneTBB можна загрузіць як асобны прадукт або як частку Intel(R) oneAPI Base Toolkit. Прадукт пастаўляецца з наборам сістэмных патрабаванняў, якія павінны быць выкананы перад устаноўкай.

Сістэмныя патрабаванні

• Звярніцеся да сістэмных патрабаванняў oneTBB.

Ўстаноўка

• Спампуйце oneTBB як асобны прадукт або як частку Intel(R) oneAPI Base Toolkit.
• Звярніцеся да Кіраўніцтва па ўстаноўцы для аўтаномнай версіі (АС Windows* і Linux*) і Кіраўніцтва па ўстаноўцы набораў інструментаў Intel(R) oneAPI.

Інструкцыя па выкарыстанні

• • Пасля ўстаноўкі oneTBB задайце зменныя асяроддзя, перайшоўшы ў каталог усталёўкі oneTBB. Па змаўчанні каталог ўстаноўкі выглядае наступным чынам:

Для АС Linux*: /opt/intel/Konami/tab/latest/env/vars.sh

Для АС Windows*: %ПраграмаFiles(x86)%InteloneAPItbblatestenvvars.bat

• • Скампілюйце праграму з дапамогай oneTBB на АС Linux* і macOS* з дапамогай інструмента pkg-config. Увядзіце поўны шлях для пошуку ў тым ліку files і бібліятэкі, або даць просты радок, як гэта:

g++ -o тэст test.cpp $(pkg-config –libs –укладка flags)

• Для АС Windows* дадаткова выкарыстоўвайце параметр –msvc-syntax, які пераўтворыць сцягі кампіляцыі і спасылкавання ў адпаведны рэжым.
• Падрабязныя нататкі, вядомыя праблемы і змены глядзіце ў Кіраўніцтве распрацоўшчыка і Даведніку па API на GitHub.

Пачніце з аднаго API Threading Building Blocks (адзін ТБ)

• OneAPI Threading Building Blocks (oneTBB) - гэта мадэль паралельнага праграмавання на аснове часу выканання для кода C++, які выкарыстоўвае патокі. Ён складаецца з бібліятэкі выканання на аснове шаблонаў, каб дапамагчы вам выкарыстоўваць утоеную прадукцыйнасць шмат'ядравых працэсараў.
  oneTBB дазваляе спрасціць паралельнае праграмаванне, падзяліўшы вылічэнні на паралельныя задачы.
• У рамках аднаго працэсу паралелізм ажыццяўляецца праз патокі, механізм аперацыйнай сістэмы, які дазваляе адначасова выконваць аднолькавыя або розныя наборы інструкцый.
• Тут вы можаце ўбачыць адзін з магчымых варыянтаў выканання задач па патоках.

Выкарыстоўвайце адну ўкладку для напісання маштабаваных прыкладанняў, якія:

• Укажыце лагічную паралельную структуру замест патокаў
• Зрабіце акцэнт на паралельным праграмаванні з дадзенымі
• Вазьміце авансtage адначасовых калекцый і паралельных алгарытмаў
• oneTBB падтрымлівае ўкладзены паралелізм і балансаванне нагрузкі. Гэта азначае, што вы можаце карыстацца бібліятэкай, не турбуючыся аб перавышэнні падпіскі на сістэму. oneTBB даступны як асобны прадукт і як частка Intel® oneAPI Base Toolkit.

Сістэмныя патрабаванні

• Звярніцеся да сістэмных патрабаванняў oneTBB.

Спампаваць Intel(R) oneAPI Threading Building Blocks (oneTBB)

• Спампуйце oneTBB як асобны прадукт або як частку Intel(R) oneAPI Base Toolkit. Глядзіце Кіраўніцтва па ўсталёўцы для аўтаномнай версіі (АС Windows* і Linux*) і Кіраўніцтва па ўсталёўцы Intel(R) oneAPI Toolkits.

Перш чым пачаць

Пасля ўстаноўкі oneTBB вам трэба ўсталяваць зменныя асяроддзя:

1. Перайдзіце ў каталог ўстаноўкі oneTBB ( ). Па змаўчанні, гэта наступнае:
   1. У АС Linux*:
   2. Для суперкарыстальнікаў (root): /opt/intel/Konami
   3. Для звычайных карыстальнікаў (не-root): $HOME/intel/Konami
   4. У АС Windows*:
   5. <Program Files>\Intel\oneAPI
2. Усталюйце зменныя асяроддзя, выкарыстоўваючы сцэнар у , бегам
   • У АС Linux*: варс.{sh|csh} у /tbb/апошнія/кан
   • У АС Windows*: vars.bat ст /tbb/апошнія/кан

Example
Ніжэй вы можаце знайсці тыповага былогаample для алгарытму oneTBB. Сample вылічвае суму ўсіх цэлых лікаў ад 1 да 100.

OneAPI Threading Building Blocks (oneTBB) і інструмент pkg-config

• Інструмент pkg-config выкарыстоўваецца для спрашчэння лініі кампіляцыі шляхам атрымання інфармацыі аб пакетах з
  спецыяльныя метададзеныя fileс. Гэта дапамагае пазбегнуць вялікіх жорстка закадзіраваных шляхоў і робіць кампіляцыю больш партатыўнай.

Скампілюйце праграму з дапамогай pkg-config

• Каб скампіляваць тэставую праграму test.cpp з oneTBB на АС Linux* і macOS*, укажыце поўны шлях для пошуку ўключэння files і бібліятэкі, або даць просты радок, як гэта:

Дзе:

• cflags забяспечвае адну бібліятэку TBB, уключаючы шлях:
• libs забяспечвае назву бібліятэкі Intel(R) oneTBB і шлях пошуку, каб знайсці яе:
• УВАГА Для АС Windows* дадаткова выкарыстоўвайце параметр –msvc-syntax, які пераўтворыць сцягі кампіляцыі і спасылкавання ў адпаведны рэжым.

Знайсці больш

• адзінTBB Форум супольнасці
• Частыя пытанні аб прадукце
• Запыты падтрымкі
• Скарыстайцеся гэтымі рэсурсамі, калі вам патрэбна падтрымка oneTBB.
• Заўвагі да выпуску Знайдзіце актуальную інфармацыю аб прадукце, уключаючы падрабязныя заўвагі, вядомыя праблемы і змены.
• Дакументацыя: Кіраўніцтва распрацоўшчыка і даведнік па API
• Навучыцеся карыстацца oneTBB.
• GitHub* Знайдзіце рэалізацыю oneTBB у адкрытым зыходным коды.

Заўвагі і адмова ад адказнасці

• Тэхналогіі Intel могуць запатрабаваць актываванага абсталявання, праграмнага забеспячэння або актывацыі службы.
• Ні адзін прадукт ці кампанент не можа быць абсалютна бяспечным.
• Вашы выдаткі і вынікі могуць адрознівацца.
• © Карпарацыя Intel. Intel, лагатып Intel і іншыя знакі Intel з'яўляюцца гандлёвымі маркамі карпарацыі Intel або яе даччыных кампаній. Іншыя назвы і брэнды могуць быць заяўлены як уласнасць іншых.
• Гэты дакумент не дае ніякіх ліцэнзій (яўных або пэўных, па законе або іншым чынам) на правы інтэлектуальнай уласнасці.
• Апісаныя прадукты могуць утрымліваць канструктыўныя дэфекты або памылкі, вядомыя як памылкі, якія могуць выклікаць адхіленне прадукту ад апублікаваных спецыфікацый. Бягучыя характарыстыкі памылак даступныя па запыце.
• Intel адмаўляецца ад усіх відавочных і пэўных гарантый, у тым ліку, без абмежавання, пэўных гарантый таварнасці, прыдатнасці для пэўнай мэты і адсутнасці парушэнняў, а таксама любых гарантый, якія вынікаюць з ходу працы, ходу здзелак або выкарыстання ў гандлі.

Усталюйце oneTBB на АС Windows*

• У гэтым раздзеле апісваецца, як вы можаце разгарнуць бібліятэку oneAPI Threading Building Blocks (oneTBB) на машыне з АС Windows*.
• Калі вы плануеце ўсталяваць oneTBB як частку Intel® oneAPI Base Toolkit, звярніцеся да адпаведнага раздзела Кіраўніцтва па ўсталёўцы Intel(R) oneAPI Toolkits.
• Калі вы плануеце ўсталяваць oneTBB як асобны прадукт, выконвайце інструкцыі ніжэй, выкарыстоўваючы графічны інтэрфейс праграмы ўстаноўкі або менеджэр пакетаў па вашаму выбару.
• Даведайцеся, як усталяваць oneTBB з графічным інтэрфейсам і менеджэрам пакетаў: * Усталяваць з графічным інтэрфейсам * Усталяваць з дапамогай дыспетчара пакетаў

Усталяваць з графічным інтэрфейсам

Крок 1. Выберыце пераважны ўсталёўшчык

1. Перайдзіце на старонку загрузкі. Адлюструецца спіс даступных праграм усталёўкі.
2. Вызначыцеся з тыпам праграмы ўстаноўкі Windows, якую вы будзеце выкарыстоўваць:
   • Інтэрнэт-ўсталёўшчык мае меншы памер file памеру, але падчас працы патрабуецца пастаяннае падключэнне да Інтэрнэту.
   • Пазасеткавы ўсталёўшчык мае большы памер file памеру, але падключэнне да Інтэрнэту патрабуецца толькі для загрузкі праграмы ўстаноўкі file, а потым працуе ў аўтаномным рэжыме.
3. Вызначыўшыся з тыпам ўсталёўшчыка, націсніце на адпаведную спасылку, каб пачаць загрузку.
4. Дачакайцеся завяршэння загрузкі.

Крок 2. Падрыхтуйце праграму ўстаноўкі

Для афлайн-усталёўшчыкаў:

1. Запусціце .exe file вы спампавалі. Будзе запушчаны экстрактар ​​установачнага пакета.
2. Укажыце шлях, куды трэба распакаваць пакет - па змаўчанні C:\Users\ \Спампоўкі\w_tbb_oneapi_p_ _у аўтаномным рэжыме.
3. Пры неабходнасці абярыце пункт Выдаліць часова вынятыя fileсцяжок пасля ўстаноўкі.
4. Націсніце Выняць.
   Для інтэрнэт-ўсталёўшчыка загрузка пачынаецца аўтаматычна пасля запуску .exe file.

Крок 3. Запусціце ўстаноўку

1. Калі вы працуеце ў аўтаномным рэжыме ўстаноўкі, націсніце "Працягнуць", каб працягнуць. Анлайн-ўсталёўшчык запусціцца аўтаматычна.
2. На этапе "Зводка" пастаўце сцяжок "Я прымаю ўмовы ліцэнзійнага пагаднення".
3. Выберыце рэжым ўстаноўкі:

• Каб выкарыстоўваць налады ўстаноўкі па змаўчанні, выберыце «Рэкамендаваная ўстаноўка». oneTBB будзе ўсталяваны ў размяшчэнне па змаўчанні: %Program FIles (x86)%\Intel\oneAPI\. Націсніце "Працягнуць" і перайдзіце да кроку "Інтэграваць IDE".
• Каб змяніць налады ўстаноўкі, выберыце «Карыстальніцкая ўстаноўка» і націсніце «Наладзіць». Вы пяройдзеце да кроку выбару кампанентаў. Аднак нельга выбраць іншыя кампаненты, акрамя oneTBB, з-за прыроды рашэння. У гэтым рэжыме вы можаце змяніць месца ўстаноўкі па змаўчанні, націснуўшы «Змяніць» у левым ніжнім куце акна.

1. На этапе інтэграцыі IDE праграма правярае, ці магчыма разгарнуць oneTBB, цалкам інтэграваны з Microsoft Visual Studio IDE – для гэтага на мэтавай машыне павінна быць усталявана падтрымліваемая версія IDE. Калі не ўстаноўлена, вы можаце выйсці з наладкі і перазапусціць яго пасля ўстаноўкі IDE або працягнуць без інтэграцыі.
2. На этапе праграмы ўдасканалення праграмнага забеспячэння выберыце варыянт, які вам больш падабаецца. Затым націсніце «Усталяваць», каб пачаць усталёўку.
3. Дачакайцеся завяршэння працэсу. Затым націсніце «Гатова», каб закрыць праграму ўстаноўкі, або «Перайсці да ўсталяваных прадуктаў», каб праверыць наяўнасць абнаўленняў або выканаць іншыя дзеянні.

УВАГА Не забудзьце наладзіць зменныя асяроддзя пасля ўстаноўкі. Глядзіце раздзел "Перш чым пачаць", каб даведацца пра гэта.

Усталяваць з дапамогай дыспетчара пакетаў

• Каб усталяваць oneTBB з мэнэджарам пакетаў, выканайце адпаведную каманду, апісаную ў дакументацыі:
• Конда
• Піп
• NuGet
• УВАГА Не забудзьце наладзіць зменныя асяроддзя пасля ўстаноўкі. Глядзіце раздзел "Перш чым пачаць", каб даведацца пра гэта.

Абнаўленне oneTBB

• Плаўнае абнаўленне падтрымліваецца для oneTBB 2021.1 і пазнейшых версій. Каб абнавіць oneTBB да апошняй версіі, запусціце ўстаноўку, як апісана вышэй.
• Калі вы раней працавалі са старымі версіямі (TBB), улічыце, што новыя версіі oneTBB не забяспечваюць зваротнай сумяшчальнасці. Глядзіце TBB Revamp: Даведка, змены і мадэрнізацыя для дэталяў. Акрамя таго, звярніцеся да
• Пераход з TBB для атрымання дадатковай інфармацыі аб пераходзе на oneTBB.

Выдаленне oneTBB

• Каб выдаліць oneTBB, выкарыстоўвайце Прыкладанні і функцыі або Праграмы і функцыі.

Усталюйце oneTBB на АС Linux*

• У гэтым раздзеле апісваецца, як вы можаце разгарнуць бібліятэку oneAPI Threading Building Blocks (oneTBB) на машыне Linux*. Выберыце пераважны спосаб:
• Усталюйце oneTBB з дапамогай каманднага радка
• Усталюйце oneTBB з дапамогай выбраных менеджэраў пакетаў:
• Конда
• КВ
• Смачна
• PIP
• NuGet
• УВАГА Вы таксама можаце ўсталяваць адзін ТБ на машыну з АС Linux* з дапамогай графічнага інтэрфейсу. Глядзіце Кіраўніцтва па ўстаноўцы Intel(R) oneAPI, каб даведацца больш.

Усталюйце oneTBB з дапамогай каманднага радка

• Каб усталяваць oneTBB, выканайце адну з наступных каманд у адпаведнасці з вашай роляй:
• корань:
• карыстальнік:

Дзе:

• маўклівы – Запусціце праграму ўстаноўкі ў неінтэрактыўным (ціхім) рэжыме.
• Эула - Прыняць або адхіліць Ліцэнзійнае пагадненне канчатковага карыстальніка (EULA), падтрымоўваныя значэнні: прыняць або адхіліць (па змаўчанні).
• кампаненты - Дазвольце ўсталёўваць кампаненты на заказ.

Напрыкладampль:

Усталюйце oneTBB з дапамогай дыспетчараў пакетаў

• Выконвайце інструкцыі, выкарыстоўваючы менеджэр пакетаў па вашаму выбару.

Конда

• У гэтым раздзеле прыводзяцца агульныя інструкцыі па ўсталёўцы блокаў oneAPI Threading Building Blocks (oneTBB) праз
• Менеджэр пакетаў Conda*. Для атрымання дадатковых заўваг па ўсталяванні звярніцеся да дакументацыі Conda.
• Каб усталяваць oneTBB, выканайце наступную каманду:
• Вы таксама можаце выкарыстоўваць: conda install -c intel/label/intel tbb-devel
• УВАГА Глядзіце Кіраўніцтва па ўстаноўцы Intel(R) oneAPI, каб даведацца, як наладзіць Conda.

КВ

• Каб усталяваць oneTBB з дапамогай APT*, запусціце:
• Напрыкладampль:

УВАГА Глядзіце Кіраўніцтва па ўстаноўцы Intel(R) oneAPI, каб даведацца, як наладзіць YUM.

Каб усталяваць oneTBB з дапамогай PIP*, запусціце:

Напрыкладampль:

NuGet

Каб усталяваць oneTBB з NuGet* з дапамогай каманднага радка, зрабіце наступнае:

1. Перайдзіце на nuget.org
2. запусціць:

УВАГА Глядзіце Кіраўніцтва па ўстаноўцы Intel(R) oneAPI, каб даведацца, як наладзіць NuGet*.
УВАГА Не забудзьце наладзіць зменныя асяроддзя пасля ўстаноўкі. Глядзіце раздзел "Перш чым пачаць", каб даведацца пра гэта.

• Плаўнае абнаўленне падтрымліваецца для oneTBB 2021.1 і пазнейшых версій. Каб абнавіць oneTBB да апошняй версіі, запусціце ўстаноўку, як апісана вышэй.
• Калі вы раней працавалі са старымі версіямі (TBB), улічыце, што новыя версіі oneTBB не забяспечваюць зваротнай сумяшчальнасці. Глядзіце TBB Revamp: Даведка, змены і мадэрнізацыя для дэталяў. Таксама звярніцеся да Пераход з TBB для атрымання дадатковай інфармацыі аб пераходзе на адзін ТБ.

Дакументы / Рэсурсы

Інтэл OneAPI Threading Building Blocks [pdfКіраўніцтва карыстальніка oneAPI Threading Building Blocks, Threading Building Blocks, Building Blocks, Blocks

Спасылкі

• Кіраўніцтва карыстальніка