intel oneAPI Threading Building Blocks

Produktinformation

én API Threading Building Blocks (én TB)

oneAPI Threading Building Blocks (oneTBB) er en runtime-baseret parallel programmeringsmodel for C++-kode, der bruger tråde. Det er et skabelonbaseret runtime-bibliotek designet til at hjælpe med at udnytte den latente ydeevne af multi-core processorer. oneTBB forenkler parallel programmering ved at opdele beregning i parallelle kørende opgaver. Parallelisme udføres inden for en enkelt proces gennem tråde, en operativsystemmekanisme, der gør det muligt at udføre de samme eller forskellige sæt instruktioner samtidigt.

oneTBB kan downloades som et selvstændigt produkt eller som en del af Intel(R) oneAPI Base Toolkit. Produktet leveres med et sæt systemkrav, som skal opfyldes før installation.

Systemkrav

• Se oneTBB-systemkravene.

Installation

• Download oneTBB som et selvstændigt produkt eller som en del af Intel(R) oneAPI Base Toolkit.
• Se installationsvejledningen for en selvstændig version (Windows* OS og Linux* OS) og Intel(R) oneAPI Toolkits Installationsvejledning.

Brugsvejledning

• • Efter installation af oneTBB skal du indstille miljøvariablerne ved at gå til oneTBB installationsmappen. Som standard er installationsmappen som følger:

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

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

• • Kompiler et program ved hjælp af oneTBB på Linux* OS og macOS* ved hjælp af pkg-config-værktøjet. Angiv den fulde vej til at søge efter inklusive files og biblioteker, eller angiv en simpel linje som denne:

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

• For Windows* OS skal du desuden bruge -msvc-syntax-indstillingsflaget, der konverterer kompilerings- og sammenkædningsflag i en passende tilstand.
• Se udviklervejledningen og API-referencen på GitHub for detaljerede noter, kendte problemer og ændringer.

Kom godt i gang med én API Threading Building Blocks (én TB)

• oneAPI Threading Building Blocks (oneTBB) er en runtime-baseret parallel programmeringsmodel for C++-kode, der bruger tråde. Den består af et skabelonbaseret runtime-bibliotek for at hjælpe dig med at udnytte den latente ydeevne af multi-core processorer.
  oneTBB giver dig mulighed for at forenkle parallel programmering ved at opdele beregninger i parallelle kørende opgaver.
• Inden for en enkelt proces udføres parallelisme gennem tråde, en operativsystemmekanisme, der gør det muligt at udføre de samme eller forskellige sæt instruktioner samtidigt.
• Her kan du se en af ​​de mulige udførelser af opgaver efter tråde.

Brug én fane til at skrive skalerbare applikationer, der:

• Angiv logisk parallel struktur i stedet for tråde
• Læg vægt på dataparallel programmering
• Tag advantage af samtidige samlinger og parallelle algoritmer
• oneTBB understøtter indlejret parallelisme og belastningsbalancering. Det betyder, at du kan bruge biblioteket uden at være bekymret for at overabonnere et system. oneTBB er tilgængelig som et selvstændigt produkt og som en del af Intel® oneAPI Base Toolkit.

Systemkrav

• Se oneTBB-systemkravene.

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

• Download oneTBB som et selvstændigt produkt eller som en del af Intel(R) oneAPI Base Toolkit. Se installationsvejledningen for en stand-alone version (Windows* OS og Linux* OS) og Intel(R) oneAPI Toolkits Installationsvejledning.

Før du begynder

Efter installation af oneTBB, skal du indstille miljøvariablerne:

1. Gå til oneTBB installationsmappen ( ). Som standard, er følgende:
   1. På Linux* OS:
   2. For superbrugere (root): /opt/intel/Konami
   3. For almindelige brugere (ikke-root): $HOME/intel/Konami
   4. På Windows* OS:
   5. <Program Files>\Intel\oneAPI
2. Indstil miljøvariablerne ved hjælp af scriptet i , ved at løbe
   • På Linux* OS: vars.{sh|csh} in /tbb/nyeste/env
   • På Windows* OS: vars.bat i /tbb/nyeste/env

Example
Nedenfor kan du finde et typisk example for en oneTBB-algoritme. sample beregner summen af ​​alle heltal fra 1 til 100.

oneAPI Threading Building Blocks (oneTBB) og pkg-config værktøj

• Pkg-config-værktøjet bruges til at forenkle kompileringslinjen ved at hente information om pakker fra
  særlige metadata files. Det hjælper med at undgå store hårdkodede stier og gør kompilering mere bærbar.

Kompiler et program ved hjælp af pkg-config

• For at kompilere et testprogram test.cpp med oneTBB på Linux* OS og macOS* skal du angive den fulde sti til at søge efter inkl. files og biblioteker, eller angiv en simpel linje som denne:

Hvor:

• cflags leverer oneTBB-bibliotek inklusive sti:
• libs angiver Intel(R) oneTBB-biblioteksnavnet og søgestien for at finde det:
• NOTE For Windows* OS skal du desuden bruge -msvc-syntax-indstillingsflaget, der konverterer kompilerings- og sammenkædningsflag i en passende tilstand.

Find mere

• enTBB Fællesskabsforum
• Ofte stillede spørgsmål om produkter
• Supportanmodninger
• Brug disse ressourcer, hvis du har brug for support med oneTBB.
• Release Notes Find opdaterede oplysninger om produktet, herunder detaljerede bemærkninger, kendte problemer og ændringer.
• Dokumentation: Udviklervejledning og API-reference
• Lær at bruge oneTBB.
• GitHub* Find oneTBB-implementering i open source.

Meddelelser og ansvarsfraskrivelser

• Intel-teknologier kan kræve aktiveret hardware, software eller service-aktivering.
• Intet produkt eller komponent kan være helt sikkert.
• Dine omkostninger og resultater kan variere.
• © Intel Corporation. Intel, Intel-logoet og andre Intel-mærker er varemærker tilhørende Intel Corporation eller dets datterselskaber. Andre navne og mærker kan hævdes som andres ejendom.
• Ingen licens (udtrykt eller underforstået, ved estoppel eller på anden måde) til nogen intellektuel ejendomsret er givet af dette dokument.
• De beskrevne produkter kan indeholde designfejl eller fejl kendt som errata, som kan forårsage, at produktet afviger fra offentliggjorte specifikationer. Aktuelle karakteriserede errata er tilgængelige på anmodning.
• Intel fraskriver sig alle udtrykkelige og underforståede garantier, herunder uden begrænsning, underforståede garantier for salgbarhed, egnethed til et bestemt formål og ikke-krænkelse, såvel som enhver garanti, der opstår som følge af ydeevne, handel eller brug i handelen.

Installer oneTBB på Windows* OS

• Dette afsnit beskriver, hvordan du kan implementere oneAPI Threading Building Blocks-biblioteket (oneTBB) på en Windows* OS-maskine.
• Hvis du planlægger at installere oneTBB som en del af Intel® oneAPI Base Toolkit, se det tilsvarende afsnit i Intel(R) oneAPI Toolkits Installation Guide.
• Hvis du planlægger at installere oneTBB som et selvstændigt produkt, skal du følge instruktionerne nedenfor ved at bruge installationsprogrammets GUI eller en pakkehåndtering efter eget valg.
• Lær hvordan du installerer oneTBB med GUI og pakkehåndtering: * Installer med GUI * Installer med en pakkehåndtering

Installer med GUI

Trin 1. Vælg det foretrukne installationsprogram

1. Gå til Download-siden. En liste over tilgængelige installatører vises.
2. Beslut dig for den Windows-installationstype, du vil bruge:
   • Online installatør har en mindre file størrelse, men kræver en permanent internetforbindelse, mens den kører.
   • Offline installationsprogram har en større file størrelse, men kræver kun en internetforbindelse for at downloade installationsprogrammet file, og kører derefter offline.
3. Når du har besluttet dig for installationstypen, skal du klikke på det tilsvarende link for at starte overførslen.
4. Vent på, at overførslen er fuldført.

Trin 2. Forbered installationsprogrammet

For offlineinstallatører:

1. Kør .exe file du har downloadet. Installationspakkeudtrækket vil blive lanceret.
2. Angiv stien, hvor pakken skal udpakkes – standard er C:\Users\ \Downloads\w_tbb_oneapi_p_ _offline.
3. Om nødvendigt skal du vælge Fjern midlertidigt udtrukket files efter installation afkrydsningsfeltet.
4. Klik på Udpak.
   For onlineinstallationsprogrammet starter overførslen automatisk, når du har kørt .exe file.

Trin 3. Kør opsætningen

1. Hvis du kører offline-installationsprogrammet, skal du klikke på Fortsæt for at fortsætte. Onlineinstallationsprogrammet fortsætter automatisk.
2. Marker afkrydsningsfeltet Jeg accepterer vilkårene i licensaftalen i oversigtstrinnet.
3. Vælg installationstilstand:

• For at bruge standardinstallationsindstillinger skal du vælge Anbefalet installation. oneTBB vil blive installeret på standardplaceringen: %Program FIles (x86)%\Intel\oneAPI\. Klik på Fortsæt, og fortsæt til trinnet Integrate IDE.
• For at ændre installationsindstillingerne skal du vælge Custom Installation og klikke på Customize. Du går videre til trinnet Vælg komponenter. Der kan dog ikke vælges andre komponenter end énTBB på grund af opløsningens natur. I denne tilstand kan du ændre standardinstallationsplaceringen ved at klikke på Skift i nederste venstre hjørne af vinduet.

1. Ved Integrate IDE-trinnet tjekker programmet, om det er muligt at implementere oneTBB fuldt integreret med Microsoft Visual Studio IDE – for det skal den understøttede IDE-version være installeret på målmaskinen. Hvis den ikke er installeret, kan du afslutte opsætningen og genstarte den efter installation af IDE, eller fortsætte uden integration.
2. Ved softwareforbedringsprogrammet skal du vælge den mulighed, du foretrækker. Klik derefter på Installer for at starte installationen.
3. Vent på, at processen er fuldført. Klik derefter på Udfør for at lukke installationsprogrammet eller Gå til Installerede produkter for at søge efter opdateringer eller foretage andre handlinger.

NOTE Husk at konfigurere miljøvariabler efter installationen. Se afsnittet Før du begynder for at lære mere om det.

Installer med en Package Manager

• For at installere oneTBB med en pakkehåndtering skal du køre den tilsvarende kommando beskrevet i dokumentationen:
• Conda
• Pip
• NuGet
• NOTE Husk at konfigurere miljøvariabler efter installationen. Se afsnittet Før du begynder for at lære mere om det.

Opgradering af oneTBB

• Den problemfri opgradering understøttes til oneTBB 2021.1 og nyere versioner. For at opgradere oneTBB til den nyeste version skal du køre opsætningen som beskrevet ovenfor.
• Hvis du plejede at arbejde med ældre versioner (TBB), skal du overveje, at de nye versioner af oneTBB ikke giver bagudkompatibilitet. Se TBB Revamp: Baggrund, ændringer og modernisering for detaljer. Se også
• Migrering fra TBB for mere information om migrering til oneTBB.

Afinstallerer oneTBB

• For at afinstallere oneTBB skal du bruge Programmer og funktioner eller Programmer og funktioner.

Installer oneTBB på Linux* OS

• Dette afsnit beskriver, hvordan du kan implementere oneAPI Threading Building Blocks (oneTBB)-biblioteket på en Linux*-maskine. Vælg den foretrukne måde:
• Installer oneTBB ved hjælp af kommandolinjen
• Installer oneTBB med valgfri pakkeadministratorer:
• Conda
• APT
• NAM
• PIP
• NuGet
• NOTE Du kan også installere en TB på en Linux* OS-maskine ved hjælp af GUI. Se Intel(R) oneAPI-installationsvejledningen for at få mere at vide.

Installer oneTBB ved hjælp af kommandolinjen

• For at installere oneTBB skal du køre en af ​​følgende kommandoer i henhold til din rolle:
• rod:
• bruger:

Hvor:

• stille – Kør installationsprogrammet i ikke-interaktiv (lydløs) tilstand.
• eula – Accepter eller afvis slutbrugerlicensaftale (EULA), understøttede værdier: accepter eller afvis (standard).
• komponenter – Lad dig tilpassede installerede komponenter.

F.eksampdet:

Installer oneTBB ved hjælp af Package Managers

• Følg instruktionerne ved at bruge en pakkehåndtering efter eget valg.

Conda

• Dette afsnit giver generelle instruktioner om installation af oneAPI Threading Building Blocks (oneTBB) via
• Conda* pakke manager. For yderligere installationsnotater henvises til Conda-dokumentationen.
• For at installere oneTBB skal du køre følgende kommando:
• Du kan også bruge: conda install -c intel/label/intel tbb-devel
• NOTE Se Intel(R) oneAPI Installation Guide for at lære, hvordan du konfigurerer Conda.

APT

• For at installere oneTBB ved hjælp af APT*, kør:
• F.eksampdet:

NOTE Se Intel(R) oneAPI Installation Guide for at lære, hvordan du konfigurerer YUM.

For at installere oneTBB ved hjælp af PIP*, kør:

F.eksampdet:

NuGet

Gør følgende for at installere oneTBB fra NuGet* ved hjælp af kommandolinjen:

1. Gå til nuget.org
2. Løbe:

NOTE Se Intel(R) oneAPI Installation Guide for at lære, hvordan du konfigurerer NuGet*.
NOTE Husk at konfigurere miljøvariabler efter installationen. Se afsnittet Før du begynder for at lære mere om det.

• Den problemfri opgradering understøttes til oneTBB 2021.1 og nyere versioner. For at opgradere oneTBB til den nyeste version skal du køre opsætningen som beskrevet ovenfor.
• Hvis du plejede at arbejde med ældre versioner (TBB), skal du overveje, at de nye versioner af oneTBB ikke giver bagudkompatibilitet. Se TBB Revamp: Baggrund, ændringer og modernisering for detaljer. Se også Migrering fra TBB for at få flere oplysninger om migrering til én TB.

Dokumenter/ressourcer

intel oneAPI Threading Building Blocks [pdfBrugervejledning oneAPI Threading Building Blocks, Threading Building Blocks, Building Blocks, Blocks

Referencer

• Brugermanual