Intel oneAPI Threading Building Blocks

Upplýsingar um vöru

einn API þráður byggingareiningar (einn TB)

oneAPI Threading Building Blocks (oneTBB) er samhliða forritunarlíkan sem byggir á keyrslutíma fyrir C++ kóða sem notar þræði. Það er sniðmát byggt afturkreistingasafn sem er hannað til að hjálpa til við að virkja dulda frammistöðu fjölkjarna örgjörva. oneTBB einfaldar samhliða forritun með því að skipta útreikningum í samhliða hlaupandi verkefni. Samsvörun er framkvæmd innan eins ferlis í gegnum þræði, stýrikerfiskerfi sem gerir kleift að framkvæma sömu eða mismunandi sett af leiðbeiningum samtímis.

oneTBB er hægt að hlaða niður sem sjálfstæðri vöru eða sem hluta af Intel(R) oneAPI Base Toolkit. Varan kemur með sett af kerfiskröfum sem ætti að uppfylla fyrir uppsetningu.

Kerfiskröfur

• Sjá oneTBB kerfiskröfur.

Uppsetning

• Sæktu oneTBB sem sjálfstæða vöru eða sem hluta af Intel(R) oneAPI Base Toolkit.
• Sjá uppsetningarhandbókina fyrir sjálfstæða útgáfu (Windows* OS og Linux* OS) og Intel(R) oneAPI Toolkits Uppsetningarleiðbeiningar.

Notkunarleiðbeiningar

• • Eftir að oneTBB hefur verið sett upp skaltu stilla umhverfisbreyturnar með því að fara í oneTBB uppsetningarskrána. Sjálfgefið er uppsetningarskráin sem hér segir:

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

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

• • Settu saman forrit með því að nota oneTBB á Linux* OS og macOS* með því að nota pkg-config tólið. Gefðu upp alla leiðina til að leita að þar á meðal files og bókasöfn, eða gefðu upp einfalda línu eins og þessa:

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

• Fyrir Windows* OS, notaðu til viðbótar –msvc-syntax valmöguleikafánann sem breytir samsetningar- og tengifánunum í viðeigandi stillingu.
• Skoðaðu Developer Guide og API tilvísun á GitHub fyrir nákvæmar athugasemdir, þekkt vandamál og breytingar.

Byrjaðu með einni API þráður byggingareiningum (einn TB)

• oneAPI Threading Building Blocks (oneTBB) er samhliða forritunarlíkan sem byggir á keyrslutíma fyrir C++ kóða sem notar þræði. Það samanstendur af sniðmátsbundnu keyrslusafni til að hjálpa þér að virkja dulda frammistöðu fjölkjarna örgjörva.
  oneTBB gerir þér kleift að einfalda samhliða forritun með því að skipta útreikningum í samhliða hlaupandi verkefni.
• Innan eins ferlis fer samhliða fram í gegnum þræði, stýrikerfiskerfi sem gerir kleift að framkvæma sömu eða mismunandi sett af leiðbeiningum samtímis.
• Hér getur þú séð eina af mögulegum framkvæmdum verkefna eftir þráðum.

Notaðu einn flipa til að skrifa skalanleg forrit sem:

• Tilgreindu rökrétta samhliða uppbyggingu í stað þráða
• Leggðu áherslu á gagnasamhliða forritun
• Taktu forskottage af samhliða söfnun og samhliða reiknirit
• oneTBB styður hreiður samsíða og álagsjafnvægi. Það þýðir að þú getur notað bókasafnið án þess að hafa áhyggjur af ofáskrift kerfis. oneTBB er fáanlegt sem sjálfstæð vara og sem hluti af Intel® oneAPI Base Toolkit.

Kerfiskröfur

• Sjá oneTBB kerfiskröfur.

Sæktu Intel(R) oneAPI Threading Building Blocks (oneTBB)

• Sæktu oneTBB sem sjálfstæða vöru eða sem hluta af Intel(R) oneAPI Base Toolkit. Sjá uppsetningarleiðbeiningar fyrir sjálfstæða útgáfu (Windows* OS og Linux* OS) og Intel(R) oneAPI Toolkits Uppsetningarleiðbeiningar.

Áður en þú byrjar

Eftir að oneTBB hefur verið sett upp þarftu að stilla umhverfisbreyturnar:

1. Farðu í oneTBB uppsetningarskrána ( ). Sjálfgefið, er eftirfarandi:
   1. Á Linux* OS:
   2. Fyrir ofurnotendur (rót): /opt/intel/Konami
   3. Fyrir venjulega notendur (ekki rót): $HOME/intel/Konami
   4. Á Windows* OS:
   5. <Program Files>\Intel\oneAPI
2. Stilltu umhverfisbreyturnar með því að nota handritið í , með því að hlaupa
   • Á Linux* OS: vars.{sh|csh} í /tbb/nýjasta/env
   • Á Windows* OS: vars.bat í /tbb/nýjasta/env

Example
Hér að neðan má finna dæmigert fyrrverandiample fyrir einnTBB reiknirit. sample reiknar summan af öllum heiltölum frá 1 til 100.

oneAPI Threading Building Blocks (oneTBB) og pkg-config tól

• Pkg-config tólið er notað til að einfalda samantektarlínuna með því að sækja upplýsingar um pakka frá
  sérstök lýsigögn files. Það hjálpar til við að forðast stórar harðkóðaðar slóðir og gerir samantektina færanlegri.

Settu saman forrit með pkg-config

• Til að setja saman prófunarforrit test.cpp með oneTBB á Linux* OS og macOS*, gefðu upp alla leiðina til að leita að m.a. files og bókasöfn, eða gefðu upp einfalda línu eins og þessa:

Hvar:

• cflags veitir oneTBB bókasafn þar á meðal slóð:
• libs gefa upp Intel(R) oneTBB bókasafnsheitið og leitarslóðina til að finna það:
• ATH Fyrir Windows* OS, notaðu til viðbótar –msvc-syntax valmöguleikafánann sem breytir samsetningar- og tengifánunum í viðeigandi stillingu.

Finndu meira

• einnTBB Samfélagsvettvangur
• Algengar spurningar um vörur
• Stuðningsbeiðnir
• Notaðu þessi úrræði ef þú þarft stuðning með oneTBB.
• Útgáfuskýringar Finndu uppfærðar upplýsingar um vöruna, þar á meðal nákvæmar athugasemdir, þekkt vandamál og breytingar.
• Skjöl: Leiðbeiningar fyrir þróunaraðila og API tilvísun
• Lærðu að nota oneTBB.
• GitHub* Finndu oneTBB útfærslu í opnum uppspretta.

Tilkynningar og fyrirvarar

• Intel tækni kann að þurfa að virkja vélbúnað, hugbúnað eða þjónustu.
• Engin vara eða íhlutur getur verið algerlega öruggur.
• Kostnaður þinn og niðurstöður geta verið mismunandi.
• © Intel Corporation. Intel, Intel lógóið og önnur Intel merki eru vörumerki Intel Corporation eða dótturfélaga þess. Önnur nöfn og vörumerki má gera tilkall til sem eign annarra.
• Ekkert leyfi (beint eða óbeint, með estoppel eða á annan hátt) til neinna hugverkaréttinda er veitt með þessu skjali.
• Vörurnar sem lýst er geta innihaldið hönnunargalla eða villur sem kallast errata sem geta valdið því að varan víki frá birtum forskriftum. Núverandi einkennandi errata eru fáanlegar ef óskað er.
• Intel afsalar sér öllum óbeinum og óbeinum ábyrgðum, þar með talið, án takmarkana, óbeinum ábyrgðum um söluhæfni, hæfni í ákveðnum tilgangi og ekki brot, sem og hvers kyns ábyrgð sem stafar af frammistöðu, viðskiptaferli eða notkun í viðskiptum.

Settu upp oneTBB á Windows* OS

• Þessi hluti lýsir því hvernig þú getur sett upp oneAPI Threading Building Blocks (oneTBB) bókasafnið á Windows* OS vél.
• Ef þú ætlar að setja upp oneTBB sem hluta af Intel® oneAPI Base Toolkit skaltu skoða samsvarandi hluta Intel(R) oneAPI Toolkits uppsetningarhandbókarinnar.
• Ef þú ætlar að setja upp oneTBB sem sjálfstæða vöru skaltu fylgja leiðbeiningunum hér að neðan með því að nota uppsetningarviðmótið eða pakkastjóra að eigin vali.
• Lærðu hvernig á að setja upp oneTBB með GUI og pakkastjóra: * Settu upp með GUI * Settu upp með pakkastjóra

Settu upp með GUI

Skref 1. Veldu valinn uppsetningarforrit

1. Farðu á niðurhalssíðuna. Listi yfir tiltæk uppsetningartæki birtist.
2. Ákveða hvaða Windows uppsetningargerð þú munt nota:
   • Online uppsetningarforrit hefur minni file stærð en krefst varanlegrar nettengingar meðan á keyrslu stendur.
   • Ótengdur uppsetningarforrit hefur stærri file stærð en þarf aðeins nettengingu til að hlaða niður uppsetningarforritinu file, og keyrir síðan án nettengingar.
3. Þegar þú hefur ákveðið uppsetningargerðina skaltu smella á samsvarandi hlekk til að hefja niðurhalið.
4. Bíddu þar til niðurhalinu lýkur.

Skref 2. Undirbúðu uppsetningarforritið

Fyrir uppsetningaraðila án nettengingar:

1. Keyra .exe file þú hefur hlaðið niður. Uppsetningarpakkaútdrátturinn verður ræstur.
2. Tilgreindu slóðina þar sem pakkann er tekin út - sjálfgefið er C:\Users\ \Downloads\w_tbb_oneapi_p_ _ótengdur.
3. Ef nauðsyn krefur, veldu Fjarlægja tímabundið útdrátt files eftir uppsetningu gátreitinn.
4. Smelltu á Útdráttur.
   Fyrir uppsetningarforritið á netinu byrjar niðurhalið sjálfkrafa eftir að þú keyrir .exe file.

Skref 3. Keyrðu uppsetninguna

1. Ef þú ert að keyra offline uppsetningarforritið skaltu smella á Halda áfram til að halda áfram. Uppsetningarforritið á netinu mun halda áfram sjálfkrafa.
2. Í Yfirlitsskrefinu skaltu velja gátreitinn Ég samþykki skilmála leyfissamningsins.
3. Veldu uppsetningarham:

• Til að nota sjálfgefnar uppsetningarstillingar skaltu velja Ráðlagð uppsetning. oneTBB verður sett upp á sjálfgefna staðsetningunni: %Program FIles (x86)%\Intel\oneAPI\. Smelltu á Halda áfram og haltu áfram í samþætta IDE skrefið.
• Til að breyta uppsetningarstillingum, veldu Custom Installation og smelltu á Customize. Þú munt halda áfram í skrefið Veldu íhluti. Hins vegar er ekki hægt að velja aðra íhluti en einnTBB vegna eðlis lausnarinnar. Í þessari stillingu geturðu breytt sjálfgefnum uppsetningarstað með því að smella á Breyta neðst í vinstra horninu í glugganum.

1. Í samþætta IDE skrefinu athugar forritið hvort hægt sé að dreifa oneTBB að fullu samþætt við Microsoft Visual Studio IDE - til þess þarf studdu IDE útgáfan að vera sett upp á markvélinni. Ef það er ekki uppsett geturðu lokað uppsetningunni og endurræst hana eftir að IDE hefur verið sett upp eða haldið áfram án samþættingar.
2. Í skrefinu Software Improvement Program skaltu velja þann valkost sem þú kýst. Smelltu síðan á Install til að hefja uppsetninguna.
3. Bíddu eftir að ferlinu lýkur. Smelltu síðan á Ljúka til að loka uppsetningarforritinu eða Farðu í uppsettar vörur til að leita að uppfærslum eða grípa til annarra aðgerða.

ATH Mundu að stilla umhverfisbreytur eftir uppsetningu. Sjá áður en þú byrjar hlutann til að fræðast um það.

Settu upp með pakkastjóra

• Til að setja upp oneTBB með pakkastjóra skaltu keyra samsvarandi skipun sem lýst er í skjölunum:
• Conda
• Píp
• NuGet
• ATH Mundu að stilla umhverfisbreytur eftir uppsetningu. Sjá áður en þú byrjar hlutann til að fræðast um það.

Uppfærsla á oneTBB

• Óaðfinnanleg uppfærsla er studd fyrir oneTBB 2021.1 og síðari útgáfur. Til að uppfæra oneTBB í nýjustu útgáfuna skaltu keyra uppsetninguna eins og lýst er hér að ofan.
• Ef þú vannst áður með eldri útgáfur (TBB) skaltu íhuga að nýju útgáfurnar af oneTBB veita ekki afturábak eindrægni. Sjá TBB Revamp: Bakgrunnur, breytingar og nútímavæðing fyrir nánari upplýsingar. Einnig vísa til
• Flutningur frá TBB til að fá frekari upplýsingar um flutning yfir í oneTBB.

Fjarlægir oneTBB

• Til að fjarlægja oneTBB skaltu nota Forrit og eiginleikar eða Forrit og eiginleikar.

Settu upp oneTBB á Linux* OS

• Þessi hluti lýsir því hvernig þú getur sett upp oneAPI Threading Building Blocks (oneTBB) bókasafnið á Linux* vél. Veldu valinn leið:
• Settu upp oneTBB með því að nota skipanalínu
• Settu upp oneTBB með því að nota pakkastjóra að eigin vali:
• Conda
• APT
• JAMM
• PIP
• NuGet
• ATH Þú getur líka sett upp einn TB á Linux* OS vél með GUI. Sjá uppsetningarleiðbeiningar Intel(R) oneAPI til að fá frekari upplýsingar.

Settu upp oneTBB með því að nota skipanalínu

• Til að setja upp oneTBB skaltu keyra eina af eftirfarandi skipunum í samræmi við hlutverk þitt:
• rót:
• notandi:

Hvar:

• hljóður – Keyrðu uppsetningarforritið í ógagnvirkri (hljóðlausri) ham.
• eula - Samþykkja eða hafna leyfissamningi notenda (EULA), studd gildi: samþykkja eða hafna (sjálfgefið).
• íhlutir - Leyfðu þér sérsniðnum uppsettum íhlutum.

Til dæmisample:

Settu upp oneTBB með því að nota pakkastjóra

• Fylgdu leiðbeiningunum, notaðu pakkastjóra að eigin vali.

Conda

• Þessi hluti veitir almennar leiðbeiningar um uppsetningu oneAPI Threading Building Blocks (oneTBB) í gegnum
• Conda* pakkastjóri. Fyrir frekari upplýsingar um uppsetningu, sjá Conda skjölin.
• Til að setja upp oneTBB skaltu keyra eftirfarandi skipun:
• Þú getur líka notað: conda install -c intel/label/intel tbb-devel
• ATH Sjá Intel(R) oneAPI Uppsetningarhandbók til að læra hvernig á að stilla Conda.

APT

• Til að setja upp oneTBB með APT* skaltu keyra:
• Til dæmisample:

ATH Sjá Intel(R) oneAPI Uppsetningarhandbók til að læra hvernig á að stilla YUM.

Til að setja upp oneTBB með PIP* skaltu keyra:

Til dæmisample:

NuGet

Til að setja upp oneTBB frá NuGet* með því að nota skipanalínuna, gerðu eftirfarandi:

1. Farðu á nuget.org
2. Hlaupa:

ATH Sjá Intel(R) oneAPI Uppsetningarhandbók til að læra hvernig á að stilla NuGet*.
ATH Mundu að stilla umhverfisbreytur eftir uppsetningu. Sjá áður en þú byrjar hlutann til að fræðast um það.

• Óaðfinnanleg uppfærsla er studd fyrir oneTBB 2021.1 og síðari útgáfur. Til að uppfæra oneTBB í nýjustu útgáfuna skaltu keyra uppsetninguna eins og lýst er hér að ofan.
• Ef þú vannst áður með eldri útgáfur (TBB) skaltu íhuga að nýju útgáfurnar af oneTBB veita ekki afturábak eindrægni. Sjá TBB Revamp: Bakgrunnur, breytingar og nútímavæðing fyrir nánari upplýsingar. Skoðaðu einnig Flutningur frá TBB til að fá frekari upplýsingar um að flytja í einn TB.

Skjöl / auðlindir

Intel oneAPI Threading Building Blocks [pdfNotendahandbók oneAPI þráður byggingareiningar, þráður byggingareiningar, byggingareiningar, blokkir

Heimildir

• Notendahandbók