Intel oneAPI Threading Building Blocks Guida d'utilizatore

Intel oneAPI Threading Building Blocks

Informazione di u produttu

un API Threading Building Blocks (una TB)

OneAPI Threading Building Blocks (oneTBB) hè un mudellu di prugrammazione parallela basatu in runtime per codice C++ chì usa filamenti. Hè una biblioteca di runtime basata in mudelli pensata per aiutà à sfruttà a prestazione latente di i processori multi-core. oneTBB simplificheghja a prugrammazione parallela sparghjendu a computazione in attività di esecuzione parallela. U parallelismu hè realizatu in un solu prucessu per mezu di fili, un mecanismu di u sistema operatore chì permette l'eseguite simultaneamente i listessi o diversi gruppi d'istruzzioni.

oneTBB pò esse scaricatu cum'è un pruduttu stand-alone o cum'è parte di l'Intel(R) oneAPI Base Toolkit. U pruduttu vene cun un inseme di esigenze di sistema chì deve esse cumpletu prima di a stallazione.

Requisiti di u sistema

• Consultate i Requisiti di u Sistema oneTBB.

Installazione

• Scaricate oneTBB cum'è un pruduttu stand-alone o cum'è una parte di l'Intel(R) oneAPI Base Toolkit.
• Vede a Guida di Installazione per una versione stand-alone (Windows* OS è Linux* OS) è Intel(R) OneAPI Toolkits Installation Guide.

Istruzzioni d'usu

• • Dopu avè installatu oneTBB, stabilisce e variabili di l'ambiente andendu in u cartulare di stallazione oneTBB. Per automaticamente, u cartulare di installazione hè u seguente:

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

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

• • Cumpilà un prugramma cù oneTBB in Linux * OS è macOS * cù l'uttellu pkg-config. Fornite u percorsu sanu per circà includendu files è biblioteche, o furnisce una linea simplice cum'è questu:

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

• Per Windows * OS, aduprate in più a bandiera di l'opzione -msvc-syntax chì cunverte i bandieri di compilazione è ligame in un modu adattatu.
• Consultate a Guida di Sviluppatore è Riferimentu API in GitHub per note dettagliate, prublemi cunnisciuti è cambiamenti.

Cuminciate cù un API Threading Building Blocks (una TB)

• OneAPI Threading Building Blocks (oneTBB) hè un mudellu di prugrammazione parallela basatu in runtime per codice C++ chì usa filamenti. Hè custituitu da una biblioteca di runtime basata in mudelli per aiutà à sfruttà a prestazione latente di processori multi-core.
  oneTBB vi permette di simplificà a prugrammazione parallela, sparghjendu u calculu in attività di esecuzione parallela.
• In un unicu prucessu, u parallelismu hè realizatu à traversu i fili, un mecanismu di u sistema operatore chì permette l'eseguite simultaneamente i listessi o diversi gruppi di struzzioni.
• Quì pudete vede una di e pussibuli esecuzioni di i travaglii per fili.

Aduprate una tabulazione per scrive applicazioni scalabili chì:

• Specificate una struttura parallela logica invece di fili
• Enfatizà a prugrammazione parallela di dati
• Pigliate avanzutage di cullezzione cuncurrenti è algoritmi paralleli
• oneTBB supporta u parallelismu nidificatu è l'equilibriu di carica. Hè significatu chì pudete aduprà a biblioteca senza esse preoccupatu di oversubscribe un sistema. oneTBB hè dispunibule cum'è un pruduttu stand-alone è cum'è parte di l'Intel® oneAPI Base Toolkit.

Requisiti di u sistema

• Consultate i Requisiti di u Sistema oneTBB.

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

• Scaricate oneTBB cum'è un pruduttu stand-alone o cum'è una parte di l'Intel(R) oneAPI Base Toolkit. Vede a Guida di Installazione per una versione stand-alone (Windows* OS è Linux* OS) è Intel(R) oneAPI Toolkits Installation Guide.

Prima di principià

Dopu avè installatu oneTBB, avete bisognu di stabilisce e variabili di l'ambiente:

1. Andà à u cartulare di stallazione oneTBB ( ). Per difettu, hè u seguente:
   1. In Linux * OS:
   2. Per i superutilizatori (root): /opt/intel/Konami
   3. Per l'utilizatori ordinariu (non-root): $HOME/intel/Konami
   4. In Windows * OS:
   5. <Program Files>\Intel\oneAPI
2. Stabilite e variabili di l'ambiente, usendu u script in , correndu
   • In Linux * OS: vars.{sh|csh} in /tbb/latest/env
   • In Windows * OS: vars.bat in /tbb/latest/env

Example
Quì sottu pudete truvà un ex tipicuample per un algoritmu oneTBB. U sample calcula una somma di tutti i numeri interi da 1 à 100.

OneAPI Threading Building Blocks (oneTBB) è strumentu pkg-config

• L'uttellu pkg-config hè utilizatu per simplificà a linea di compilazione ricuperendu l'infurmazioni nantu à i pacchetti da
  metadata speciale files. Aiuta à evità grandi percorsi codificati è rende a compilazione più portable.

Cumpilà un prugramma cù pkg-config

• Per cumpilà un prugramma di prova test.cpp cù oneTBB in Linux * OS è macOS *, furnisce u percorsu cumpletu per circà include files è biblioteche, o furnisce una linea simplice cum'è questu:

Induve:

• cflags furnisce una libreria oneTBB chì include u percorsu:
• libs furnisce u nome di a biblioteca Intel(R) oneTBB è u percorsu di ricerca per truvà:
• NOTA Per Windows * OS, aduprate in più a bandiera di l'opzione -msvc-syntax chì cunverte i bandieri di compilazione è ligame in un modu adattatu.

Truvà più

• unu TBB Forum di a cumunità
• FAQ di u produttu
• E dumande di sustegnu
• Aduprate queste risorse se avete bisognu di supportu cù oneTBB.
• Note di rilascio Truvate infurmazione aghjurnata nantu à u pruduttu, cumprese note dettagliate, prublemi cunnisciuti è cambiamenti.
• Documentation : Guida per sviluppatori è Riferimentu API
• Amparate à aduprà oneTBB.
• GitHub* Truvate l'implementazione di oneTBB in open source.

Avvisi è Disclaimers

• I tecnulugii Intel ponu necessità attivazione di hardware, software o serviziu.
• Nisun pruduttu o cumpunente pò esse assolutamente sicuru.
• I vostri costi è risultati pò varià.
• © Intel Corporation. Intel, u logu Intel è altri marchi Intel sò marchi di Intel Corporation o di e so filiali. Altri nomi è marche ponu esse rivendicate cum'è a pruprietà di l'altri.
• Nisuna licenza (espressa o implicita, per estoppel o altrimenti) à qualsiasi diritti di pruprietà intellettuale hè cuncessa da stu documentu.
• I prudutti descritti ponu cuntene difetti di cuncepimentu o errori cunnisciuti cum'è errata chì causanu u pruduttu per deviate da e specificazioni publicate. L'errata carattarizatu attuale sò dispunibili nantu à dumanda.
• Intel declina tutte e garanzie espresse è implicite, cumprese senza limitazione, e garanzie implicite di cummerciabilità, idoneità per un scopu particulare, è non-infrazione, è ancu qualsiasi garanzia derivante da u cursu di prestazione, u cursu di u cummerciu o l'usu in u cummerciu.

Installa oneTBB in Windows * OS

• Questa sezione descrive cumu pudete implementà a libreria oneAPI Threading Building Blocks (oneTBB) in una macchina Windows * OS.
• Se pensa à installà oneTBB cum'è una parte di Intel® oneAPI Base Toolkit, riferite à a sezione currispondente di a Guida di Installazione di Intel(R) oneAPI Toolkits.
• Se pensa à installà oneTBB cum'è un pruduttu standalone, seguite e struzzioni sottu, utilizendu a GUI di l'installatore o un gestore di pacchetti di a vostra scelta.
• Amparate cumu installà oneTBB cù GUI è gestore di pacchetti: * Installa cù GUI * Installa cù un gestore di pacchetti

Installa cù GUI

Step 1. Selezziunà u installatore preferitu

1. Andà à a pagina Download. Una lista di installatori dispunibuli hè visualizata.
2. Decide u tipu d'installazione di Windows chì vi aduprà:
   • L'installatore in linea hà un più chjucu file dimensione ma richiede una cunnessione Internet permanente mentre corre.
   • L'installatore offline hà più grande file dimensione ma richiede una cunnessione Internet solu per scaricà l'installatore file, è poi funziona offline.
3. Dopu avè decisu u tipu di installatore, cliccate nantu à u ligame currispundente per inizià a scaricazione.
4. Aspettate chì u scaricamentu sia cumpletu.

Passu 2. Preparate u installatore

Per i installatori offline:

1. Executà u .exe file avete scaricatu. L'estrattore di pacchetti di installazione serà lanciatu.
2. Specificate u percorsu induve estrae u pacchettu - predeterminatu hè C:\Users\ \Downloads\w_tbb_oneapi_p_ _offline.
3. Sè necessariu, selezziunà u Remove temporary extracted files dopu l'installazione checkbox.
4. Cliccate Extract.
   Per l'installatore in linea, u scaricamentu principia automaticamente dopu avè eseguitu u .exe file.

Step 3. Run u setup

1. Se stai eseguendo l'installatore offline, clicca su Continue per procedere. L'installatore in linea procederà automaticamente.
2. In u passu Riassuntu, selezziunà a casella di cuntrollu Accetta i termini di l'accordu di licenza.
3. Selezziunà u modu di stallazione:

• Per utilizà i paràmetri di installazione predeterminati, selezziunate Installazione Recommended. oneTBB serà installatu in u locu predeterminatu: %Program FIles (x86)%\Intel\oneAPI\. Cliccate Continue è andate à u passu Integrate IDE.
• Per mudificà i paràmetri di l'installazione, selezziunate Installazione persunalizata è cliccate Personalizà. Andarà à u passu Select Components. Tuttavia, nisun cumpunenti altru chè oneTBB pò esse sceltu per via di a natura di suluzione. In questu modu, pudete cambià u locu di stallazione predeterminatu clicchendu Cambia in l'angulu in fondu à manca di a finestra.

1. À u passu Integrate IDE, u prugramma verifica s'ellu hè pussibule implementà oneTBB cumplettamente integratu cù Microsoft Visual Studio IDE - per quessa, a versione IDE supportata deve esse installata nantu à a macchina di destinazione. Se ùn hè micca stallatu, pudete esce da a stallazione è riavvia dopu a stallazione di l'IDE, o prucede senza integrazione.
2. À u passu di u prugramma di migliurà di u software, selezziunate l'opzione chì preferite. Dopu cliccate Installa per inizià a stallazione.
3. Aspettate chì u prucessu finisci. Dopu cliccate Finisce per chjude l'installatore o Vai à i Prodotti Installati per verificà l'aghjurnamenti o piglià altre azzioni.

NOTA Ricurdatevi di cunfigurà e variabili di l'ambiente dopu a stallazione. Vede a sezione Prima di principià per amparà nantu à questu.

Installa cù un gestore di pacchetti

• Per installà oneTBB cù un gestore di pacchetti, eseguite u cumandamentu currispundente descrittu in a documentazione:
• Cunda
• Pip
• NuGet
• NOTA Ricurdatevi di cunfigurà e variabili di l'ambiente dopu a stallazione. Vede a sezione Prima di principià per amparà nantu à questu.

Aghjurnà oneTBB

• L'aghjurnamentu senza saldatura hè supportatu per oneTBB 2021.1 è versioni successive. Per aghjurnà oneTBB à l'ultima versione, eseguite a cunfigurazione, cum'è descritta sopra.
• Se avete travagliatu cù e versioni più vechje (TBB), cunzidira chì e novi versioni di oneTBB ùn furnisce micca una cumpatibilità inversa. Vede TBB Revamp: Sfondate, Cambiamenti è Modernizazione per i dettagli. Inoltre, riferite à
• Migrazione da TBB per più infurmazione nantu à a migrazione à oneTBB.

Disinstalla oneTBB

• Per disinstallà oneTBB, utilizate Applicazioni è Funzioni o Programmi è Funzioni.

Installa oneTBB in Linux * OS

• Questa sezione descrive cumu pudete implementà a libreria oneAPI Threading Building Blocks (oneTBB) in una macchina Linux *. Sceglite u modu preferitu:
• Installa oneTBB Utilizendu a Linea di Command
• Installa oneTBB Utilizendu i gestori di pacchetti di scelta:
• Cunda
• APT
• GAMMA
• PIP
• NuGet
• NOTA Pudete ancu installà una TB in una macchina Linux * OS cù GUI. Vede a Guida di Installazione Intel(R) oneAPI per sapè di più.

Installa oneTBB Utilizendu a Linea di Command

• Per installà oneTBB, eseguite unu di i seguenti cumandamenti secondu u vostru rolu:
• radica:
• utilizatore:

Induve:

• silenziu - Eseguite l'installatore in modu micca interattivu (silenziu).
• eula - Accetta o ricusà l'Accordu di Licenza di l'Usuariu Finale (EULA), valori supportati: accettate o ricusate (predeterminatu).
• cumpunenti - Permette di cumpunenti installati persunalizati.

Per esampLe:

Installa oneTBB Utilizendu Gestori di Pacchetti

• Segui l'istruzzioni, usendu un gestore di pacchetti di a vostra scelta.

Cunda

• Questa sezione furnisce struzzioni generali nantu à l'installazione di i blocchi di costruzione di filettatura oneAPI (oneTBB) via
• Conda* gestore di pacchetti. Per note di installazione supplementari, riferite à a documentazione Conda.
• Per installà oneTBB, eseguite u cumandimu seguente:
• Pudete ancu aduprà: conda install -c intel/label/intel tbb-devel
• NOTA Vede a Guida di Installazione Intel(R) oneAPI per amparà cumu cunfigurà Conda.

APT

• Per installà oneTBB cù APT *, eseguite:
• Per esampLe:

NOTA Vede a Guida di Installazione Intel(R) oneAPI per amparà cumu cunfigurà YUM.

Per installà oneTBB cù PIP*, eseguite:

Per esampLe:

NuGet

Per installà oneTBB da NuGet * utilizendu a linea di cummanda, fate u seguente:

1. Andà à nuget.org
2. Corri:

NOTA Vede a Guida di Installazione Intel(R) oneAPI per amparà cumu cunfigurà NuGet *.
NOTA Ricurdatevi di cunfigurà e variabili di l'ambiente dopu a stallazione. Vede a sezione Prima di principià per amparà nantu à questu.

• L'aghjurnamentu senza saldatura hè supportatu per oneTBB 2021.1 è versioni successive. Per aghjurnà oneTBB à l'ultima versione, eseguite a cunfigurazione, cum'è descritta sopra.
• Se avete travagliatu cù e versioni più vechje (TBB), cunzidira chì e novi versioni di oneTBB ùn furnisce micca una cumpatibilità inversa. Vede TBB Revamp: Sfondate, Cambiamenti è Modernizazione per i dettagli. Inoltre, riferite à Migrazione da TBB per più infurmazione nantu à a migrazione à una TB.