Intel oneAPI Threading Building Blocks

Informació del producte

un API Threading Building Blocks (una TB)

OneAPI Threading Building Blocks (oneTBB) és un model de programació paral·lel basat en temps d'execució per al codi C++ que utilitza fils. És una biblioteca de temps d'execució basada en plantilles dissenyada per ajudar a aprofitar el rendiment latent dels processadors multinucli. oneTBB simplifica la programació paral·lela dividint el càlcul en tasques d'execució paral·lela. El paral·lelisme es realitza dins d'un únic procés mitjançant fils, un mecanisme del sistema operatiu que permet executar simultàniament el mateix o diferents conjunts d'instruccions.

oneTBB es pot descarregar com a producte autònom o com a part de l'Intel(R) oneAPI Base Toolkit. El producte inclou un conjunt de requisits del sistema que s'han de complir abans de la instal·lació.

Requisits del sistema

• Consulteu els requisits del sistema oneTBB.

Instal·lació

• Baixeu oneTBB com a producte autònom o com a part de l'Intel(R) oneAPI Base Toolkit.
• Consulteu la Guia d'instal·lació per obtenir una versió autònoma (SO Windows* i Linux* OS) i la Guia d'instal·lació del kit d'eines oneAPI d'Intel(R).

Instruccions d'ús

• • Després d'instal·lar oneTBB, configureu les variables d'entorn anant al directori d'instal·lació de oneTBB. Per defecte, el directori d'instal·lació és el següent:

Per al sistema operatiu Linux*: /opt/intel/Konami/tab/latest/env/vars.sh

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

• • Compileu un programa amb oneTBB al sistema operatiu Linux* i macOS* mitjançant l'eina pkg-config. Proporcioneu el camí complet per cercar inclòs files i biblioteques, o proporcioneu una línia senzilla com aquesta:

g++ -o test test.cpp $(pkg-config –libs –pestanya flags)

• Per al sistema operatiu Windows*, utilitzeu a més el senyalador d'opció –msvc-syntax que converteix els indicadors de compilació i enllaç en un mode adequat.
• Consulteu la Guia per a desenvolupadors i la referència de l'API a GitHub per obtenir notes detallades, problemes coneguts i canvis.

Comenceu amb un API Threading Building Blocks (una TB)

• OneAPI Threading Building Blocks (oneTBB) és un model de programació paral·lel basat en temps d'execució per al codi C++ que utilitza fils. Consisteix en una biblioteca de temps d'execució basada en plantilles per ajudar-vos a aprofitar el rendiment latent dels processadors multinucli.
  oneTBB us permet simplificar la programació paral·lela dividint el càlcul en tasques d'execució paral·lela.
• Dins d'un únic procés, el paral·lelisme es realitza mitjançant fils, un mecanisme del sistema operatiu que permet executar simultàniament el mateix o diferents conjunts d'instruccions.
• Aquí podeu veure una de les possibles execucions de tasques per fils.

Utilitzeu una pestanya per escriure aplicacions escalables que:

• Especifiqueu una estructura paral·lela lògica en lloc de fils
• Poseu èmfasi en la programació en paral·lel de dades
• Avançanttage de col·leccions concurrents i algorismes paral·lels
• oneTBB admet el paral·lelisme imbricat i l'equilibri de càrrega. Vol dir que podeu utilitzar la biblioteca sense preocupar-vos de subscriure excessivament un sistema. oneTBB està disponible com a producte autònom i com a part de l'Intel® oneAPI Base Toolkit.

Requisits del sistema

• Consulteu els requisits del sistema oneTBB.

Baixeu Intel(R) oneAPI Threading Building Blocks (oneTBB)

• Baixeu oneTBB com a producte autònom o com a part de l'Intel(R) oneAPI Base Toolkit. Vegeu la Guia d'instal·lació per obtenir una versió autònoma (SO Windows* i Linux* OS) i la Guia d'instal·lació d'Intel(R) oneAPI Toolkits.

Abans de començar

Després d'instal·lar oneTBB, heu d'establir les variables d'entorn:

1. Aneu al directori d'instal·lació de oneTBB ( ). Per defecte, és el següent:
   1. Al sistema operatiu Linux*:
   2. Per a superusuaris (arrel): /opt/intel/Konami
   3. Per a usuaris normals (no root): $HOME/intel/Konami
   4. Al sistema operatiu Windows*:
   5. <Program Files>\Intel\oneAPI
2. Establiu les variables d'entorn mitjançant l'script in , corrent
   • Al sistema operatiu Linux*: vars.{sh|csh} a /tbb/latest/env
   • Al sistema operatiu Windows*: vars.bat in /tbb/latest/env

Example
A continuació podeu trobar un ex típicample per a un algorisme oneTBB. El sample calcula una suma de tots els nombres enters de l'1 al 100.

OneAPI Threading Building Blocks (oneTBB) i eina pkg-config

• L'eina pkg-config s'utilitza per simplificar la línia de compilació recuperant informació sobre paquets de
  metadades especials files. Ajuda a evitar grans camins codificats i fa que la compilació sigui més portàtil.

Compileu un programa amb pkg-config

• Per compilar un programa de prova test.cpp amb oneTBB en Linux* OS i macOS*, proporcioneu el camí complet per cercar incloure files i biblioteques, o proporcioneu una línia senzilla com aquesta:

On:

• cflags proporciona la biblioteca oneTBB que inclou el camí:
• Les libs proporcionen el nom de la biblioteca Intel(R) oneTBB i el camí de cerca per trobar-la:
• NOTA Per al sistema operatiu Windows*, utilitzeu a més el senyalador d'opció –msvc-syntax que converteix els indicadors de compilació i enllaç en un mode adequat.

Trobeu més

• oneTBB Fòrum comunitari
• Preguntes freqüents sobre productes
• Sol·licituds de suport
• Utilitzeu aquests recursos si necessiteu suport amb oneTBB.
• Notes de la versió Trobeu informació actualitzada sobre el producte, incloses notes detallades, problemes coneguts i canvis.
• Documentació: Guia per a desenvolupadors i referència de l'API
• Apreneu a utilitzar oneTBB.
• GitHub* Trobeu la implementació de oneTBB en codi obert.

Avisos i exempcions de responsabilitat

• Les tecnologies Intel poden requerir l'activació de maquinari, programari o servei activat.
• Cap producte o component pot ser absolutament segur.
• Els vostres costos i resultats poden variar.
• © Intel Corporation. Intel, el logotip d'Intel i altres marques d'Intel són marques comercials d'Intel Corporation o de les seves filials. Altres noms i marques es poden reclamar com a propietat d'altres.
• Aquest document no concedeix cap llicència (expressa o implícita, per preclusió o d'una altra manera) sobre cap dret de propietat intel·lectual.
• Els productes descrits poden contenir defectes de disseny o errors coneguts com a errates que poden provocar que el producte es desviï de les especificacions publicades. Les errates caracteritzades actuals estan disponibles a petició.
• Intel renuncia a totes les garanties explícites i implícites, incloses, sense limitació, les garanties implícites de comerciabilitat, idoneïtat per a un propòsit particular i no infracció, així com qualsevol garantia derivada del funcionament, el curs de la negociació o l'ús en el comerç.

Instal·leu oneTBB al sistema operatiu Windows*

• Aquesta secció descriu com podeu implementar la biblioteca OneAPI Threading Building Blocks (oneTBB) en una màquina amb sistema operatiu Windows*.
• Si teniu previst instal·lar oneTBB com a part d'Intel® oneAPI Base Toolkit, consulteu la secció corresponent de la Guia d'instal·lació de Intel(R) oneAPI Toolkits.
• Si teniu previst instal·lar oneTBB com a producte autònom, seguiu les instruccions següents, utilitzant la GUI de l'instal·lador o un gestor de paquets que trieu.
• Apreneu a instal·lar oneTBB amb GUI i gestor de paquets: * Instal·leu amb GUI * Instal·leu amb un gestor de paquets

Instal·lar amb GUI

Pas 1. Seleccioneu l'instal·lador preferit

1. Aneu a la pàgina de descàrrega. Es mostra una llista d'instal·ladors disponibles.
2. Decidiu el tipus d'instal·lador de Windows que utilitzareu:
   • L'instal·lador en línia té un més petit file mida però requereix una connexió permanent a Internet mentre s'executa.
   • L'instal·lador fora de línia té un més gran file mida però només requereix una connexió a Internet per descarregar l'instal·lador file, i després s'executa fora de línia.
3. Un cop decidit el tipus d'instal·lador, feu clic a l'enllaç corresponent per iniciar la descàrrega.
4. Espereu que finalitzi la descàrrega.

Pas 2. Prepareu l'instal·lador

Per als instal·ladors fora de línia:

1. Executeu el fitxer .exe file has descarregat. S'iniciarà l'extractor de paquets d'instal·lació.
2. Especifiqueu el camí on extreure el paquet: per defecte és C:\Usuaris\ \Descàrregues\w_tbb_oneapi_p_ _fora de línia.
3. Si cal, seleccioneu l'opció Elimina l'extracció temporal files després de la instal·lació.
4. Feu clic a Extreu.
   Per a l'instal·lador en línia, la descàrrega s'inicia automàticament després d'executar el fitxer .exe file.

Pas 3. Executeu la configuració

1. Si esteu executant l'instal·lador fora de línia, feu clic a Continua per continuar. L'instal·lador en línia procedirà automàticament.
2. Al pas Resum, marqueu la casella de selecció Accepto els termes de l'acord de llicència.
3. Seleccioneu el mode d'instal·lació:

• Per utilitzar la configuració d'instal·lació predeterminada, seleccioneu Instal·lació recomanada. oneTBB s'instal·larà a la ubicació per defecte: %Program FIles (x86)%\Intel\oneAPI\. Feu clic a Continuar i aneu al pas Integrar IDE.
• Per modificar la configuració d'instal·lació, seleccioneu Instal·lació personalitzada i feu clic a Personalitza. Passareu al pas de selecció de components. No obstant això, no es pot seleccionar cap components que no sigui oneTBB a causa de la naturalesa de la solució. En aquest mode, podeu canviar la ubicació d'instal·lació predeterminada fent clic a Canvia a l'extrem inferior esquerre de la finestra.

1. Al pas d'Integració de l'IDE, el programa comprova si és possible desplegar oneTBB totalment integrat amb l'IDE de Microsoft Visual Studio; per això, la versió de l'IDE compatible s'ha d'instal·lar a la màquina de destinació. Si no està instal·lat, podeu sortir de la configuració i reiniciar-lo després d'instal·lar l'IDE, o continuar sense integrar-lo.
2. Al pas del Programa de millora del programari, seleccioneu l'opció que preferiu. A continuació, feu clic a Instal·la per iniciar la instal·lació.
3. Espereu que finalitzi el procés. A continuació, feu clic a Finalitzar per tancar l'instal·lador o Anar a Productes instal·lats per comprovar si hi ha actualitzacions o fer altres accions.

NOTA Recordeu configurar les variables d'entorn després de la instal·lació. Consulteu la secció Abans de començar per obtenir-ne informació.

Instal·leu amb un gestor de paquets

• Per instal·lar oneTBB amb un gestor de paquets, executeu l'ordre corresponent descrit a la documentació:
• Conda
• Pip
• NuGet
• NOTA Recordeu configurar les variables d'entorn després de la instal·lació. Consulteu la secció Abans de començar per obtenir-ne informació.

S'està actualitzant oneTBB

• L'actualització perfecta és compatible amb oneTBB 2021.1 i versions posteriors. Per actualitzar oneTBB a la darrera versió, executeu la configuració, tal com es descriu anteriorment.
• Si abans treballaveu amb versions anteriors (TBB), tingueu en compte que les noves versions de oneTBB no proporcionen compatibilitat amb versions anteriors. Vegeu TBB Revamp: Antecedents, canvis i modernització per a més detalls. També, consulteu
• Migració des de TBB per obtenir més informació sobre la migració a oneTBB.

Desinstal·lant oneTBB

• Per desinstal·lar oneTBB, utilitzeu Aplicacions i funcions o Programes i funcions.

Instal·leu oneTBB al sistema operatiu Linux*

• Aquesta secció descriu com podeu implementar la biblioteca OneAPI Threading Building Blocks (oneTBB) en una màquina Linux*. Trieu la manera preferida:
• Instal·leu oneTBB mitjançant la línia d'ordres
• Instal·leu oneTBB utilitzant els gestors de paquets que escolliu:
• Conda
• APT
• YUM
• PIP
• NuGet
• NOTA També podeu instal·lar una TB en una màquina amb sistema operatiu Linux* mitjançant la GUI. Consulteu la Guia d'instal·lació d'Intel(R) oneAPI per obtenir més informació.

Instal·leu oneTBB mitjançant la línia d'ordres

• Per instal·lar oneTBB, executeu una de les ordres següents segons la vostra funció:
• arrel:
• usuari:

On:

• silenciós – Executeu l'instal·lador en mode no interactiu (silenciós).
• eula - Acceptar o rebutjar l'Acord de llicència d'usuari final (EULA), valors admesos: acceptar o rebutjar (predeterminat).
• components - Permeteu-vos personalitzar components instal·lats.

Per exampLI:

Instal·leu oneTBB mitjançant gestors de paquets

• Seguiu les instruccions, utilitzant un gestor de paquets que trieu.

Conda

• Aquesta secció proporciona instruccions generals sobre com instal·lar els blocs de construcció de fils de oneAPI (oneTBB) mitjançant el
• Gestor de paquets Conda*. Per obtenir notes d'instal·lació addicionals, consulteu la documentació de Conda.
• Per instal·lar oneTBB, executeu l'ordre següent:
• També podeu utilitzar: conda install -c intel/label/intel tbb-devel
• NOTA Consulteu la Guia d'instal·lació d'Intel(R) oneAPI per saber com configurar Conda.

APT

• Per instal·lar oneTBB mitjançant APT*, executeu:
• Per exampLI:

NOTA Consulteu la Guia d'instal·lació d'Intel(R) oneAPI per saber com configurar YUM.

Per instal·lar oneTBB mitjançant PIP*, executeu:

Per exampLI:

NuGet

Per instal·lar oneTBB des de NuGet* mitjançant la línia d'ordres, feu el següent:

1. Aneu a nuget.org
2. Executar:

NOTA Consulteu la Guia d'instal·lació d'Intel(R) oneAPI per saber com configurar NuGet*.
NOTA Recordeu configurar les variables d'entorn després de la instal·lació. Consulteu la secció Abans de començar per obtenir-ne informació.

• L'actualització perfecta és compatible amb oneTBB 2021.1 i versions posteriors. Per actualitzar oneTBB a la darrera versió, executeu la configuració, tal com es descriu anteriorment.
• Si abans treballaveu amb versions anteriors (TBB), tingueu en compte que les noves versions de oneTBB no proporcionen compatibilitat amb versions anteriors. Vegeu TBB Revamp: Antecedents, canvis i modernització per a més detalls. A més, consulteu Migració des de TBB per obtenir més informació sobre la migració a una TB.

Documents/Recursos

Intel oneAPI Threading Building Blocks [pdfGuia de l'usuari blocs de construcció de rosca oneAPI, blocs de construcció de rosca, blocs de construcció, blocs

Referències

• Manual d'usuari