intel oneAPI Threading Building Blocks

Informace o produktu

jeden modul API Threading Building Blocks (jeden TB)

oneAPI Threading Building Blocks (oneTBB) je paralelní programovací model založený na běhu pro kód C++, který používá vlákna. Jedná se o běhovou knihovnu založenou na šablonách navrženou tak, aby pomohla využít skrytý výkon vícejádrových procesorů. oneTBB zjednodušuje paralelní programování rozdělením výpočtu na paralelně běžící úlohy. Paralelnost se provádí v rámci jednoho procesu prostřednictvím vláken, což je mechanismus operačního systému, který umožňuje souběžné provádění stejných nebo různých sad instrukcí.

oneTBB lze stáhnout jako samostatný produkt nebo jako součást Intel(R) oneAPI Base Toolkit. Produkt je dodáván se sadou systémových požadavků, které by měly být splněny před instalací.

Systémové požadavky

• Viz systémové požadavky oneTBB.

Instalace

• Stáhněte si oneTBB jako samostatný produkt nebo jako součást Intel(R) oneAPI Base Toolkit.
• Viz Instalační příručka pro samostatnou verzi (Windows* OS a Linux* OS) a instalační příručku Intel(R) oneAPI Toolkits.

Návod k použití

• • Po instalaci oneTBB nastavte proměnné prostředí přechodem do instalačního adresáře oneTBB. Ve výchozím nastavení je instalační adresář následující:

Pro OS Linux*: /opt/intel/Konami/tab/latest/env/vars.sh

Pro Windows* OS: %ProgramFiles(x86)%InteloneAPItbblatestenvvars.bat

• • Zkompilujte program pomocí oneTBB na Linux* OS a macOS* pomocí nástroje pkg-config. Zadejte úplnou cestu k vyhledání včetně files a knihovny nebo poskytněte jednoduchý řádek, jako je tento:

g++ -o test test.cpp $(pkg-config –libs –záložka flags)

• Pro Windows* OS navíc použijte parametr volby –msvc-syntax, který převede příznaky kompilace a propojení do vhodného režimu.
• Podrobné poznámky, známé problémy a změny najdete v příručce pro vývojáře a v Referenční příručce rozhraní API na GitHubu.

Začněte s jedním API Threading Building Blocks (jeden TB)

• oneAPI Threading Building Blocks (oneTBB) je paralelní programovací model založený na běhu pro kód C++, který používá vlákna. Skládá se z běhové knihovny založené na šablonách, která vám pomůže využít latentní výkon vícejádrových procesorů.
  oneTBB vám umožňuje zjednodušit paralelní programování rozdělením výpočtu na paralelně běžící úlohy.
• V rámci jediného procesu se paralelismus provádí prostřednictvím vláken, což je mechanismus operačního systému, který umožňuje souběžné provádění stejných nebo různých sad instrukcí.
• Zde vidíte jedno z možných provádění úloh podle vláken.

Pomocí jedné karty můžete psát škálovatelné aplikace, které:

• Místo vláken zadejte logickou paralelní strukturu
• Zdůrazněte datově paralelní programování
• Vezměte si náskoktage souběžných kolekcí a paralelních algoritmů
• oneTBB podporuje vnořený paralelismus a vyvažování zátěže. To znamená, že můžete používat knihovnu, aniž byste se museli obávat nadměrného přihlášení k systému. oneTBB je k dispozici jako samostatný produkt a jako součást Intel® oneAPI Base Toolkit.

Systémové požadavky

• Viz systémové požadavky oneTBB.

Stáhnout Intel(R) oneAPI Threading Building Blocks (oneTBB)

• Stáhněte si oneTBB jako samostatný produkt nebo jako součást Intel(R) oneAPI Base Toolkit. Viz Instalační příručka pro samostatnou verzi (Windows* OS a Linux* OS) a instalační příručku Intel(R) oneAPI Toolkits.

Než začnete

Po instalaci oneTBB musíte nastavit proměnné prostředí:

1. Přejděte do instalačního adresáře oneTBB ( ). Ve výchozím stavu, je následující:
   1. V operačním systému Linux*:
   2. Pro superuživatele (root): /opt/intel/Konami
   3. Pro běžné uživatele (neroot): $HOME/intel/Konami
   4. V operačním systému Windows*:
   5. <Program Files>\Intel\oneAPI
2. Nastavte proměnné prostředí pomocí skriptu v , běháním
   • V operačním systému Linux*: vars.{sh|csh} in /tbb/latest/env
   • V operačním systému Windows*: vars.bat in /tbb/latest/env

Example
Níže najdete typického example pro algoritmus oneTBB. Sample vypočítá součet všech celých čísel od 1 do 100.

oneAPI Threading Building Blocks (oneTBB) a nástroj pkg-config

• Nástroj pkg-config se používá ke zjednodušení kompilačního řádku získáváním informací o balíčcích
  speciální metadata files. Pomáhá vyhnout se velkým pevně zakódovaným cestám a činí kompilaci přenosnější.

Zkompilujte program pomocí pkg-config

• Chcete-li sestavit testovací program test.cpp s oneTBB na Linux* OS a macOS*, poskytněte úplnou cestu k hledání include files a knihovny nebo poskytněte jednoduchý řádek, jako je tento:

Kde:

• cflags poskytuje knihovnu oneTBB včetně cesty:
• libs poskytují název knihovny Intel(R) oneTBB a cestu k vyhledání:
• POZNÁMKA Pro Windows* OS navíc použijte parametr volby –msvc-syntax, který převede příznaky kompilace a propojení do vhodného režimu.

Najít další

• jedenTBB Komunitní fórum
• Časté dotazy k produktu
• Žádosti o podporu
• Tyto zdroje použijte, pokud potřebujete podporu s oneTBB.
• Poznámky k vydání Najděte aktuální informace o produktu, včetně podrobných poznámek, známých problémů a změn.
• Dokumentace: Příručka pro vývojáře a reference API
• Naučte se používat oneTBB.
• GitHub* Najděte implementaci oneTBB v open source.

Upozornění a vyloučení odpovědnosti

• Technologie Intel mohou vyžadovat aktivaci aktivovaného hardwaru, softwaru nebo služby.
• Žádný produkt nebo součást nemůže být absolutně zabezpečená.
• Vaše náklady a výsledky se mohou lišit.
• © Intel Corporation. Intel, logo Intel a další značky Intel jsou ochranné známky společnosti Intel Corporation nebo jejích dceřiných společností. Jiná jména a značky mohou být nárokovány jako vlastnictví jiných.
• Tímto dokumentem není udělena žádná licence (výslovná nebo předpokládaná, estoppel nebo jinak) k právům duševního vlastnictví.
• Popisované produkty mohou obsahovat konstrukční vady nebo chyby známé jako errata, které mohou způsobit odchylku produktu od publikovaných specifikací. Aktuální charakterizované chyby jsou k dispozici na vyžádání.
• Společnost Intel se zříká všech výslovných a předpokládaných záruk, včetně, bez omezení, předpokládaných záruk obchodovatelnosti, vhodnosti pro konkrétní účel a neporušení práv, jakož i jakékoli záruky vyplývající z průběhu výkonu, průběhu obchodování nebo použití v obchodě.

Nainstalujte oneTBB na OS Windows*

• Tato část popisuje, jak můžete nasadit knihovnu oneAPI Threading Building Blocks (oneTBB) na počítači s operačním systémem Windows*.
• Pokud plánujete nainstalovat oneTBB jako součást Intel® oneAPI Base Toolkit, přečtěte si odpovídající část instalační příručky Intel(R) oneAPI Toolkits.
• Pokud plánujete nainstalovat oneTBB jako samostatný produkt, postupujte podle pokynů níže pomocí GUI instalačního programu nebo správce balíčků podle vašeho výběru.
• Naučte se, jak nainstalovat oneTBB pomocí GUI a správce balíčků: * Instalace pomocí GUI * Instalace pomocí Správce balíčků

Nainstalujte pomocí GUI

Krok 1. Vyberte preferovaný instalační program

1. Přejděte na stránku Stáhnout. Zobrazí se seznam dostupných instalačních programů.
2. Rozhodněte se pro typ instalačního programu Windows, který budete používat:
   • Online instalátor má menší file velikost, ale při běhu vyžaduje trvalé připojení k internetu.
   • Offline instalátor má větší file velikost, ale vyžaduje připojení k internetu pouze ke stažení instalačního programu filea poté se spustí offline.
3. Poté, co jste se rozhodli pro typ instalátoru, klikněte na odpovídající odkaz pro zahájení stahování.
4. Počkejte na dokončení stahování.

Krok 2. Připravte instalační program

Pro offline instalátory:

1. Spusťte soubor .exe file jste si stáhli. Spustí se extraktor instalačního balíčku.
2. Zadejte cestu, kam se má balíček extrahovat – výchozí je C:\Users\ \Stahování\w_tbb_oneapi_p_ _offline.
3. V případě potřeby vyberte možnost Odebrat dočasně extrahované files po instalaci zaškrtávací políčko.
4. Klikněte na Extrahovat.
   U online instalačního programu se stahování spustí automaticky po spuštění .exe file.

Krok 3. Spusťte nastavení

1. Pokud používáte offline instalační program, pokračujte kliknutím na Pokračovat. Online instalační program bude pokračovat automaticky.
2. V kroku Souhrn zaškrtněte políčko Souhlasím s podmínkami licenční smlouvy.
3. Vyberte režim instalace:

• Chcete-li použít výchozí nastavení instalace, vyberte Doporučená instalace. oneTBB bude nainstalován do výchozího umístění: %Program FIles (x86)%\Intel\oneAPI\. Klikněte na Pokračovat a pokračujte krokem Integrace IDE.
• Chcete-li upravit nastavení instalace, vyberte možnost Vlastní instalace a klepněte na tlačítko Přizpůsobit. Přejdete ke kroku Select Components. Vzhledem k povaze řešení však nelze vybrat žádné jiné komponenty než oneTBB. V tomto režimu můžete změnit výchozí umístění instalace kliknutím na Změnit v levém dolním rohu okna.

1. V kroku Integrate IDE program zkontroluje, zda je možné nasadit oneTBB plně integrovaný s Microsoft Visual Studio IDE – k tomu musí být na cílovém počítači nainstalována podporovaná verze IDE. Pokud není nainstalováno, můžete instalaci ukončit a restartovat po instalaci IDE, nebo pokračovat bez integrace.
2. V kroku Program vylepšení softwaru vyberte požadovanou možnost. Poté kliknutím na Install spusťte instalaci.
3. Počkejte na dokončení procesu. Poté klikněte na Dokončit pro zavření instalačního programu nebo na Přejít na nainstalované produkty a zkontrolujte aktualizace nebo proveďte jiné akce.

POZNÁMKA Nezapomeňte po instalaci nakonfigurovat proměnné prostředí. Další informace o tom naleznete v části Než začnete.

Nainstalujte pomocí Správce balíčků

• Chcete-li nainstalovat oneTBB pomocí správce balíčků, spusťte odpovídající příkaz popsaný v dokumentaci:
• Conda
• Pip
• NuGet
• POZNÁMKA Nezapomeňte po instalaci nakonfigurovat proměnné prostředí. Další informace naleznete v části Než začnete.

Upgrade oneTBB

• Bezproblémový upgrade je podporován pro oneTBB 2021.1 a novější verze. Chcete-li upgradovat oneTBB na nejnovější verzi, spusťte nastavení, jak je popsáno výše.
• Pokud jste dříve pracovali se staršími verzemi (TBB), zvažte, že nové verze oneTBB neposkytují zpětnou kompatibilitu. Viz TBB Revamp: Pozadí, změny a modernizace pro podrobnosti. Viz také
• Migrace z TBB pro další informace o migraci na oneTBB.

Odinstalace oneTBB

• Chcete-li odinstalovat oneTBB, použijte Aplikace a funkce nebo Programy a funkce.

Nainstalujte oneTBB na OS Linux*

• Tato část popisuje, jak můžete nasadit knihovnu oneAPI Threading Building Blocks (oneTBB) na počítači se systémem Linux*. Vyberte preferovaný způsob:
• Nainstalujte oneTBB pomocí příkazového řádku
• Nainstalujte oneTBB pomocí vybraných správců balíčků:
• Conda
• APT
• Mňam
• PIP
• NuGet
• POZNÁMKA Můžete také nainstalovat jeden TB na počítač s operačním systémem Linux* pomocí GUI. Další informace naleznete v instalační příručce Intel(R) oneAPI.

Nainstalujte oneTBB pomocí příkazového řádku

• Chcete-li nainstalovat oneTBB, spusťte jeden z následujících příkazů podle vaší role:
• vykořenit:
• uživatel:

Kde:

• tichý – Spusťte instalační program v neinteraktivním (tichém) režimu.
• eula – Přijmout nebo odmítnout licenční smlouvu s koncovým uživatelem (EULA), podporované hodnoty: přijmout nebo odmítnout (výchozí).
• komponenty – Nechte si vlastní nainstalované komponenty.

Napřampten:

Nainstalujte oneTBB pomocí správce balíčků

• Postupujte podle pokynů pomocí správce balíčků podle vašeho výběru.

Conda

• Tato část poskytuje obecné pokyny k instalaci modulů OneAPI Threading Building Blocks (oneTBB) prostřednictvím rozhraní
• Správce balíčků Conda*. Další poznámky k instalaci naleznete v dokumentaci Conda.
• Chcete-li nainstalovat oneTBB, spusťte následující příkaz:
• Můžete také použít: conda install -c intel/label/intel tbb-devel
• POZNÁMKA Informace o konfiguraci Conda naleznete v Průvodci instalací Intel(R) oneAPI.

APT

• Chcete-li nainstalovat oneTBB pomocí APT*, spusťte:
• Napřampten:

POZNÁMKA Informace o konfiguraci YUM naleznete v Průvodci instalací Intel(R) oneAPI.

Chcete-li nainstalovat oneTBB pomocí PIP*, spusťte:

Napřampten:

NuGet

Chcete-li nainstalovat oneTBB z NuGet* pomocí příkazového řádku, postupujte takto:

1. Přejděte na nuget.org
2. Běh:

POZNÁMKA Informace o konfiguraci NuGet* najdete v Průvodci instalací Intel(R) oneAPI.
POZNÁMKA Nezapomeňte po instalaci nakonfigurovat proměnné prostředí. Další informace o tom naleznete v části Než začnete.

• Bezproblémový upgrade je podporován pro oneTBB 2021.1 a novější verze. Chcete-li upgradovat oneTBB na nejnovější verzi, spusťte nastavení, jak je popsáno výše.
• Pokud jste dříve pracovali se staršími verzemi (TBB), zvažte, že nové verze oneTBB neposkytují zpětnou kompatibilitu. Viz TBB Revamp: Pozadí, změny a modernizace pro podrobnosti. Další informace o migraci na jeden TB naleznete také v části Migrace z TBB.

Dokumenty / zdroje

intel oneAPI Threading Building Blocks [pdfUživatelská příručka OneAPI Threading Building Blocks, Threading Building Blocks, Building Blocks, Blocks

Reference

• Uživatelská příručka