intel oneAPI Threading Building Blocks

Tuotetiedot

yksi API Threading Building Blocks (yksi TB)

oneAPI Threading Building Blocks (oneTBB) on runtime-pohjainen rinnakkaisohjelmointimalli C++-koodille, joka käyttää säikeitä. Se on mallipohjainen ajonaikainen kirjasto, joka on suunniteltu valjastamaan moniytimisprosessorien piilevä suorituskyky. oneTBB yksinkertaistaa rinnakkaisohjelmointia jakamalla laskennan rinnakkain suoritettaviin tehtäviin. Rinnakkaisuus toteutetaan yhdessä prosessissa säikeiden kautta, käyttöjärjestelmämekanismi, joka mahdollistaa samojen tai erilaisten käskysarjojen suorittamisen samanaikaisesti.

oneTBB voidaan ladata erillisenä tuotteena tai osana Intel(R) oneAPI Base Toolkit -työkalupakettia. Tuotteen mukana tulee joukko järjestelmävaatimuksia, jotka tulee täyttää ennen asennusta.

Järjestelmävaatimukset

• Katso oneTBB-järjestelmävaatimukset.

Asennus

• Lataa oneTBB erillisenä tuotteena tai osana Intel(R) oneAPI Base Toolkit -työkalupakettia.
• Katso asennusoppaasta erilliset versiot (Windows* OS ja Linux* OS) ja Intel(R) oneAPI Toolkits -asennusopas.

Käyttöohjeet

• • Kun olet asentanut oneTBB:n, aseta ympäristömuuttujat menemällä oneTBB:n asennushakemistoon. Oletuksena asennushakemisto on seuraava:

Linux*-käyttöjärjestelmä: /opt/intel/Konami/tab/latest/env/vars.sh

Windows*-käyttöjärjestelmä: %ProgramFiles(x86)%InteloneAPItbblatestenvvars.bat

• • Kääntää ohjelma oneTBB:tä käyttäen Linux* OS:ssä ja macOS*:ssä pkg-config-työkalulla. Anna täydellinen polku hakuun mukaan lukien files ja kirjastot tai anna yksinkertainen rivi, kuten tämä:

g++ -o testi test.cpp $(pkg-config –libs –liput-välilehti)

• Käytä Windows*-käyttöjärjestelmässä lisäksi -msvc-syntax-valintamerkkiä, joka muuntaa käännös- ja linkitysliput sopivaan tilaan.
• Katso GitHubin kehittäjäoppaasta ja API-viittauksesta yksityiskohtaiset huomautukset, tunnetut ongelmat ja muutokset.

Aloita yhdellä API Threading -rakennuspalikoilla (yksi TB)

• oneAPI Threading Building Blocks (oneTBB) on runtime-pohjainen rinnakkaisohjelmointimalli C++-koodille, joka käyttää säikeitä. Se koostuu mallipohjaisesta ajonaikakirjastosta, jonka avulla voit hyödyntää moniytimisprosessorien piilevää suorituskykyä.
  oneTBB:n avulla voit yksinkertaistaa rinnakkaisohjelmointia jakamalla laskennan rinnakkaisiin tehtäviin.
• Yhdessä prosessissa rinnakkaisuus toteutetaan säikeiden kautta, käyttöjärjestelmämekanismin avulla, joka mahdollistaa samojen tai erilaisten käskysarjojen suorittamisen samanaikaisesti.
• Täällä voit nähdä yhden mahdollisista tehtävien suorittamisesta säikeittäin.

Käytä yhtä välilehteä kirjoittaaksesi skaalautuvia sovelluksia, jotka:

• Määritä looginen rinnakkaisrakenne säikeiden sijaan
• Korosta tietojen rinnakkaista ohjelmointia
• Ota Advantage samanaikaisista kokoelmista ja rinnakkaisista algoritmeista
• oneTBB tukee sisäkkäistä rinnakkaisuutta ja kuormituksen tasapainotusta. Se tarkoittaa, että voit käyttää kirjastoa ilman, että olet huolissasi järjestelmän ylitilauksesta. oneTBB on saatavana erillisenä tuotteena ja osana Intel® oneAPI Base Toolkit -työkalupakettia.

Järjestelmävaatimukset

• Katso oneTBB-järjestelmävaatimukset.

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

• Lataa oneTBB erillisenä tuotteena tai osana Intel(R) oneAPI Base Toolkit -työkalupakettia. Katso asennusoppaasta erillisversio (Windows* OS ja Linux* OS) ja Intel(R) oneAPI Toolkits -asennusopas.

Ennen kuin aloitat

Kun olet asentanut oneTBB:n, sinun on asetettava ympäristömuuttujat:

1. Siirry oneTBB:n asennushakemistoon ( ). Oletuksena, on seuraava:
   1. Linux*-käyttöjärjestelmässä:
   2. Superkäyttäjille (root): /opt/intel/Konami
   3. Tavallisille käyttäjille (ei-root): $HOME/intel/Konami
   4. Windows*-käyttöjärjestelmässä:
   5. <Program Files>\Intel\oneAPI
2. Aseta ympäristömuuttujat käyttämällä komentosarjaa , juoksemalla
   • Linux*-käyttöjärjestelmässä: vars.{sh|csh} sisään /tbb/latest/env
   • Windows*-käyttöjärjestelmässä: vars.bat in /tbb/latest/env

Example
Alta löydät tyypillisen example oneTBB-algoritmille. sample laskee kaikkien kokonaislukujen summan välillä 1-100.

oneAPI Threading Building Blocks (oneTBB) ja pkg-config-työkalu

• pkg-config-työkalua käytetään yksinkertaistamaan käännösriviä hakemalla tietoja paketeista
  erityisiä metatietoja files. Se auttaa välttämään suuria kovakoodattuja polkuja ja tekee kääntämisestä kannettavampaa.

Kääntää ohjelma pkg-configilla

• Jos haluat kääntää testiohjelman test.cpp oneTBB:llä Linux* OS:ssä ja macOS*:ssä, anna täydellinen polku hakua varten include files ja kirjastot tai anna yksinkertainen rivi, kuten tämä:

Jossa:

• cflags tarjoaa yhden TBB-kirjaston, joka sisältää polun:
• libs tarjoaa Intel(R) oneTBB -kirjaston nimen ja hakupolun sen löytämiseksi:
• HUOM Käytä Windows*-käyttöjärjestelmässä lisäksi -msvc-syntax-valintamerkkiä, joka muuntaa käännös- ja linkitysliput sopivaan tilaan.

Etsi lisää

• yksiTBB Yhteisön foorumi
• Tuotteen UKK
• Tukipyynnöt
• Käytä näitä resursseja, jos tarvitset tukea oneTBB:n kanssa.
• Julkaisutiedot Löydä tuoreet tiedot tuotteesta, mukaan lukien yksityiskohtaiset huomautukset, tunnetut ongelmat ja muutokset.
• Dokumentaatio: Kehittäjän opas ja API-viite
• Opi käyttämään oneTBB:tä.
• GitHub* Etsi yksi TBB-toteutus avoimesta lähdekoodista.

Ilmoitukset ja vastuuvapauslausekkeet

• Intel-tekniikat saattavat edellyttää laitteiden, ohjelmistojen tai palveluiden aktivointia.
• Mikään tuote tai komponentti ei voi olla täysin turvallinen.
• Kustannuksesi ja tulokset voivat vaihdella.
• © Intel Corporation. Intel, Intel-logo ja muut Intel-merkit ovat Intel Corporationin tai sen tytäryhtiöiden tavaramerkkejä. Muita nimiä ja merkkejä voidaan väittää muiden omaisuudeksi.
• Tämä asiakirja ei myönnä lisenssiä (suoraan tai epäsuoraan, estoppel tai muutoin) immateriaalioikeuksiin.
• Kuvatuissa tuotteissa voi olla suunnitteluvirheitä tai virheitä, jotka tunnetaan nimellä errata, jotka voivat aiheuttaa tuotteen poikkeamisen julkaistuista teknisistä tiedoista. Nykyiset ominaisvirheet ovat saatavilla pyynnöstä.
• Intel irtisanoutuu kaikista nimenomaisista ja oletetuista takuista, mukaan lukien rajoituksetta oletetut takuut kaupallisuudesta, sopivuudesta tiettyyn tarkoitukseen ja loukkaamattomuudesta, samoin kuin kaikki takuut, jotka johtuvat suorituskyvystä, kaupankäynnistä tai käytöstä kaupassa.

Asenna oneTBB Windows*-käyttöjärjestelmään

• Tässä osassa kuvataan, kuinka voit ottaa käyttöön oneAPI Threading Building Blocks (oneTBB) -kirjaston Windows*-käyttöjärjestelmäkoneessa.
• Jos aiot asentaa oneTBB:n osana Intel® oneAPI Base Toolkitiä, katso vastaavaa osaa Intel(R) oneAPI Toolkits Installation Guide -oppaasta.
• Jos aiot asentaa oneTBB:n erillisenä tuotteena, noudata alla olevia ohjeita käyttämällä asennusohjelman graafista käyttöliittymää tai valitsemaasi paketinhallintaohjelmaa.
• Opi asentamaan oneTBB graafisen käyttöliittymän ja paketinhallinnan avulla: * Asenna graafisella käyttöliittymällä * Asenna paketinhallinnan avulla

Asenna GUI:lla

Vaihe 1. Valitse haluamasi asennusohjelma

1. Siirry lataussivulle. Näyttöön tulee luettelo käytettävissä olevista asentajista.
2. Päätä käyttämäsi Windows-asennusohjelman tyyppi:
   • Online-asennusohjelmassa on pienempi file kokoa, mutta vaatii jatkuvan Internet-yhteyden käytön aikana.
   • Offline-asennusohjelmassa on suurempi file kokoa, mutta vaatii Internet-yhteyden vain asennusohjelman lataamiseen fileja toimii sitten offline-tilassa.
3. Kun olet valinnut asennusohjelman tyypin, aloita lataus napsauttamalla vastaavaa linkkiä.
4. Odota, että lataus on valmis.

Vaihe 2. Valmistele asennusohjelma

Offline-asentajille:

1. Suorita .exe file olet ladannut. Asennuspaketin purkaja käynnistetään.
2. Määritä polku, johon paketti puretaan – oletus on C:\Users\ \Lataukset\w_tbb_oneapi_p_ _offline.
3. Valitse tarvittaessa Poista tilapäisesti purettu files asennuksen jälkeen -valintaruutu.
4. Napsauta Pura.
   Online-asennusohjelmassa lataus alkaa automaattisesti, kun suoritat .exe-tiedoston file.

Vaihe 3. Suorita asennus

1. Jos käytät offline-asennusohjelmaa, jatka napsauttamalla Jatka. Online-asennusohjelma etenee automaattisesti.
2. Valitse Yhteenveto-vaiheessa Hyväksyn käyttöoikeussopimuksen ehdot -valintaruutu.
3. Valitse asennustila:

• Jos haluat käyttää oletusasennuksen asetuksia, valitse Suositeltu asennus. oneTBB asennetaan oletussijaintiin: %Program FIles (x86)%\Intel\oneAPI\. Napsauta Jatka ja jatka vaiheeseen Integroi IDE.
• Jos haluat muokata asennusasetuksia, valitse Mukautettu asennus ja napsauta Mukauta. Siirryt vaiheeseen Valitse komponentit. Ratkaisuluonteen vuoksi ei kuitenkaan voida valita muita komponentteja kuin yksiTBB. Tässä tilassa voit muuttaa oletusasennuspaikkaa napsauttamalla Muuta ikkunan vasemmassa alakulmassa.

1. Integrate IDE -vaiheessa ohjelma tarkistaa, onko mahdollista ottaa OneTBB käyttöön täysin integroituna Microsoft Visual Studio IDE:hen – tätä varten tuettu IDE-versio on asennettava kohdekoneeseen. Jos sitä ei ole asennettu, voit poistua asetuksista ja käynnistää sen uudelleen IDE:n asennuksen jälkeen tai jatkaa ilman integrointia.
2. Valitse Software Improvement Program -vaiheessa haluamasi vaihtoehto. Napsauta sitten Asenna aloittaaksesi asennuksen.
3. Odota prosessin valmistumista. Napsauta sitten Valmis sulkeaksesi asennusohjelman tai Siirry Asennetuihin tuotteisiin tarkistaaksesi päivitykset tai suorittaaksesi muita toimia.

HUOM Muista määrittää ympäristömuuttujat asennuksen jälkeen. Katso Ennen aloittamista -osiosta lisätietoja siitä.

Asenna paketinhallinnan avulla

• Jos haluat asentaa oneTBB:n paketinhallinnan avulla, suorita vastaava dokumentaatiossa kuvattu komento:
• Conda
• Pip
• NuGet
• HUOM Muista määrittää ympäristömuuttujat asennuksen jälkeen. Katso Ennen aloittamista -osiosta lisätietoja siitä.

OneTBB:n päivitys

• Saumaton päivitys on tuettu oneTBB 2021.1 -versiossa ja uudemmissa versioissa. Päivitä oneTBB uusimpaan versioon suorittamalla asennus edellä kuvatulla tavalla.
• Jos olet työskennellyt vanhempien versioiden (TBB) kanssa, ota huomioon, että oneTBB:n uudet versiot eivät tarjoa taaksepäin yhteensopivuutta. Katso TBB Revamp: Tausta, muutokset ja modernisointi lisätietoja varten. Katso myös
• Siirtyminen TBB:stä saadaksesi lisätietoja siirtymisestä oneTBB:hen.

OneTBB:n asennuksen poistaminen

• Voit poistaa oneTBB:n asennuksen käyttämällä Sovellukset ja ominaisuudet tai Ohjelmat ja ominaisuudet.

Asenna oneTBB Linux*-käyttöjärjestelmään

• Tässä osassa kuvataan, kuinka voit ottaa OneAPI Threading Building Blocks (oneTBB) -kirjaston käyttöön Linux*-koneessa. Valitse haluamasi tapa:
• Asenna oneTBB komentorivin avulla
• Asenna oneTBB valitsemallasi paketinhaltijoilla:
• Conda
• APT
• YUM
• PIP
• NuGet
• HUOM Voit myös asentaa yhden TB:n Linux*-käyttöjärjestelmäkoneeseen graafisen käyttöliittymän avulla. Katso lisätietoja Intel(R) oneAPI -asennusoppaasta.

Asenna oneTBB komentorivin avulla

• Asenna oneTBB suorittamalla jokin seuraavista komennoista roolisi mukaan:
• root:
• käyttäjä:

Jossa:

• hiljainen – Suorita asennusohjelma ei-interaktiivisessa (hiljaisessa) tilassa.
• eula - Hyväksy tai hylkää loppukäyttäjän käyttöoikeussopimus (EULA), tuetut arvot: hyväksy tai hylkää (oletus).
• komponentit - Voit asentaa mukautettuja komponentteja.

esimampseuraavat:

Asenna oneTBB Package Managerilla

• Noudata ohjeita käyttämällä valitsemaasi paketinhallintaohjelmaa.

Conda

• Tämä osio sisältää yleiset ohjeet oneAPI Threading Building Blocks (oneTBB) -rakennuspalikoiden asentamiseen
• Conda* pakettipäällikkö. Katso lisää asennusohjeita Condan dokumentaatiosta.
• Asenna oneTBB suorittamalla seuraava komento:
• Voit myös käyttää: conda install -c intel/label/intel tbb-devel
• HUOM Katso Intel(R) oneAPI -asennusoppaasta, kuinka Conda määritetään.

APT

• Asenna oneTBB APT*:lla suorittamalla:
• esimampseuraavat:

HUOM Katso Intel(R) oneAPI -asennusoppaasta, kuinka YUM määritetään.

Asenna oneTBB PIP*:n avulla suorittamalla:

esimampseuraavat:

NuGet

Asenna oneTBB NuGetista* komentorivin avulla seuraavasti:

1. Siirry osoitteeseen nuget.org
2. Juokse:

HUOM Katso Intel(R) oneAPI -asennusoppaasta, kuinka NuGet* määritetään.
HUOM Muista määrittää ympäristömuuttujat asennuksen jälkeen. Katso Ennen aloittamista -osiosta lisätietoja siitä.

• Saumaton päivitys on tuettu oneTBB 2021.1 -versiossa ja uudemmissa versioissa. Päivitä oneTBB uusimpaan versioon suorittamalla asennus edellä kuvatulla tavalla.
• Jos olet työskennellyt vanhempien versioiden (TBB) kanssa, ota huomioon, että oneTBB:n uudet versiot eivät tarjoa taaksepäin yhteensopivuutta. Katso TBB Revamp: Tausta, muutokset ja modernisointi lisätietoja varten. Katso myös Migrating from TBB saadaksesi lisätietoja siirtymisestä yhteen TB:hen.

Asiakirjat / Resurssit

intel oneAPI Threading Building Blocks [pdfKäyttöopas oneAPI kierteitysrakennuspalikat, kierteitysrakennuspalikat, rakennuspalikat, lohkot

Viitteet

• Käyttöopas