Blocchi predefiniti di threading Intel OneAPI

Informazioni sul prodotto

un API Threading Building Blocks (un TB)

oneAPI Threading Building Blocks (oneTBB) è un modello di programmazione parallela basato su runtime per il codice C++ che utilizza i thread. È una libreria di runtime basata su modelli progettata per aiutare a sfruttare le prestazioni latenti dei processori multi-core. oneTBB semplifica la programmazione parallela suddividendo il calcolo in attività in esecuzione parallela. Il parallelismo viene eseguito all'interno di un singolo processo attraverso i thread, un meccanismo del sistema operativo che consente l'esecuzione simultanea di set di istruzioni uguali o diversi.

oneTBB può essere scaricato come prodotto autonomo o come parte di Intel(R) oneAPI Base Toolkit. Il prodotto viene fornito con una serie di requisiti di sistema che devono essere soddisfatti prima dell'installazione.

Requisiti di sistema

• Fare riferimento ai requisiti di sistema di oneTBB.

Installazione

• Scarica oneTBB come prodotto autonomo o come parte di Intel(R) oneAPI Base Toolkit.
• Fare riferimento alla Guida all'installazione per una versione autonoma (sistema operativo Windows* e sistema operativo Linux*) e alla Guida all'installazione di Intel(R) oneAPI Toolkits.

Istruzioni per l'uso

• • Dopo aver installato oneTBB, imposta le variabili di ambiente accedendo alla directory di installazione di oneTBB. Per impostazione predefinita, la directory di installazione è la seguente:

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

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

• • Compila un programma utilizzando oneTBB su Linux* OS e macOS* utilizzando lo strumento pkg-config. Fornisci il percorso completo da cercare incluso files e librerie o fornire una riga semplice come questa:

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

• Per il sistema operativo Windows*, utilizzare inoltre il flag di opzione –msvc-syntax che converte i flag di compilazione e di collegamento in una modalità appropriata.
• Consulta la Developer Guide e API Reference su GitHub per note dettagliate, problemi noti e modifiche.

Inizia con un blocco predefinito di threading API (un TB)

• oneAPI Threading Building Blocks (oneTBB) è un modello di programmazione parallela basato su runtime per il codice C++ che utilizza i thread. Consiste in una libreria di runtime basata su modelli per aiutarti a sfruttare le prestazioni latenti dei processori multi-core.
  oneTBB ti consente di semplificare la programmazione parallela suddividendo il calcolo in attività in esecuzione parallela.
• All'interno di un singolo processo, il parallelismo viene eseguito tramite thread, un meccanismo del sistema operativo che consente l'esecuzione simultanea di insiemi di istruzioni uguali o diversi.
• Qui puoi vedere una delle possibili esecuzioni di attività da parte dei thread.

Usa una scheda per scrivere applicazioni scalabili che:

• Specificare la struttura parallela logica anziché i thread
• Enfatizzare la programmazione parallela ai dati
• Prendi vantaggiotage di raccolte simultanee e algoritmi paralleli
• oneTBB supporta il parallelismo annidato e il bilanciamento del carico. Significa che puoi utilizzare la libreria senza preoccuparti di sovrascrivere un sistema. oneTBB è disponibile come prodotto autonomo e come parte di Intel® oneAPI Base Toolkit.

Requisiti di sistema

• Fare riferimento ai requisiti di sistema di oneTBB.

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

• Scarica oneTBB come prodotto autonomo o come parte di Intel(R) oneAPI Base Toolkit. Consultare la Guida all'installazione per una versione autonoma (sistema operativo Windows* e sistema operativo Linux*) e la Guida all'installazione dei toolkit Intel(R) oneAPI.

Prima di iniziare

Dopo aver installato oneTBB, è necessario impostare le variabili di ambiente:

1. Vai alla directory di installazione di oneTBB ( ). Per impostazione predefinita, è il seguente:
   1. Su sistema operativo Linux*:
   2. Per i super utenti (root): /opt/intel/Konami
   3. Per utenti ordinari (non root): $HOME/intelligence/Konami
   4. Su sistema operativo Windows*:
   5. <Program Files>\Intel\oneAPI
2. Imposta le variabili di ambiente, usando lo script in , correndo
   • Su sistema operativo Linux*: vars.{sh|csh} in /tbb/più recente/env
   • Su sistema operativo Windows*: vars.bat in /tbb/più recente/env

Example
Di seguito puoi trovare un tipico example per un algoritmo oneTBB. La sample calcola una somma di tutti i numeri interi da 1 a 100.

oneAPI Threading Building Blocks (oneTBB) e strumento pkg-config

• Lo strumento pkg-config viene utilizzato per semplificare la riga di compilazione recuperando le informazioni sui pacchetti da
  metadati speciali fileS. Aiuta a evitare grandi percorsi hardcoded e rende la compilazione più portabile.

Compila un programma usando pkg-config

• Per compilare un programma di test test.cpp con un TBB su SO Linux* e macOS*, fornire il percorso completo per cercare include files e librerie o fornire una riga semplice come questa:

Dove:

• cflags fornisce una libreria oneTBB incluso il percorso:
• libs fornisce il nome della libreria Intel(R) oneTBB e il percorso di ricerca per trovarla:
• NOTA Per il sistema operativo Windows*, utilizzare inoltre il flag di opzione –msvc-syntax che converte i flag di compilazione e di collegamento in una modalità appropriata.

Scopri di più

• unoTBB Forum della comunità
• Domande frequenti sui prodotti
• Richieste di supporto
• Usa queste risorse se hai bisogno di supporto con oneTBB.
• Note di rilascio Trova informazioni aggiornate sul prodotto, incluse note dettagliate, problemi noti e modifiche.
• Documentazione: Guida per gli sviluppatori e riferimento API
• Impara a usare oneTBB.
• GitHub* Trova l'implementazione di oneTBB nell'open source.

Avvisi e dichiarazioni di non responsabilità

• Le tecnologie Intel potrebbero richiedere l'attivazione di hardware, software o servizi abilitati.
• Nessun prodotto o componente può essere assolutamente sicuro.
• I tuoi costi e risultati possono variare.
• © Intel Corporation. Intel, il logo Intel e altri marchi Intel sono marchi di Intel Corporation o delle sue consociate. Altri nomi e marchi possono essere rivendicati come proprietà di altri.
• Il presente documento non concede alcuna licenza (espressa o implicita, per preclusione o altro) su alcun diritto di proprietà intellettuale.
• I prodotti descritti possono contenere difetti di progettazione o errori noti come errata che possono far deviare il prodotto dalle specifiche pubblicate. Gli errata caratterizzati attuali sono disponibili su richiesta.
• Intel esclude tutte le garanzie esplicite e implicite, comprese, a titolo esemplificativo, le garanzie implicite di commerciabilità, idoneità per uno scopo particolare e non violazione, nonché qualsiasi garanzia derivante da prestazioni, trattative o usi commerciali.

Installa oneTBB su sistema operativo Windows*

• Questa sezione descrive come distribuire la libreria oneAPI Threading Building Blocks (oneTBB) su un computer con sistema operativo Windows*.
• Se si prevede di installare oneTBB come parte di Intel® oneAPI Base Toolkit, fare riferimento alla sezione corrispondente della Guida all'installazione di Intel(R) oneAPI Toolkits.
• Se prevedi di installare oneTBB come prodotto autonomo, segui le istruzioni riportate di seguito, utilizzando la GUI del programma di installazione o un gestore di pacchetti di tua scelta.
• Scopri come installare oneTBB con GUI e gestore pacchetti: * Installa con GUI * Installa con un gestore pacchetti

Installa con la GUI

Passo 1. Seleziona il programma di installazione preferito

1. Vai alla pagina di download. Viene visualizzato un elenco di programmi di installazione disponibili.
2. Decidi il tipo di programma di installazione di Windows che utilizzerai:
   • Il programma di installazione online ha un file più piccolo file dimensioni ma richiede una connessione Internet permanente durante l'esecuzione.
   • Il programma di installazione offline ha un file più grande file size ma richiede una connessione Internet solo per scaricare il programma di installazione filee quindi viene eseguito offline.
3. Dopo aver deciso il tipo di programma di installazione, fare clic sul collegamento corrispondente per avviare il download.
4. Attendi il completamento del download.

Passaggio 2. Preparare il programma di installazione

Per gli installatori offline:

1. Esegui il file .exe file hai scaricato. Verrà avviato l'estrattore del pacchetto di installazione.
2. Specificare il percorso dove estrarre il pacchetto – il default è C:\Users\ \Download\w_tbb_oneapi_p_ _disconnesso.
3. Se necessario, selezionare Rimuovi temporaneamente estratto files dopo l'installazione casella di controllo.
4. Fare clic su Estrai.
   Per il programma di installazione online, il download si avvia automaticamente dopo aver eseguito il file .exe file.

Passaggio 3. Eseguire l'installazione

1. Se stai eseguendo il programma di installazione offline, fai clic su Continua per procedere. Il programma di installazione online procederà automaticamente.
2. Nella fase Riepilogo selezionare la casella di controllo Accetto i termini del contratto di licenza.
3. Seleziona la modalità di installazione:

• Per utilizzare le impostazioni di installazione predefinite, selezionare Installazione consigliata. oneTBB verrà installato nella posizione predefinita: %Program FIles (x86)%\Intel\oneAPI\. Fai clic su Continua e procedi al passaggio Integra IDE.
• Per modificare le impostazioni di installazione, selezionare Installazione personalizzata e fare clic su Personalizza. Si procederà al passaggio Seleziona componenti. Tuttavia, non è possibile selezionare componenti diversi da oneTBB a causa della natura della soluzione. In questa modalità è possibile modificare il percorso di installazione predefinito facendo clic su Modifica nell'angolo in basso a sinistra della finestra.

1. Al passaggio Integrate IDE, il programma verifica se è possibile distribuire un TBB completamente integrato con Microsoft Visual Studio IDE: per questo, la versione IDE supportata deve essere installata sul computer di destinazione. Se non installato, è possibile uscire dal setup e riavviarlo dopo aver installato l'IDE, oppure procedere senza l'integrazione.
2. Al passaggio Software Improvement Program, seleziona l'opzione che preferisci. Quindi fare clic su Installa per avviare l'installazione.
3. Attendere il completamento del processo. Quindi fare clic su Fine per chiudere il programma di installazione o su Vai ai prodotti installati per verificare la disponibilità di aggiornamenti o intraprendere altre azioni.

NOTA Ricordarsi di configurare le variabili d'ambiente dopo l'installazione. Consulta la sezione Prima di iniziare per saperne di più.

Installa con un gestore di pacchetti

• Per installare oneTBB con un gestore di pacchetti, eseguire il comando corrispondente descritto nella documentazione:
• Conda
• Pippo
• NuGet
• NOTA Ricordarsi di configurare le variabili d'ambiente dopo l'installazione. Vedere la sezione Prima di iniziare per saperne di più.

Aggiornamento di oneTBB

• L'aggiornamento continuo è supportato per oneTBB 2021.1 e versioni successive. Per aggiornare oneTBB all'ultima versione, eseguire l'installazione, come descritto sopra.
• Se lavoravi con versioni precedenti (TBB), considera che le nuove versioni di oneTBB non forniscono compatibilità con le versioni precedenti. Vedi TBB Revamp: Contesto, modifiche e modernizzazione per i dettagli. Inoltre, fare riferimento a
• Migrazione da TBB per ulteriori informazioni sulla migrazione a oneTBB.

Disinstallazione di oneTBB

• Per disinstallare oneTBB, utilizzare Applicazioni e funzionalità o Programmi e funzionalità.

Installa oneTBB su sistema operativo Linux*

• Questa sezione descrive come distribuire la libreria oneAPI Threading Building Blocks (oneTBB) su una macchina Linux*. Scegli la modalità preferita:
• Installa oneTBB utilizzando la riga di comando
• Installa oneTBB utilizzando i gestori di pacchetti preferiti:
• Conda
• ADAPT (Approvvigionamento idrico e idrico)
• CHE BONTA'
• PIP
• NuGet
• NOTA Puoi anche installare un TB su una macchina con sistema operativo Linux* utilizzando la GUI. Consulta la Guida all'installazione di Intel(R) oneAPI per ulteriori informazioni.

Installa oneTBB utilizzando la riga di comando

• Per installare oneTBB, esegui uno dei seguenti comandi in base al tuo ruolo:
• radice:
• utente:

Dove:

• silenzioso – Eseguire il programma di installazione in modalità non interattiva (silenziosa).
• eulà – Accetta o rifiuta il contratto di licenza con l'utente finale (EULA), valori supportati: accetta o rifiuta (impostazione predefinita).
• componenti – Consente di personalizzare i componenti installati.

Per esempioampon:

Installa oneTBB utilizzando i gestori di pacchetti

• Segui le istruzioni, utilizzando un gestore di pacchetti di tua scelta.

Conda

• Questa sezione fornisce istruzioni generali sull'installazione di oneAPI Threading Building Blocks (oneTBB) tramite il file
• Gestore di pacchetti Conda*. Per ulteriori note sull'installazione, fare riferimento alla documentazione di Conda.
• Per installare oneTBB, esegui il seguente comando:
• Puoi anche usare: conda install -c intel/label/intel tbb-devel
• NOTA Vedere la Guida all'installazione di Intel(R) oneAPI per informazioni su come configurare Conda.

ADAPT (Approvvigionamento idrico e idrico)

• Per installare oneTBB utilizzando APT*, eseguire:
• Per esempioampon:

NOTA Consulta la Guida all'installazione di Intel(R) oneAPI per informazioni su come configurare YUM.

Per installare oneTBB utilizzando PIP*, eseguire:

Per esempioampon:

NuGet

Per installare oneTBB da NuGet* utilizzando la riga di comando, procedi come segue:

1. Vai a nuget.org
2. Correre:

NOTA Consulta la Guida all'installazione di Intel(R) oneAPI per informazioni su come configurare NuGet*.
NOTA Ricordarsi di configurare le variabili d'ambiente dopo l'installazione. Consulta la sezione Prima di iniziare per saperne di più.

• L'aggiornamento continuo è supportato per oneTBB 2021.1 e versioni successive. Per aggiornare oneTBB all'ultima versione, eseguire l'installazione, come descritto sopra.
• Se lavoravi con versioni precedenti (TBB), considera che le nuove versioni di oneTBB non forniscono compatibilità con le versioni precedenti. Vedi TBB Revamp: Contesto, modifiche e modernizzazione per i dettagli. Inoltre, fare riferimento a Migrazione da TBB per ulteriori informazioni sulla migrazione a un TB.

Documenti / Risorse

Blocchi predefiniti di threading Intel OneAPI [pdf] Guida utente Blocchi predefiniti di threading oneAPI, Blocchi predefiniti di threading, Blocchi predefiniti, Blocchi

Riferimenti

• Manuale d'uso