intel 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*: %ProgramFiles(x86)%InteloneAPItbblatestenvvars.bat

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

g++ -o test test.cpp $(pkg-config –libs –вкладка прапорців)

• Для ОС 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.

Перш ніж почати

Після встановлення 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/latest/env
   • В ОС Windows*: vars.bat в /tbb/latest/env

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, який перетворює прапорці компіляції та зв’язування у відповідний режим.

Знайти більше

• oneTBB Форум спільноти
• Поширені запитання про продукт
• Запити на підтримку
• Скористайтеся цими ресурсами, якщо вам потрібна підтримка oneTBB.
• Примітки до випуску Знаходьте актуальну інформацію про продукт, зокрема докладні примітки, відомі проблеми та зміни.
• Документація: Посібник розробника та довідник API
• Навчіться використовувати oneTBB.
• GitHub* Знайдіть реалізацію oneTBB у відкритому коді.

Повідомлення та застереження

• Технології Intel можуть вимагати активації апаратного, програмного забезпечення або послуги.
• Жоден продукт чи компонент не може бути абсолютно безпечним.
• Ваші витрати та результати можуть відрізнятися.
• © Корпорація Intel. Intel, логотип Intel та інші знаки Intel є товарними знаками корпорації Intel або її дочірніх компаній. Інші назви та бренди можуть бути визнані власністю інших.
• Цей документ не надає жодної ліцензії (явної чи неявної, судової або іншої) на будь-які права інтелектуальної власності.
• Описані продукти можуть містити конструктивні дефекти або помилки, відомі як помилки, які можуть спричинити відхилення продукту від опублікованих специфікацій. Поточні характерні помилки доступні за запитом.
• Intel відмовляється від усіх явних і непрямих гарантій, включаючи, без обмежень, непрямі гарантії придатності для продажу, придатності для певної мети та непорушення прав, а також будь-які гарантії, що випливають із ходу роботи, порядку ведення справ або використання в торгівлі.

Встановіть oneTBB в ОС Windows*

• У цьому розділі описано, як можна розгорнути бібліотеку OneAPI Threading Building Blocks (oneTBB) на машині з ОС Windows*.
• Якщо ви плануєте інсталювати oneTBB як частину базового набору інструментів Intel® oneAPI, зверніться до відповідного розділу посібника з інсталяції наборів інструментів Intel(R) oneAPI.
• Якщо ви плануєте інсталювати oneTBB як окремий продукт, виконайте наведені нижче інструкції, використовуючи графічний інтерфейс інсталятора або менеджер пакунків на ваш вибір.
• Дізнайтесь, як інсталювати oneTBB за допомогою графічного інтерфейсу користувача та менеджера пакунків: * Встановити за допомогою графічного інтерфейсу користувача * Встановити за допомогою менеджера пакетів

Встановити за допомогою графічного інтерфейсу

Крок 1. Виберіть потрібний інсталятор

1. Перейдіть на сторінку завантаження. Відобразиться список доступних інсталяторів.
2. Виберіть тип інсталятора Windows, який ви будете використовувати:
   • Онлайн інсталятор має менший розмір file але під час роботи потрібне постійне підключення до Інтернету.
   • Офлайн інсталятор має більший розмір file розмір, але підключення до Інтернету потрібне лише для завантаження інсталятора file, а потім працює в автономному режимі.
3. Визначившись з типом інсталятора, натисніть відповідне посилання, щоб почати завантаження.
4. Дочекайтеся завершення завантаження.

Крок 2. Підготуйте інсталятор

Для офлайн-інсталяторів:

1. Запустіть файл .exe file ви завантажили. Буде запущено екстрактор інсталяційних пакетів.
2. Укажіть шлях, куди потрібно розпакувати пакет – за замовчуванням C:\Users\ \Завантаження\w_tbb_oneapi_p_ _офлайн.
3. Якщо необхідно, виберіть Видалити тимчасово витягнуті files після встановлення.
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 за допомогою менеджерів пакунків на вибір:
• Конда
• APT
• смак
• PIP
• NuGet
• ПРИМІТКА Ви також можете встановити один ТБ на машину з ОС Linux* за допомогою графічного інтерфейсу користувача. Щоб дізнатися більше, перегляньте посібник із встановлення Intel(R) oneAPI.

Встановіть oneTBB за допомогою командного рядка

• Щоб установити oneTBB, виконайте одну з наступних команд відповідно до вашої ролі:
• корінь:
• користувач:

Де:

• мовчазний – Запустіть програму встановлення в неінтерактивному (тихому) режимі.
• Еула – Прийняти або відхилити Ліцензійну угоду кінцевого користувача (EULA), підтримувані значення: прийняти або відхилити (за замовчуванням).
• компоненти – Дозволяє встановлювати компоненти на замовлення.

наприкладampле:

Встановіть oneTBB за допомогою менеджерів пакетів

• Дотримуйтесь інструкцій, використовуючи обраний вами менеджер пакетів.

Конда

• У цьому розділі наведено загальні інструкції щодо встановлення потокових будівельних блоків oneAPI (oneTBB) через
• Менеджер пакетів Conda*. Щоб отримати додаткові примітки щодо встановлення, зверніться до документації Conda.
• Щоб інсталювати oneTBB, виконайте таку команду:
• Ви також можете використовувати: conda install -c intel/label/intel tbb-devel
• ПРИМІТКА Перегляньте посібник із встановлення Intel(R) oneAPI, щоб дізнатися, як налаштувати Conda.

APT

• Щоб установити 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 для отримання додаткової інформації про міграцію до одного ТБ.

Документи / Ресурси

intel oneAPI Threading Building Blocks [pdfПосібник користувача oneAPI Потокові будівельні блоки, Потокові будівельні блоки, Будівельні блоки, Блоки

Список літератури

• Посібник користувача