Kom igång med Intel®
ett API ett API Dataanalysbibliotek
Kom igång med Intel® one API one API Data Analytics Library
Intel® oneAPI Data Analytics Library (oneDAL) är ett bibliotek som hjälper till att påskynda big data-analys genom att tillhandahålla mycket optimerade algoritmiska byggstenar för allatagdataanalyser (förbearbetning, transformation, analys, modellering, validering och beslutsfattande) i batch-, online- och distribuerade beräkningslägen. För allmän information om oneDAL, besök oneDAL officiella sida.
Innan du börjar
oneDAL ligger i /dal katalog var är katalogen där Intel® oneAPI Base Toolkit installerades.
Den nuvarande versionen av oneDAL med SYCL-stöd är tillgänglig för Linux* och Windows* 64-bitars operativsystem. De förbyggda oneDAL-biblioteken finns i /dal/ /resist-katalogen.
Att lära sig om systemkraven och de beroenden som behövs för att bygga examples, se Systemkrav sida.
End-to-end Example
Nedan kan du hitta ett typiskt arbetsflöde för en oneDAL-algoritm på GPU. Exetample tillhandahålls för Principal Component Analysis-algoritm (PCA).
Följande steg visar hur man:
- Läs data från CSV file
- Kör tränings- och slutledningsoperationerna för PCA
- Få tillgång till mellanresultat erhållna på utbildningentage
- Inkludera följande rubrik som gör alla oneDAL-deklarationer tillgängliga.
- Skapa en SYCL*-kö med önskad enhetsväljare. I det här fallet används GPU-väljaren:
const auto queue = sycl::queue{ sycl::gpu_selector{} }; - Eftersom alla oneDAL-deklarationer finns i oneapi::dal-namnområdet, importera alla deklarationer från oneapi-namnområdet för att använda dal istället för oneapi::dal för korthetens skull: använd namnutrymmet oneapi;
- Använd CSV-datakällan för att läsa data från CSV-filen file in i en tabell:
const auto data = dal::read (kö, dal::csv::datakälla{“data.csv”}); - Skapa en PCA-deskriptor, konfigurera dess parametrar och kör träningsalgoritmen på data som laddas från CSV.
- Skriv ut de inlärda egenvektorerna:
- Använd den tränade modellen för slutledning för att minska dimensionaliteten hos datan:
Bygg och kör Examples
Utför följande steg för att bygga och köra exampfiler som visar de grundläggande användningsscenarionerna för en DAL med SYCL-stöd. Gå till /dal/ och ställ sedan in en miljö som visas i exampnedan:
NOTERA Allt innehåll nedan som börjar med # betraktas som en kommentar och bör inte köras med koden.
- Ställ in den miljö som krävs för en DAL (variabler som CPATH, LIBRARY_PATH och LD_LIBRARY_PATH):
• På Linux finns det två möjliga sätt att ställa in den miljö som krävs: via vars.sh-skript eller via modul files.
• Konfigurera en DAL-miljö via vars.sh-skript Kör följande kommando:
källa ./env/vars.sh
• Konfigurera en DAL-miljö via modul files
Initiera 1. moduler: källa $MODULESHOME/infit/bash
NOTERA Se miljömodulernas dokumentation för detaljer.
Ge 2. moduler med en sökväg till modulen files katalog: modul
använd ./modul files
Kör 3.modulen:
modullast dal
• På Windows, kör följande kommando:
/env/vars.bat - Kopiera ./examples/neap/dip till en skrivbar katalog vid behov (eftersom den skapar tillfälliga files):
cp r ./examples/oneapi/dpc ${WRITABLE_DIR} - Konfigurera kompilatormiljön för Intel® one API DPC++/C++ Compiler. Ser Kom igång med Intel® oneAPI DPC++/C++-kompilator för detaljer.
- Bygg och kör exetampfiler som visar hur man använder en DAL med SYCL-stöd:
NOTERA Du måste ha skrivbehörighet till exetamples mapp för att bygga exampfiler och köra behörigheter för att köra dem. Annars måste du kopiera examples/oneapi/dpc och examples/oneapi/data-mappar till katalogen med rätt behörighet. Dessa två mappar måste behållas på samma katalognivå i förhållande till varandra.
• På Linux:
• På Windows:
- För att se alla tillgängliga parametrar för byggproceduren, skriv make on Linux* eller unmake på Windows*.
Det resulterande example binärer och logg files skrivs in i katalogen _results.
NOTERA Du borde köra exetamples från examples/oneapi/dpc-mappen, inte från _results-mappen. De flesta exampfiler kräver att data lagras i examples/oneapi/data-mappen och att ha en relativ länk till den startade från examples/oneapi/dip-mappen.
Du kan bygga traditionella C++ examples som finns i examples/oneapi/cup-mappen på liknande sätt.
Kompilera och bygg applikationer med pkg-config
Verktyget pkg-config är ett flitigt använt verktyg för att bygga programvara med beroenden. Intel® one API Data Analytics Library tillhandahåller files med pug-config-metadata för att kompilera och länka en applikation till biblioteket.
Ställ in miljön
För att använda pug-config, bygg biblioteket och ställ sedan in miljön med vars.sh eller vars.bat skript:
- På Linux: source ./env/vars.sh
- På Windows: /env/vars.bat
Välj en metadata file
Metadata files tillhandahålls av en DAL-omslagsvärdenhetskonfiguration på 64-bitars Linux, macOS eller Windows operativsystem för C++.
Välj metadata file baserat på ett DAL-gängningsläge och länkningsmetod du använder:
en DAL pug-config metadata files
| Enkeltrådig (icke-gängad) | Flertrådig (invändigt gängad) | |
| Statisk länkning | dal-statisk-sekventiell-värd | dal-statisk-gänga-värd |
| Dynamisk länkning | dal-dynamisk-sekventiell-värd | dal-dynamic-threading-host |
Kompilera ett program med peg-config
För att kompilera ett test.cpp-program med en DAL och peg-config, ange namnet på en DAL pug-config-metadata file som en ingångsparameter. Till exempelampde:
- På Linux eller macOS:
ice test.cpp pug-config –flaggor –libs dal-dynamic-threading-host - På Windows:
för /F “delimbs=,” %i in ('pug-config –flags –libs dal-dynamic-threading-host) gör icl test.cpp %i
A sample-kod för svm_two_class_thunder_dense_batch example med SYCL-stöd. Kör följande från exetamples/oneapi/cpp katalog: - På Linux eller macOS:
icc -I source/ source/svm/svm_two_class_thunder_dense_batch.cpp icc test.cpp pkg-config –cflags –libs dal-dynamic-threading-host - På Windows:
för /F “delis=,” %i in ('peg-config –flags –libs dal-dynamic-threading-host) gör illa -I source/ ill svm_two_class_thunder_dense_batch.cpp %i
Hitta mer
| Dokumentera | Beskrivning |
| Utvecklarguide och referens | Se en DAL-utvecklarguide och referens för detaljerad information om implementerade algoritmer. |
| Systemkrav | Kontrollera systemkraven innan du installerar Intel® one API Dataanalysbibliotek. |
| Release Notes | Se versionsinformation för Intel® one API Data Analytics Bibliotek för att lära dig om nya uppdateringar i den senaste utgåvan. |
| Kod Samples | Lär dig hur du använder en DAL med daal4py, ett Python* API. |
| en DAL-specifikation | Läs mer om krav för implementeringar av ett API Dataanalysbibliotek. |
Meddelanden och ansvarsfriskrivningar
Intel-teknologier kan kräva aktiverad maskinvara, programvara eller tjänstaktivering.
Ingen produkt eller komponent kan vara helt säker.
Dina kostnader och resultat kan variera.
© Intel Corporation. Intel, Intels logotyp och andra Intel-märken är varumärken som tillhör Intel Corporation eller dess dotterbolag. Andra namn och varumärken kan göras anspråk på att vara andras egendom.
Ingen licens (uttrycklig eller underförstådd, genom estoppel eller på annat sätt) till några immateriella rättigheter beviljas av detta dokument.
De beskrivna produkterna kan innehålla konstruktionsfel eller fel som kallas errata som kan göra att produkten avviker från publicerade specifikationer. Aktuella karakteriserade errata är tillgängliga på begäran.
Intel frånsäger sig alla uttryckliga och underförstådda garantier, inklusive utan begränsning, underförstådda garantier om säljbarhet, lämplighet för ett visst ändamål och icke-intrång, såväl som alla garantier som uppstår på grund av prestanda, affärer eller användning i handeln.
Dokument/resurser
 |
intel Kom igång med oneAPI oneAPI Data Analytics Library [pdf] Användarhandbok Kom igång med oneAPI oneAPI Data Analytics Library, Kom igång, med oneAPI oneAPI Data Analytics Library, Analytics Library |
