intel-LOGO

intel oneAPI Threading Building Blocks

intel-oneAPI-Threading-Building Blocks-PRODUCT

Produktinformation

en API Threading Building Blocks (en TB)

oneAPI Threading Building Blocks (oneTBB) är en runtime-baserad parallell programmeringsmodell för C++-kod som använder trådar. Det är ett mallbaserat runtime-bibliotek designat för att hjälpa till att utnyttja den latenta prestandan hos flerkärniga processorer. oneTBB förenklar parallell programmering genom att dela upp beräkningar i parallellkörningsuppgifter. Parallellism utförs inom en enda process genom trådar, en operativsystemmekanism som gör att samma eller olika uppsättningar instruktioner kan exekveras samtidigt.

oneTBB kan laddas ner som en fristående produkt eller som en del av Intel(R) oneAPI Base Toolkit. Produkten levereras med en uppsättning systemkrav som bör uppfyllas före installation.

Systemkrav

  • Se systemkraven för oneTBB.

Installation

  • Ladda ner oneTBB som en fristående produkt eller som en del av Intel(R) oneAPI Base Toolkit.
  • Se installationsguiden för en fristående version (Windows* OS och Linux* OS) och Intel(R) oneAPI Toolkits Installationsguide.

Användningsinstruktioner

    • Efter installation av oneTBB, ställ in miljövariablerna genom att gå till oneTBB installationskatalogen. Som standard är installationskatalogen följande:

För Linux* OS: /opt/intel/Konami/tab/latest/env/vars.sh

För Windows* OS: %ProgramFiles(x86)%InteloneAPItbblatestenvvars.bat

    • Kompilera ett program med oneTBB på Linux* OS och macOS* med hjälp av verktyget pkg-config. Ge den fullständiga sökvägen att söka efter inklusive files och bibliotek, eller ange en enkel rad så här:

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

  • För Windows* OS, använd dessutom alternativflaggan –msvc-syntax som konverterar kompilerings- och länkningsflaggor i lämpligt läge.
  • Se utvecklarguiden och API-referens på GitHub för detaljerade anteckningar, kända problem och ändringar.

Kom igång med en API Threading Building Blocks (en TB)

  • oneAPI Threading Building Blocks (oneTBB) är en runtime-baserad parallell programmeringsmodell för C++-kod som använder trådar. Den består av ett mallbaserat runtime-bibliotek som hjälper dig att utnyttja den latenta prestandan hos flerkärniga processorer.
    oneTBB gör det möjligt för dig att förenkla parallell programmering genom att dela upp beräkningar i parallellkörande uppgifter.
  • Inom en enda process utförs parallellism genom trådar, en operativsystemmekanism som gör att samma eller olika uppsättningar instruktioner kan exekveras samtidigt.
  • Här kan du se en av de möjliga utförandet av uppgifter per trådar.intel-oneAPI-Threading-Building Blocks-FIG-1

Använd en flik för att skriva skalbara applikationer som:

  • Ange logisk parallell struktur istället för trådar
  • Betona dataparallell programmering
  • Ta förhandtage av samtidiga samlingar och parallella algoritmer
  • oneTBB stöder kapslad parallellism och lastbalansering. Det innebär att du kan använda biblioteket utan att vara orolig för att överteckna ett system. oneTBB är tillgänglig som en fristående produkt och som en del av Intel® oneAPI Base Toolkit.

Systemkrav

  • Se systemkraven för oneTBB.

Ladda ner Intel(R) oneAPI Threading Building Blocks (oneTBB)

  • Ladda ner oneTBB som en fristående produkt eller som en del av Intel(R) oneAPI Base Toolkit. Se Installationsguide för en fristående version (Windows* OS och Linux* OS) och Intel(R) oneAPI Toolkits Installation Guide.
Innan du börjar

Efter installation av oneTBB måste du ställa in miljövariablerna:

  1. Gå till oneTBB installationskatalogen ( ). Som standard, är följande:
    1. På Linux* OS:
    2. För superanvändare (root): /opt/intel/Konami
    3. För vanliga användare (icke-root): $HOME/intel/Konami
    4. På Windows* OS:
    5. <Program Files>\Intel\oneAPI
  2. Ställ in miljövariablerna med hjälp av skriptet i , genom att springa
    • På Linux* OS: vars.{sh|csh} in /tbb/senaste/env
    • På Windows* OS: vars.bat in /tbb/senaste/env

Example
Nedan kan du hitta ett typiskt example för en oneTBB-algoritm. sample beräknar summan av alla heltal från 1 till 100.intel-oneAPI-Threading-Building Blocks-FIG-2

oneAPI Threading Building Blocks (oneTBB) och pkg-config-verktyget

  • Verktyget pkg-config används för att förenkla kompileringsraden genom att hämta information om paket från
    speciell metadata files. Det hjälper till att undvika stora hårdkodade sökvägar och gör kompileringen mer portabel.

Kompilera ett program med pkg-config

  • För att kompilera ett testprogram test.cpp med oneTBB på Linux* OS och macOS*, ange den fullständiga sökvägen att söka efter inklusive files och bibliotek, eller ange en enkel rad så här:intel-oneAPI-Threading-Building Blocks-FIG-3

Där:

  • cflags tillhandahåller oneTBB-bibliotek inklusive sökväg:intel-oneAPI-Threading-Building Blocks-FIG-4
  • libs ger Intel(R) oneTBB-biblioteksnamnet och sökvägen för att hitta det:intel-oneAPI-Threading-Building Blocks-FIG-4
  • NOTERA För Windows* OS, använd dessutom alternativflaggan –msvc-syntax som konverterar kompilerings- och länkningsflaggor i lämpligt läge.
Hitta mer
  • enTBB Samhällsforum
  • Vanliga frågor om produkter
  • Supportförfrågningar
  • Använd dessa resurser om du behöver support med oneTBB.
  • Release Notes Hitta uppdaterad information om produkten, inklusive detaljerade anteckningar, kända problem och ändringar.
  • Dokumentation: Utvecklarguide och API-referens
  • Lär dig att använda oneTBB.
  • GitHub* Hitta oneTBB-implementering i öppen källkod.

Meddelanden och ansvarsfriskrivningar

  • Intel-teknologier kan kräva aktiverad maskinvara, programvara eller tjänstaktivering.
  • Ingen produkt eller komponent kan vara helt säker.
  • Dina kostnader och resultat kan variera.
  • © Intel Corporation. Intel, Intels logotyp och andra Intel-märken är varumärken som tillhör Intel Corporation eller dess dotterbolag. Andra namn och varumärken kan göras anspråk på att vara andras egendom.
  • Ingen licens (uttrycklig eller underförstådd, genom estoppel eller på annat sätt) till några immateriella rättigheter beviljas av detta dokument.
  • De beskrivna produkterna kan innehålla konstruktionsfel eller fel som kallas errata som kan göra att produkten avviker från publicerade specifikationer. Aktuella karakteriserade errata är tillgängliga på begäran.
  • Intel frånsäger sig alla uttryckliga och underförstådda garantier, inklusive utan begränsning, underförstådda garantier om säljbarhet, lämplighet för ett visst ändamål och icke-intrång, såväl som alla garantier som härrör från prestanda, affärer eller användning i handeln.

Installera oneTBB på Windows* OS

  • Det här avsnittet beskriver hur du kan distribuera oneAPI Threading Building Blocks (oneTBB)-biblioteket på en Windows* OS-dator.
  • Om du planerar att installera oneTBB som en del av Intel® oneAPI Base Toolkit, se motsvarande avsnitt i Intel(R) oneAPI Toolkits Installation Guide.
  • Om du planerar att installera oneTBB som en fristående produkt, följ instruktionerna nedan med installationsgränssnittet eller en valfri pakethanterare.
  • Lär dig hur du installerar oneTBB med GUI och pakethanterare: * Installera med GUI * Installera med en pakethanterare

Installera med GUI

Steg 1. Välj önskat installationsprogram

  1. Gå till nedladdningssidan. En lista över tillgängliga installatörer visas.
  2. Bestäm vilken typ av Windows-installation du ska använda:
    • Online installer har en mindre file storlek men kräver en permanent Internetanslutning när den körs.
    • Offlineinstallatören har en större file storlek men kräver en internetanslutning endast för att ladda ner installationsprogrammet file, och körs sedan offline.
  3. När du har bestämt dig för installationstypen klickar du på motsvarande länk för att starta nedladdningen.
  4. Vänta tills nedladdningen är klar.

Steg 2. Förbered installationsprogrammet

För offlineinstallatörer:

  1. Kör .exe file du har laddat ner. Installationspaketutdraget kommer att startas.
  2. Ange sökvägen där paketet ska extraheras – standard är C:\Users\ \Nedladdningar\w_tbb_oneapi_p_ _off-line.
  3. Om det behövs, välj Ta bort tillfälligt extraherat files efter installation kryssrutan.
  4. Klicka på Extrahera.
    För onlineinstallationsprogrammet startar nedladdningen automatiskt efter att du kört .exe file.

Steg 3. Kör installationen

  1. Om du kör offlineinstallationsprogrammet klickar du på Fortsätt för att fortsätta. Onlineinstallationsprogrammet fortsätter automatiskt.
  2. I steget Sammanfattning markerar du kryssrutan Jag accepterar villkoren i licensavtalet.
  3. Välj installationsläge:
  • För att använda standardinstallationsinställningarna, välj Rekommenderad installation. oneTBB kommer att installeras på standardplatsen: %Program FIles (x86)%\Intel\oneAPI\. Klicka på Fortsätt och fortsätt till steget Integrera IDE.
  • För att ändra installationsinställningarna, välj Anpassad installation och klicka på Anpassa. Du går vidare till steget Välj komponenter. Inga andra komponenter än enTBB kan dock väljas på grund av lösningens natur. I det här läget kan du ändra standardinstallationsplatsen genom att klicka på Ändra i det nedre vänstra hörnet av fönstret.intel-oneAPI-Threading-Building Blocks-FIG-5
  1. Vid Integrate IDE-steget kontrollerar programmet om det är möjligt att distribuera oneTBB helt integrerat med Microsoft Visual Studio IDE – för det måste den IDE-version som stöds vara installerad på måldatorn. Om den inte är installerad kan du avsluta installationen och starta om den efter installation av IDE, eller fortsätta utan integration.
  2. Välj det alternativ du föredrar i steget Programförbättringsprogram. Klicka sedan på Installera för att starta installationen.
  3. Vänta tills processen är klar. Klicka sedan på Slutför för att stänga installationsprogrammet eller Gå till Installerade produkter för att söka efter uppdateringar eller vidta andra åtgärder.

NOTERA Kom ihåg att konfigurera miljövariabler efter installationen. Se avsnittet Innan du börjar för att lära dig mer om det.

Installera med en pakethanterare

  • För att installera oneTBB med en pakethanterare, kör motsvarande kommando som beskrivs i dokumentationen:
  • Conda
  • Pip
  • NuGet
  • NOTERA Kom ihåg att konfigurera miljövariabler efter installationen. Se avsnittet Innan du börjar för att lära dig mer om det.

Uppgraderar oneTBB

  • Den sömlösa uppgraderingen stöds för oneTBB 2021.1 och senare versioner. För att uppgradera oneTBB till den senaste versionen, kör installationen enligt beskrivningen ovan.
  • Om du brukade arbeta med äldre versioner (TBB), tänk på att de nya versionerna av oneTBB inte ger bakåtkompatibilitet. Se TBB Revamp: Bakgrund, ändringar och modernisering för detaljer. Se även
  • Migrera från TBB för mer information om migrering till oneTBB.

Avinstallerar oneTBB

  • För att avinstallera oneTBB, använd Program och funktioner eller Program och funktioner.

Installera oneTBB på Linux* OS

  • Det här avsnittet beskriver hur du kan distribuera oneAPI Threading Building Blocks (oneTBB)-biblioteket på en Linux*-maskin. Välj önskat sätt:
  • Installera oneTBB med kommandoraden
  • Installera oneTBB med valfria pakethanterare:
  • Conda
  • BENÄGEN
  • YUM
  • PIP
  • NuGet
  • NOTERA Du kan också installera en TB på en Linux* OS-maskin med GUI. Se installationsguiden för Intel(R) oneAPI för mer information.

Installera oneTBB med kommandoraden

  • För att installera oneTBB, kör ett av följande kommandon enligt din roll:
  • rot:intel-oneAPI-Threading-Building Blocks-FIG-6
  • användare:intel-oneAPI-Threading-Building Blocks-FIG-7

Där:

  • tyst – Kör installationsprogrammet i icke-interaktivt (tyst) läge.
  • eula – Acceptera eller avvisa slutanvändarlicensavtal (EULA), värden som stöds: acceptera eller avvisa (standard).
  • komponenter - Låt dig anpassade installerade komponenter.

Till exempelampde:intel-oneAPI-Threading-Building Blocks-FIG-8

Installera oneTBB med pakethanterare

  • Följ instruktionerna med en valfri pakethanterare.

Conda

  • Det här avsnittet ger allmänna instruktioner om hur du installerar oneAPI Threading Building Blocks (oneTBB) via
  • Conda* pakethanterare. För ytterligare installationsanvisningar, se Conda-dokumentationen.
  • För att installera oneTBB, kör följande kommando:intel-oneAPI-Threading-Building Blocks-FIG-9
  • Du kan också använda: conda install -c intel/label/intel tbb-devel
  • NOTERA Se Intel(R) oneAPI Installation Guide för att lära dig hur du konfigurerar Conda.

BENÄGEN

  • För att installera oneTBB med APT*, kör:intel-oneAPI-Threading-Building Blocks-FIG-10
  • Till exempelampde:

intel-oneAPI-Threading-Building Blocks-FIG-11

NOTERA Se Intel(R) oneAPI Installation Guide för att lära dig hur du konfigurerar YUM.

För att installera oneTBB med PIP*, kör:intel-oneAPI-Threading-Building Blocks-FIG-14

Till exempelampde:

intel-oneAPI-Threading-Building Blocks-FIG-15

NuGet

För att installera oneTBB från NuGet* med hjälp av kommandoraden, gör följande:

  1. Gå till nuget.org
  2. Sikt:intel-oneAPI-Threading-Building Blocks-FIG-16

NOTERA Se Intel(R) oneAPI Installation Guide för att lära dig hur du konfigurerar NuGet*.
NOTERA Kom ihåg att konfigurera miljövariabler efter installationen. Se avsnittet Innan du börjar för att lära dig mer om det.

Uppgraderar oneTBB
  • Den sömlösa uppgraderingen stöds för oneTBB 2021.1 och senare versioner. För att uppgradera oneTBB till den senaste versionen, kör installationen enligt beskrivningen ovan.
  • Om du brukade arbeta med äldre versioner (TBB), tänk på att de nya versionerna av oneTBB inte ger bakåtkompatibilitet. Se TBB Revamp: Bakgrund, ändringar och modernisering för detaljer. Se också Migrera från TBB för mer information om migrering till en TB.

Dokument/resurser

intel oneAPI Threading Building Blocks [pdf] Användarhandbok
oneAPI Threading Building Blocks, Threading Building Blocks, Building Blocks, Blocks

Referenser

Lämna en kommentar

Din e-postadress kommer inte att publiceras. Obligatoriska fält är markerade *