intel oneAPI Threading Konstrublokoj

Produktaj Informoj

unu API Threading Konstrublokoj (unu TB)

oneAPI Threading Building Blocks (oneTBB) estas rultempo-bazita paralela programa modelo por C++-kodo kiu uzas fadenojn. Ĝi estas ŝablon-bazita rultempa biblioteko dizajnita por helpi utiligi la latentan agadon de multkernaj procesoroj. oneTBB simpligas paralelan programadon rompante komputadon en paralelajn kurantajn taskojn. Paralelismo estas efektivigita ene de ununura procezo tra fadenoj, operaciuma mekanismo kiu ebligas la samajn aŭ malsamajn arojn de instrukcioj esti efektivigitaj samtempe.

oneTBB povas esti elŝutita kiel memstara produkto aŭ kiel parto de la Intel(R) oneAPI Baza Ilaro. La produkto venas kun aro de sistemaj postuloj, kiuj devas esti plenumitaj antaŭ instalado.

Sistemaj Postuloj

• Vidu al la OneTBB Sistemaj Postuloj.

Instalado

• Elŝutu oneTBB kiel memstara produkto aŭ kiel parto de la Intel(R) oneAPI Baza Ilaro.
• Referu al la Instala Gvidilo por memstara versio (Vindoza* OS kaj Linukso* OS) kaj Intel(R) oneAPI Toolkits Installation Guide.

Instrukcioj pri Uzado

• • Post instalo de oneTBB, agordu la mediajn variablojn irante al la instala dosierujo de oneTBB. Defaŭlte, la instala dosierujo estas jena:

Por Linukso* OS: /opt/intel/Konami/tab/latest/env/vars.sh

Por Vindozo* OS: %ProgramoFiles(x86)%InteloneAPItbblatestenvvars.bat

• • Kompilu programon uzante oneTBB en Linukso* OS kaj macOS* uzante la ilon pkg-config. Provizu la plenan vojon por serĉi inkluzive files kaj bibliotekoj, aŭ disponigu simplan linion kiel ĉi tio:

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

• Por Vindozo* OS, aldone uzu la –msvc-syntax-opcion flagon kiu konvertas la kompilajn kaj ligajn flagojn en taŭga reĝimo.
• Raportu la Gvidilon por Programistoj kaj API-Referencon en GitHub por detalaj notoj, konataj problemoj kaj ŝanĝoj.

Komencu kun unu API-Treading Building Blocks (unu TB)

• oneAPI Threading Building Blocks (oneTBB) estas rultempo-bazita paralela programa modelo por C++-kodo kiu uzas fadenojn. Ĝi konsistas el ŝablono-bazita rultempa biblioteko por helpi vin utiligi la latentan agadon de multkernaj procesoroj.
  oneTBB ebligas vin simpligi paralelan programadon disigante komputadon en paralelajn kurantajn taskojn.
• Ene de ununura procezo, paralelismo estas efektivigita per fadenoj, operaciuma mekanismo kiu permesas la samajn aŭ malsamajn arojn de instrukcioj esti efektivigitaj samtempe.
• Ĉi tie vi povas vidi unu el la eblaj ekzekutoj de taskoj per fadenoj.

Uzu unu langeton por skribi skaleblajn aplikojn kiuj:

• Specifu logikan paralelan strukturon anstataŭ fadenojn
• Emfazu datu-paralelan programadon
• Prenu antaŭentage de samtempaj kolektoj kaj paralelaj algoritmoj
• oneTBB subtenas nestitan paralelecon kaj ŝarĝbalancadon. Ĝi signifas, ke vi povas uzi la bibliotekon sen zorgi pri troabonado de sistemo. oneTBB estas havebla kiel memstara produkto kaj kiel parto de la Intel® oneAPI Baza Ilaro.

Sistemaj Postuloj

• Vidu al la OneTBB Sistemaj Postuloj.

Elŝutu Intel(R) oneAPI Threading Building Blocks (oneTBB)

• Elŝutu oneTBB kiel memstara produkto aŭ kiel parto de la Intel(R) oneAPI Baza Ilaro. Vidu Instala Gvidilo por memstara versio (Windows* OS kaj Linukso* OS) kaj Intel(R) oneAPI Toolkits Installation Guide.

Antaŭ ol Vi Komencu

Post instalo de oneTBB, vi devas agordi la mediajn variablojn:

1. Iru al la instala dosierujo de oneTBB ( ). Defaŭlte, estas la sekvanta:
   1. Sur Linukso* OS:
   2. Por superuzantoj (radiko): /opt/intel/Konami
   3. Por ordinaraj uzantoj (ne-radikaj): $HOME/intel/Konami
   4. Sur Vindozo* OS:
   5. <Program Files>\Intel\oneAPI
2. Agordu la mediovariablojn, uzante la skripton en , per kurado
   • Sur Linukso* OS: vars.{sh|csh} en /tbb/latest/env
   • Sur Vindozo* OS: vars.bat en /tbb/latest/env

Example
Malsupre vi povas trovi tipan eksample por unuTBB-algoritmo. La sample kalkulas sumon de ĉiuj entjeroj de 1 ĝis 100.

oneAPI Threading Building Blocks (oneTBB) kaj pkg-config ilo

• La ilo pkg-config estas uzata por simpligi la kompillinion per elprenado de informoj pri pakaĵoj
  specialaj metadatenoj files. Ĝi helpas eviti grandajn malmolkodigitajn vojojn kaj faras kompilon pli portebla.

Kompilu programon uzante pkg-config

• Por kompili testprogramon test.cpp kun oneTBB en Linukso* OS kaj macOS*, donu la plenan vojon por serĉi inkluzivi files kaj bibliotekoj, aŭ disponigu simplan linion kiel ĉi tio:

Kie:

• cflags disponigas oneTBB-bibliotekon inkluzive de vojo:
• libs disponigas la Intel(R) oneTBB-bibliotekan nomon kaj la serĉvojon por trovi ĝin:
• NOTO Por Vindozo* OS, aldone uzu la –msvc-syntax-opcion flagon kiu konvertas la kompilajn kaj ligajn flagojn en taŭga reĝimo.

Trovu pli

• unuTBB Komunuma Forumo
• Oftaj Demandoj pri Produkto
• Subtenaj petoj
• Uzu ĉi tiujn rimedojn se vi bezonas subtenon kun oneTBB.
• Eldonaj Notoj Trovu ĝisdatajn informojn pri la produkto, inkluzive detalajn notojn, konatajn problemojn kaj ŝanĝojn.
• Dokumentado: Gvidilo por programistoj kaj API-Referenco
• Lernu uzi oneTBB.
• GitHub* Trovu oneTBB-efektivigon en malferma fonto.

Avizoj kaj Malgarantioj

• Intel-teknologioj povas postuli ebligitan aparataron, programaron aŭ servan aktivigon.
• Neniu produkto aŭ ero povas esti absolute sekuraj.
• Viaj kostoj kaj rezultoj povas varii.
• © Intel Corporation. Intel, la Intel-emblemo kaj aliaj Intel-markoj estas varmarkoj de Intel Corporation aŭ ĝiaj filioj. Aliaj nomoj kaj markoj povas esti postulitaj kiel posedaĵo de aliaj.
• Neniu licenco (esprima aŭ implicita, per malpermeso aŭ alie) al ajnaj intelektaj proprietrajtoj estas donita de ĉi tiu dokumento.
• La priskribitaj produktoj povas enhavi dezajnodifektojn aŭ erarojn konatajn kiel eraroj, kiuj igas la produkton devii de publikigitaj specifoj. Nunaj karakterizitaj eratoj estas haveblaj laŭ peto.
• Intel rifuzas ĉiujn eksplicitajn kaj implicitajn garantiojn, inkluzive de senlime, la implicajn garantiojn de komercebleco, taŭgeco por aparta celo kaj ne-malobservo, same kiel ajnan garantion devenanta de kurso de agado, kurso de komerco aŭ uzado en komerco.

Instalu oneTBB sur Windows* OS

• Ĉi tiu sekcio priskribas kiel vi povas disfaldi la bibliotekon oneAPI Threading Building Blocks (oneTBB) sur Windows* OS-maŝino.
• Se vi planas instali oneTBB kiel parto de Intel® oneAPI Baza Ilaro, raportu al la responda sekcio de la Intel(R) oneAPI Toolkits Installation Guide.
• Se vi planas instali oneTBB kiel memstara produkto, sekvu la instrukciojn malsupre, uzante la instalilon GUI aŭ pakaĵadministrilon laŭ via elekto.
• Lernu kiel instali oneTBB per GUI kaj pakaĵadministrilo: * Instalu per GUI * Instalu per pakaĵadministrilo

Instalu per GUI

Paŝo 1. Elektu la preferatan instalilon

1. Iru al la paĝo Elŝuti. Listo de disponeblaj instaliloj estas montrata.
2. Decidu pri la Vindoza instalilo, kiun vi uzos:
   • Enreta instalilo havas pli malgrandan file grandeco sed postulas konstantan interretan konekton dum funkciado.
   • Senreta instalilo havas pli grandan file grandeco sed postulas interretan konekton nur por elŝuti la instalilon file, kaj poste funkcias eksterrete.
3. Decidinte pri la instalilo, alklaku la respondan ligilon por komenci la elŝuton.
4. Atendu ke la elŝuto finiĝos.

Paŝo 2. Preparu la instalilon

Por senretaj instaliloj:

1. Rulu la .exe file vi elŝutis. La instalado-pakaĵo eltiraĵo estos lanĉita.
2. Specifu la vojon kie ĉerpi la pakaĵon - defaŭlta estas C:\Uzantoj\ \Elŝutoj\w_tbb_oneapi_p_ _senrete.
3. Se necese, elektu la Forigi provizoran eltirita files post instalado markobutono.
4. Klaku Ekstrakti.
   Por la reta instalilo, la elŝuto komenciĝas aŭtomate post kiam vi rulas la .exe file.

Paŝo 3. Rulu la instalinstrukciojn

1. Se vi rulas la senkonektan instalilon, alklaku Daŭrigi por daŭrigi. La reta instalilo procedos aŭtomate.
2. En la Resuma paŝo, elektu la markobutonon Mi akceptas la kondiĉojn de la permesila interkonsento.
3. Elektu la instalan reĝimon:

• Por uzi defaŭltajn instalajn agordojn, elektu Rekomenditan Instaladon. oneTBB estos instalita en la defaŭlta loko: %Programo FIles (x86)%\Intel\oneAPI\. Alklaku Daŭrigi kaj iru al la paŝo de Integri IDE.
• Por modifi instalajn agordojn, elektu Propra Instalado kaj alklaku Agordu. Vi iros al la paŝo Elektu Komponentojn. Tamen, neniuj komponantoj krom oneTBB povas esti elektitaj pro solvnaturo. En ĉi tiu reĝimo, vi povas ŝanĝi la defaŭltan instalan lokon alklakante Ŝanĝi en la malsupra maldekstra angulo de la fenestro.

1. Ĉe la paŝo Integri IDE, la programo kontrolas ĉu eblas disfaldi oneTBB plene integritan kun Microsoft Visual Studio IDE - por tio, la subtenata IDE-versio devas esti instalita sur la cela maŝino. Se ne instalite, vi povas forlasi la aranĝon kaj rekomenci ĝin post instalo de la IDE, aŭ daŭrigi sen integriĝo.
2. Ĉe la paŝo de Programo-Pliboniga Programo, elektu la opcion, kiun vi preferas. Poste alklaku Instali por komenci la instaladon.
3. Atendu, ke la procezo finiĝos. Poste alklaku Fini por fermi la instalilon aŭ Iru al Instalitaj Produktoj por kontroli ĝisdatigojn aŭ fari aliajn agojn.

NOTO Memoru agordi mediajn variablojn post instalado. Vidu la sekcion Antaŭ ol vi komenci por lerni pri ĝi.

Instalu per Paka Administranto

• Por instali oneTBB per pakaĵmanaĝero, rulu la respondan komandon priskribitan en la dokumentaro:
• Conda
• Pip
• NuGet
• NOTO Memoru agordi mediajn variablojn post instalado. Vidu la sekcion Antaŭ ol vi komenci por lerni pri ĝi.

Ĝisdatigante oneTBB

• La senjunta ĝisdatigo estas subtenata por oneTBB 2021.1 kaj postaj versioj. Por ĝisdatigi oneTBB al la plej nova versio, rulu la aranĝon, kiel priskribite supre.
• Se vi kutimis labori kun pli malnovaj versioj (TBB), konsideru, ke la novaj versioj de oneTBB ne provizas retrokongruon. Vidu TBB Revamp: Fono, Ŝanĝoj kaj Modernigo por detaloj. Ankaŭ raportu al
• Migrado de TBB por pliaj informoj pri migrado al oneTBB.

Malinstalante oneTBB

• Por malinstali oneTBB, uzu Aplikojn kaj Trajtojn aŭ Programojn kaj Trajtojn.

Instalu oneTBB sur Linukso* OS

• Ĉi tiu sekcio priskribas kiel vi povas disfaldi la bibliotekon oneAPI Threading Building Blocks (oneTBB) sur Linukso* maŝino. Elektu la preferatan manieron:
• Instalu oneTBB Uzante Komandlinion
• Instalu oneTBB Uzante Pakaj Administrantoj laŭvole:
• Conda
• APT
• JUM
• PIP
• NuGet
• NOTO Vi ankaŭ povas instali unu TB sur Linuksa* OS-maŝino uzante GUI. Vidu Intel(R) oneAPI Instalada Gvidilo por lerni pli.

Instalu oneTBB Uzante Komandlinion

• Por instali oneTBB, rulu unu el la sekvaj komandoj laŭ via rolo:
• radiko:
• uzanto:

Kie:

• silenta – Rulu la instalilon en ne-interaga (silenta) reĝimo.
• eula - Akceptu aŭ malakcepti Finan Uzantan Licencan Interkonsenton (EULA), subtenatajn valorojn: akcepti aŭ malakcepti (defaŭlte).
• komponantoj - Permesu al vi kutimo instalitaj komponantoj.

Por ekzample:

Instalu oneTBB Uzante Pakaj Administrantoj

• Sekvu la instrukciojn, uzante pakaĵadministrilon de via elekto.

Conda

• Ĉi tiu sekcio provizas ĝeneralajn instrukciojn pri instalado de la oneAPI Threading Building Blocks (oneTBB) per la
• Conda* pakadministranto. Por pliaj instal-notoj, raportu al la dokumentado de Conda.
• Por instali oneTBB, rulu la sekvan komandon:
• Vi ankaŭ povas uzi: conda install -c intel/label/intel tbb-devel
• NOTO Vidu Intel(R) oneAPI Instalado-Gvidilon por lerni kiel agordi Conda.

APT

• Por instali oneTBB uzante APT*, rulu:
• Por ekzample:

NOTO Vidu Intel(R) oneAPI Instalada Gvidilo por lerni kiel agordi YUM.

Por instali oneTBB uzante PIP*, rulu:

Por ekzample:

NuGet

Por instali oneTBB de NuGet* uzante la komandlinion, faru la jenon:

1. Iru al nuget.org
2. Kuru:

NOTO Vidu Intel(R) oneAPI Instalado-Gvidilon por lerni kiel agordi NuGet*.
NOTO Memoru agordi mediajn variablojn post instalado. Vidu la sekcion Antaŭ ol vi komenci por lerni pri ĝi.

• La senjunta ĝisdatigo estas subtenata por oneTBB 2021.1 kaj postaj versioj. Por ĝisdatigi oneTBB al la plej nova versio, rulu la aranĝon, kiel priskribite supre.
• Se vi kutimis labori kun pli malnovaj versioj (TBB), konsideru, ke la novaj versioj de oneTBB ne provizas retrokongruon. Vidu TBB Revamp: Fono, Ŝanĝoj kaj Modernigo por detaloj. Ankaŭ, raportu al Migrado de TBB por pliaj informoj pri migrado al unu TB.

Dokumentoj/Rimedoj

intel oneAPI Threading Konstrublokoj [pdf] Uzantogvidilo oneAPI Threading Konstrubrikoj, Threading Konstrubrikoj, Konstruaĵblokoj, Blokoj

Referencoj

• Uzanto Manlibro