Aan de slag met Intel®
één API één API Bibliotheek voor gegevensanalyse
Ga aan de slag met Intel® one API one API Data Analytics Library
Intel® oneAPI Data Analytics Library (oneDAL) is een bibliotheek die big data-analyse helpt versnellen door sterk geoptimaliseerde algoritmische bouwstenen te bieden voor alle stages van data-analyse (voorverwerking, transformatie, analyse, modellering, validatie en besluitvorming) in batch-, online- en gedistribueerde verwerkingswijzen. Ga voor algemene informatie over oneDAL naar de officiële oneDAL-pagina.
Voordat u begint
oneDAL is gevestigd in /dal directory waar is de map waarin Intel® oneAPI Base Toolkit is geïnstalleerd.
De huidige versie van oneDAL met SYCL-ondersteuning is beschikbaar voor Linux* en Windows* 64-bit besturingssystemen. De voorgebouwde oneDAL-bibliotheken zijn te vinden in de /dal/ /resist map.
Om meer te weten te komen over de systeemvereisten en de afhankelijkheden die nodig zijn om examples, verwijzen naar de Systeemvereisten pagina.
End-to-end bijvample
Hieronder vindt u een typische gebruiksworkflow voor een oneDAL-algoritme op GPU. De example is bedoeld voor het Principal Component Analysis-algoritme (PCA).
De volgende stappen laten zien hoe u:
- Lees de gegevens uit CSV file
- Voer de trainings- en inferentiebewerkingen voor PCA uit
- Toegang tot tussentijdse resultaten behaald bij de trainingentage
- Voeg de volgende header toe die alle oneDAL-declaraties beschikbaar maakt.
- Maak een SYCL*-wachtrij met de gewenste apparaatkiezer. In dit geval wordt de GPU-selector gebruikt:
const auto wachtrij = sycl::queue{ sycl::gpu_selector{} }; - Aangezien alle oneDAL-declaraties zich in de oneapi::dal-naamruimte bevinden, importeert u voor de beknoptheid alle declaraties uit de oneapi-naamruimte om dal te gebruiken in plaats van oneapi::dal: gebruik naamruimte oneapi;
- Gebruik CSV-gegevensbron om de gegevens uit de CSV te lezen file in een tabel:
const auto data = dal::lezen (wachtrij, dal::csv::gegevensbron{“data.csv”}); - Maak een PCA-descriptor, configureer de parameters ervan en voer het trainingsalgoritme uit op de gegevens die vanuit CSV zijn geladen.
- Druk de geleerde eigenvectoren af:
- Gebruik het getrainde model voor gevolgtrekking om de dimensionaliteit van de gegevens te verminderen:
Ex. bouwen en uitvoerenampde
Voer de volgende stappen uit om examples die de basisgebruiksscenario's demonstreren van één DAL met SYCL-ondersteuning. Ga naar /dal/ en stel vervolgens een omgeving in zoals weergegeven in de examphieronder:
OPMERKING Alle onderstaande inhoud die begint met # wordt beschouwd als commentaar en mag niet met de code worden uitgevoerd.
- Stel de vereiste omgeving in voor één DAL (variabelen zoals CPATH, LIBRARY_PATH en LD_LIBRARY_PATH):
• Op Linux zijn er twee mogelijke manieren om de vereiste omgeving in te richten: via vars.sh script of via module files.
• Eén DAL-omgeving opzetten via vars.sh-script Voer de volgende opdracht uit:
bron ./env/vars.sh
• Inrichten van één DAL-omgeving via module files
Initialiseren1. modules: bron $MODULESHOME/infit/bash
OPMERKING Raadpleeg de documentatie over Omgevingsmodules voor meer informatie.
Zorg voor2. modules met een pad naar de module files map: module
gebruik ./module files
Voer de3.module uit:
module belasting dal
• Voer in Windows de volgende opdracht uit:
/env/vars.bat - Kopieer ./examples/neap/dip indien nodig naar een beschrijfbare map (aangezien het tijdelijke fileS):
cp r ./examples/oneapi/dpc ${WRITABLE_DIR} - Stel de compileromgeving in voor Intel® one API DPC++/C++ Compiler. Zien Aan de slag met Intel® oneAPI DPC++/C++ Compiler voor meer informatie.
- Bouw en run de examples die laten zien hoe je een DAL gebruikt met SYCL ondersteuning:
OPMERKING U moet schrijfrechten hebben voor de examples map om ex te bouwenamples, en voer machtigingen uit om ze uit te voeren. Anders moet u examples/oneapi/dpc en examples/oneapi/data naar de map met de juiste machtigingen. Deze twee mappen moeten ten opzichte van elkaar op hetzelfde directoryniveau worden bewaard.
• Op Linux:
• Op Windows:
- Typ make on Linux* of unmake on Windows* om alle beschikbare parameters van de buildprocedure te zien.
De resulterende example binaries en log files worden weggeschreven naar de map _results.
OPMERKING Je zou de ex moeten runnenamples van exampmap les/oneapi/dpc, niet uit de map _results. De meeste exampbestanden vereisen dat gegevens worden opgeslagen in examples/oneapi/data map en om er een relatieve link naar te hebben, begon vanaf exampmap les/oneapi/dip.
U kunt traditionele C ++ examples in examples/oneapi/cup op een vergelijkbare manier.
Compileer en bouw applicaties met pkg-config
De tool pkg-config is een veelgebruikte tool voor het bouwen van software met afhankelijkheden. Intel® one API Data Analytics Library biedt files met pug-config metadata voor het compileren en koppelen van een applicatie aan de bibliotheek.
Stel de omgeving in
Om pug-config te gebruiken, bouwt u de bibliotheek en stelt u vervolgens de omgeving in met behulp van vars.sh- of vars.bat-scripts:
- Op Linux: bron ./env/vars.sh
- Op Windows: /env/vars.bat
Kies een metadata file
de metagegevens files geleverd door één DAL dekken alleen hostapparaatconfiguratie op 64-bits Linux, macOS of Windows-besturingssysteem voor C++.
Kies de metagegevens file gebaseerd op één DAL-threadingmodus en koppelingsmethode die u gebruikt:
één DAL pug-config metadata files
| Single-threaded (niet-threaded) | Multi-threaded (intern schroefdraad) | |
| Statische koppeling | dal-statische-sequentiële-host | dal-statische-threading-host |
| Dynamische koppeling | dal-dynamische-sequentiële-host | dal-dynamische-threading-host |
Compileer een programma met behulp van peg-config
Om een test.cpp-programma te compileren met één DAL en peg-config, geeft u de naam op van de ene DAL pug-config-metadata file als invoerparameter. Voor bijvampon:
- Op Linux of macOS:
ijs test.cpp pug-config –flags –libs dal-dynamic-threading-host - Op Windows:
voor /F “delimbs=,” %i in ('pug-config –flags –libs dal-dynamic-threading-host) doe icl test.cpp %i
Alsample code voor svm_two_class_thunder_dense_batch example met SYCL-ondersteuning. Voer het volgende uit vanaf het exampmap les/oneapi/cpp: - Op Linux of macOS:
icc -I source/ source/svm/svm_two_class_thunder_dense_batch.cpp icc test.cpp pkg-config –cflags –libs dal-dynamische-threading-host - Op Windows:
for /F “delis=,” %i in ('peg-config –flags –libs dal-dynamic-threading-host) do ill -I source/ ill svm_two_class_thunder_dense_batch.cpp %i
Vind meer
| Document | Beschrijving |
| Handleiding en referentie voor ontwikkelaars | Raadpleeg een DAL Developer Guide and Reference voor gedetailleerde informatie over geïmplementeerde algoritmen. |
| Systeemvereisten | Controleer de systeemvereisten voordat u Intel® one API installeert Bibliotheek voor gegevensanalyse. |
| Release-opmerkingen | Raadpleeg de releaseopmerkingen voor Intel® one API Data Analytics Bibliotheek voor meer informatie over nieuwe updates in de nieuwste release. |
| S-codeampde | Leer hoe u één DAL gebruikt met daal4py, een Python* API. |
| één DAL-specificatie | Meer informatie over vereisten voor implementaties van één API Bibliotheek voor gegevensanalyse. |
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 die bekend staan als errata, waardoor het product kan afwijken van de gepubliceerde specificaties. Actuele gekarakteriseerde errata zijn op aanvraag beschikbaar.
Intel wijst alle uitdrukkelijke en impliciete garanties af, inclusief maar niet beperkt tot de impliciete garanties van verkoopbaarheid, geschiktheid voor een bepaald doel en niet-inbreuk, evenals elke garantie die voortvloeit uit de uitvoering, handelswijze of gebruik in de handel.
Documenten / Bronnen
 |
intel Aan de slag met oneAPI oneAPI Data Analytics Library [pdf] Gebruikershandleiding Aan de slag met oneAPI oneAPI Data Analytics Library, Aan de slag met oneAPI oneAPI Data Analytics Library, Analytics Library |
