Intel-LOGO

intel oneAPI Threading-bouwstenen

intel-oneAPI-Threading-Building-Blocks-PRODUCT

Productinformatie

één API Threading-bouwstenen (één TB)

oneAPI Threading Building Blocks (oneTBB) is een runtime-gebaseerd parallel programmeermodel voor C++-code dat gebruikmaakt van threads. Het is een op sjablonen gebaseerde runtimebibliotheek die is ontworpen om de latente prestaties van multi-coreprocessors te helpen benutten. oneTBB vereenvoudigt parallel programmeren door berekeningen op te splitsen in parallel lopende taken. Parallellisme wordt binnen een enkel proces uitgevoerd via threads, een besturingssysteemmechanisme waarmee dezelfde of verschillende sets instructies tegelijkertijd kunnen worden uitgevoerd.

oneTBB kan worden gedownload als een zelfstandig product of als onderdeel van de Intel(R) oneAPI Base Toolkit. Het product wordt geleverd met een reeks systeemvereisten waaraan moet worden voldaan voordat het wordt geïnstalleerd.

Systeemvereisten

  • Raadpleeg de oneTBB-systeemvereisten.

Installatie

  • Download oneTBB als zelfstandig product of als onderdeel van de Intel(R) oneAPI Base Toolkit.
  • Raadpleeg de Installatiehandleiding voor een zelfstandige versie (Windows* OS en Linux* OS) en Intel(R) oneAPI Toolkits Installatiehandleiding.

Gebruiksaanwijzing

    • Na het installeren van oneTBB stelt u de omgevingsvariabelen in door naar de oneTBB-installatiemap te gaan. Standaard is de installatiemap als volgt:

Voor Linux* besturingssysteem: /opt/intel/Konami/tab/latest/env/vars.sh

Voor Windows* besturingssysteem: %ProgrammaFiles(x86)%InteloneAPItbblatestenvvars.bat

    • Compileer een programma met oneTBB op Linux* OS en macOS* met behulp van de pkg-config tool. Geef het volledige pad op waarnaar u wilt zoeken, inclusief files en bibliotheken, of geef een eenvoudige regel als deze:

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

  • Gebruik voor Windows* OS bovendien de –msvc-syntaxisoptievlag die de compileer- en koppelingsvlaggen in een geschikte modus converteert.
  • Raadpleeg de Developer Guide en API Reference op GitHub voor gedetailleerde opmerkingen, bekende problemen en wijzigingen.

Aan de slag met één API Threading Building Blocks (één TB)

  • oneAPI Threading Building Blocks (oneTBB) is een runtime-gebaseerd parallel programmeermodel voor C++-code dat gebruikmaakt van threads. Het bestaat uit een op sjablonen gebaseerde runtimebibliotheek waarmee u de latente prestaties van multi-coreprocessors kunt benutten.
    Met oneTBB kunt u parallel programmeren vereenvoudigen door berekeningen op te splitsen in parallel lopende taken.
  • Binnen een enkel proces wordt parallellisme uitgevoerd via threads, een besturingssysteemmechanisme waarmee dezelfde of verschillende sets instructies tegelijkertijd kunnen worden uitgevoerd.
  • Hier ziet u een van de mogelijke uitvoeringen van taken via threads.intel-oneAPI-Threading-Building-Blocks-FIG-1

Gebruik één tabblad om schaalbare applicaties te schrijven die:

  • Geef een logische parallelle structuur op in plaats van threads
  • Benadruk data-parallel programmeren
  • Profiteer ervantage van gelijktijdige verzamelingen en parallelle algoritmen
  • oneTBB ondersteunt genest parallellisme en taakverdeling. Het betekent dat u de bibliotheek kunt gebruiken zonder dat u zich zorgen hoeft te maken dat u een systeem te veel abonneert. oneTBB is beschikbaar als zelfstandig product en als onderdeel van de Intel® oneAPI Base Toolkit.

Systeemvereisten

  • Raadpleeg de oneTBB-systeemvereisten.

Download Intel(R) oneAPI Threading-bouwstenen (oneTBB)

  • Download oneTBB als zelfstandig product of als onderdeel van de Intel(R) oneAPI Base Toolkit. Zie Installatiehandleiding voor een zelfstandige versie (Windows* OS en Linux* OS) en Intel(R) oneAPI Toolkits Installatiehandleiding.
Voordat u begint

Na het installeren van oneTBB moet u de omgevingsvariabelen instellen:

  1. Ga naar de oneTBB-installatiemap ( ). Standaard, is de volgende:
    1. Op Linux* besturingssysteem:
    2. Voor supergebruikers (root): /opt/intel/Konami
    3. Voor gewone gebruikers (niet-root): $HOME/intel/Konami
    4. Op Windows* besturingssysteem:
    5. <Program Files>\Intel\oneAPI
  2. Stel de omgevingsvariabelen in met behulp van het script in , door rennen
    • Op Linux* besturingssysteem: vars.{sh|csh} in /tbb/nieuwste/env
    • Op Windows* besturingssysteem: vars.bat in /tbb/nieuwste/env

Example
Hieronder vind je een typische example voor een oneTBB-algoritme. De sample berekent een som van alle gehele getallen van 1 tot 100.intel-oneAPI-Threading-Building-Blocks-FIG-2

oneAPI Threading Building Blocks (oneTBB) en pkg-config-tool

  • De pkg-config tool wordt gebruikt om de compilatieregel te vereenvoudigen door informatie over pakketten op te halen uit
    speciale metagegevens fileS. Het helpt grote, hardgecodeerde paden te vermijden en maakt compilatie draagbaarder.

Compileer een programma met pkg-config

  • Om een ​​testprogramma test.cpp met oneTBB op Linux* OS en macOS* te compileren, geeft u het volledige zoekpad op, include files en bibliotheken, of geef een eenvoudige regel als deze:intel-oneAPI-Threading-Building-Blocks-FIG-3

Waar:

  • cflags biedt een oneTBB-bibliotheek inclusief pad:intel-oneAPI-Threading-Building-Blocks-FIG-4
  • libs levert de Intel(R) oneTBB-bibliotheeknaam en het zoekpad om deze te vinden:intel-oneAPI-Threading-Building-Blocks-FIG-4
  • OPMERKING Gebruik voor Windows* OS bovendien de –msvc-syntaxisoptievlag die de compileer- en koppelingsvlaggen in een geschikte modus converteert.
Vind meer
  • éénTBB Gemeenschapsforum
  • Veelgestelde vragen over producten
  • Ondersteuningsverzoeken
  • Gebruik deze bronnen als u ondersteuning nodig heeft bij oneTBB.
  • Release-opmerkingen Vind actuele informatie over het product, inclusief gedetailleerde opmerkingen, bekende problemen en wijzigingen.
  • Documentatie: Handleiding voor ontwikkelaars en API-referentie
  • Leer oneTBB gebruiken.
  • GitHub* Vind oneTBB-implementatie in open source.

Kennisgevingen en disclaimers

  • Voor Intel-technologieën is mogelijk geactiveerde hardware, software of serviceactivering vereist.
  • Geen enkel product of onderdeel kan absoluut veilig zijn.
  • Uw kosten en resultaten kunnen variëren.
  • © Intel Corporation. Intel, het Intel-logo en andere Intel-merken zijn handelsmerken van Intel Corporation of haar dochterondernemingen. Andere namen en merken kunnen worden geclaimd als eigendom van anderen.
  • Er wordt met dit document geen licentie (expliciet of impliciet, door uitsluiting of anderszins) op intellectuele eigendomsrechten verleend.
  • De beschreven producten kunnen ontwerpfouten of fouten bevatten, bekend als errata, waardoor het product kan afwijken van de gepubliceerde specificaties. Actuele gekarakteriseerde errata zijn op aanvraag verkrijgbaar.
  • Intel wijst alle expliciete en impliciete garanties af, inclusief maar niet beperkt tot de impliciete garanties van verkoopbaarheid, geschiktheid voor een bepaald doel en niet-inbreuk, evenals enige garantie die voortvloeit uit prestatie, handelswijze of gebruik in de handel.

Installeer oneTBB op Windows* besturingssysteem

  • In deze sectie wordt beschreven hoe u de oneAPI Threading Building Blocks (oneTBB)-bibliotheek op een Windows* OS-machine kunt implementeren.
  • Als u van plan bent oneTBB te installeren als onderdeel van Intel® oneAPI Base Toolkit, raadpleeg dan het overeenkomstige gedeelte van de Intel(R) oneAPI Toolkits Installatiehandleiding.
  • Als u van plan bent oneTBB als een zelfstandig product te installeren, volgt u de onderstaande instructies met behulp van de GUI van het installatieprogramma of een pakketbeheerder van uw keuze.
  • Leer hoe u oneTBB installeert met GUI en pakketbeheerder: * Installeren met GUI * Installeren met pakketbeheerder

Installeer met GUI

Stap 1. Selecteer het gewenste installatieprogramma

  1. Ga naar de downloadpagina. Er wordt een lijst met beschikbare installatieprogramma's weergegeven.
  2. Bepaal welk type Windows-installatieprogramma u gaat gebruiken:
    • Online installatieprogramma heeft een kleinere file grootte, maar vereist een permanente internetverbinding tijdens het hardlopen.
    • Offline installatieprogramma heeft een groter file grootte, maar vereist alleen een internetverbinding om het installatieprogramma te downloaden fileen wordt vervolgens offline uitgevoerd.
  3. Nadat u het type installatieprogramma hebt gekozen, klikt u op de bijbehorende link om de download te starten.
  4. Wacht tot het downloaden voltooid is.

Stap 2. Bereid het installatieprogramma voor

Voor offline installatieprogramma's:

  1. Voer de .exe . uit file je hebt gedownload. De extractor van het installatiepakket wordt gestart.
  2. Geef het pad op waar het pakket moet worden uitgepakt – standaard is C:\Users\ \Downloads\w_tbb_oneapi_p_ _offline.
  3. Selecteer indien nodig de optie Tijdelijk uitgepakt verwijderen files na installatie selectievakje.
  4. Klik op Uitpakken.
    Voor het online installatieprogramma start de download automatisch nadat u het .exe-bestand hebt uitgevoerd file.

Stap 3. Voer de installatie uit

  1. Als u het offline installatieprogramma gebruikt, klikt u op Doorgaan om door te gaan. Het online installatieprogramma gaat automatisch verder.
  2. Schakel in de stap Samenvatting het selectievakje Ik accepteer de voorwaarden van de licentieovereenkomst in.
  3. Selecteer de installatiemodus:
  • Als u de standaardinstallatie-instellingen wilt gebruiken, selecteert u Aanbevolen installatie. oneTBB wordt geïnstalleerd op de standaardlocatie: %Program FIles (x86)%\Intel\oneAPI\. Klik op Doorgaan en ga verder met de stap IDE integreren.
  • Om de installatie-instellingen te wijzigen, selecteert u Aangepaste installatie en klikt u op Aanpassen. U gaat verder met de stap Componenten selecteren. Er kunnen echter geen andere componenten dan éénTBB worden geselecteerd vanwege de aard van de oplossing. In deze modus kunt u de standaardinstallatielocatie wijzigen door linksonder in het venster op Wijzigen te klikken.intel-oneAPI-Threading-Building-Blocks-FIG-5
  1. Bij de stap IDE integreren controleert het programma of het mogelijk is om oneTBB volledig geïntegreerd met Microsoft Visual Studio IDE te implementeren. Daarvoor moet de ondersteunde IDE-versie op de doelcomputer zijn geïnstalleerd. Als dit nog niet is geïnstalleerd, kunt u de installatie afsluiten en opnieuw opstarten nadat u de IDE hebt geïnstalleerd, of doorgaan zonder integratie.
  2. Bij de stap Softwareverbeteringsprogramma selecteert u de gewenste optie. Klik vervolgens op Installeren om de installatie te starten.
  3. Wacht tot het proces is voltooid. Klik vervolgens op Voltooien om het installatieprogramma te sluiten of ga naar Geïnstalleerde producten om te controleren op updates of andere acties te ondernemen.

OPMERKING Vergeet niet om omgevingsvariabelen na de installatie te configureren. Zie het gedeelte Voordat u begint voor meer informatie.

Installeer met een pakketbeheerder

  • Om oneTBB te installeren met een pakketbeheerder, voert u de overeenkomstige opdracht uit die wordt beschreven in de documentatie:
  • Conda
  • Pip
  • NuGet
  • OPMERKING Vergeet niet om omgevingsvariabelen na de installatie te configureren. Zie het gedeelte Voordat u begint voor meer informatie.

OneTBB upgraden

  • De naadloze upgrade wordt ondersteund voor oneTBB 2021.1 en latere versies. Om oneTBB naar de nieuwste versie te upgraden, voert u de installatie uit, zoals hierboven beschreven.
  • Als u vroeger met oudere versies (TBB) werkte, houd er dan rekening mee dat de nieuwe versies van oneTBB geen achterwaartse compatibiliteit bieden. Zie TBB dsamp: Achtergrond, wijzigingen en modernisering voor details. Zie ook
  • Migreren van TBB voor meer informatie over migreren naar oneTBB.

OneTBB verwijderen

  • Om oneTBB te verwijderen, gebruikt u Toepassingen en onderdelen of Programma's en onderdelen.

Installeer oneTBB op Linux* besturingssysteem

  • In deze sectie wordt beschreven hoe u de oneAPI Threading Building Blocks (oneTBB)-bibliotheek op een Linux*-machine kunt implementeren. Kies de gewenste manier:
  • Installeer oneTBB via de opdrachtregel
  • Installeer oneTBB met behulp van pakketbeheerders naar keuze:
  • Conda
  • APT
  • LEKKER
  • PIP
  • NuGet
  • OPMERKING U kunt ook één TB op een Linux* OS-machine installeren met behulp van GUI. Zie Intel(R) oneAPI Installatiehandleiding voor meer informatie.

Installeer oneTBB via de opdrachtregel

  • Om oneTBB te installeren, voert u een van de volgende opdrachten uit, afhankelijk van uw rol:
  • wortel:intel-oneAPI-Threading-Building-Blocks-FIG-6
  • gebruiker:intel-oneAPI-Threading-Building-Blocks-FIG-7

Waar:

  • stil – Voer het installatieprogramma uit in de niet-interactieve (stille) modus.
  • eula – Accepteer of weiger Eindgebruikerslicentieovereenkomst (EULA), ondersteunde waarden: accepteren of weigeren (standaard).
  • componenten – Laat u op maat geïnstalleerde componenten.

Bijvoorbeeldampon:intel-oneAPI-Threading-Building-Blocks-FIG-8

Installeer oneTBB met behulp van pakketbeheerders

  • Volg de instructies met behulp van een pakketbeheerder naar keuze.

Conda

  • In dit gedeelte vindt u algemene instructies voor het installeren van de oneAPI Threading Building Blocks (oneTBB) via de
  • Conda* pakketbeheerder. Raadpleeg de Conda-documentatie voor aanvullende installatie-opmerkingen.
  • Om oneTBB te installeren, voert u de volgende opdracht uit:intel-oneAPI-Threading-Building-Blocks-FIG-9
  • Je kunt ook gebruiken: conda install -c intel/label/intel tbb-devel
  • OPMERKING Zie Intel(R) oneAPI Installatiehandleiding voor informatie over het configureren van Conda.

APT

  • Om oneTBB te installeren met APT*, voert u het volgende uit:intel-oneAPI-Threading-Building-Blocks-FIG-10
  • Bijvoorbeeldampon:

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

OPMERKING Zie Intel(R) oneAPI Installatiehandleiding voor meer informatie over het configureren van YUM.

Om oneTBB te installeren met PIP*, voer je het volgende uit:intel-oneAPI-Threading-Building-Blocks-FIG-14

Bijvoorbeeldampon:

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

NuGet

Ga als volgt te werk om oneTBB vanaf NuGet* te installeren via de opdrachtregel:

  1. Ga naar nuget.org
  2. Loop:intel-oneAPI-Threading-Building-Blocks-FIG-16

OPMERKING Zie Intel(R) oneAPI Installatiehandleiding voor informatie over het configureren van NuGet*.
OPMERKING Vergeet niet om omgevingsvariabelen na de installatie te configureren. Zie het gedeelte Voordat u begint voor meer informatie.

OneTBB upgraden
  • De naadloze upgrade wordt ondersteund voor oneTBB 2021.1 en latere versies. Om oneTBB naar de nieuwste versie te upgraden, voert u de installatie uit, zoals hierboven beschreven.
  • Als u vroeger met oudere versies (TBB) werkte, houd er dan rekening mee dat de nieuwe versies van oneTBB geen achterwaartse compatibiliteit bieden. Zie TBB dsamp: Achtergrond, wijzigingen en modernisering voor details. Raadpleeg ook Migreren vanuit TBB voor meer informatie over het migreren naar één TB.

Documenten / Bronnen

intel oneAPI Threading-bouwstenen [pdf] Gebruikershandleiding
oneAPI Bouwstenen inpassen, Bouwstenen inpassen, Bouwstenen, Blokken

Referenties

Laat een reactie achter

Uw e-mailadres wordt niet gepubliceerd. Verplichte velden zijn gemarkeerd *