Kom i gang med Intel®
ett API ett API Dataanalysebibliotek
Kom i gang med Intel® one API one API Data Analytics Library
Intel® oneAPI Data Analytics Library (oneDAL) er et bibliotek som hjelper til med å øke hastigheten på big data-analyse ved å tilby svært optimaliserte algoritmiske byggesteiner for alletagdataanalyse (forbehandling, transformasjon, analyse, modellering, validering og beslutningstaking) i batch-, online- og distribuerte behandlingsmoduser. For generell informasjon om oneDAL, besøk oneDAL offisielle side.
Før du begynner
oneDAL er lokalisert i /dal katalog hvor er katalogen der Intel® oneAPI Base Toolkit ble installert.
Den gjeldende versjonen av oneDAL med SYCL-støtte er tilgjengelig for Linux* og Windows* 64-biters operativsystemer. De forhåndsbygde oneDAL-bibliotekene finner du i /dal/ /resist-katalogen.
For å lære om systemkravene og avhengighetene som trengs for å bygge eksamples, se Systemkrav side.
Ende-til-ende Eksample
Nedenfor kan du finne en typisk bruksarbeidsflyt for en oneDAL-algoritme på GPU. Eksample er gitt for Principal Component Analysis Algoritm (PCA).
Følgende trinn viser hvordan du:
- Les dataene fra CSV file
- Kjør trenings- og slutningsoperasjonene for PCA
- Få tilgang til mellomresultater oppnådd på treningentage
- Ta med følgende overskrift som gjør alle oneDAL-deklarasjoner tilgjengelige.
- Opprett en SYCL*-kø med ønsket enhetsvelger. I dette tilfellet brukes GPU-velger:
const auto queue = sycl::queue{ sycl::gpu_selector{} }; - Siden alle oneDAL-deklarasjoner er i oneapi::dal-navneområdet, importer alle erklæringer fra oneapi-navneområdet for å bruke dal i stedet for oneapi::dal for korthets skyld: ved å bruke navneområdet oneapi;
- Bruk CSV-datakilden til å lese dataene fra CSV-en file inn i en tabell:
const auto data = dal::les (kø, dal::csv::datakilde{“data.csv”}); - Lag en PCA-deskriptor, konfigurer parameterne, og kjør treningsalgoritmen på dataene som er lastet inn fra CSV.
- Skriv ut de lærte egenvektorene:
- Bruk den trente modellen for slutninger for å redusere dimensjonaliteten til dataene:
Bygg og kjør eksamples
Utfør følgende trinn for å bygge og kjøre examples som viser de grunnleggende bruksscenariene for én DAL med SYCL-støtte. Gå til /dal/ og deretter sette opp et miljø som vist i eksample nedenfor:
NOTE Alt innhold nedenfor som starter med # regnes som en kommentar og skal ikke kjøres med koden.
- Sett opp det nødvendige miljøet for én DAL (variabler som CPATH, LIBRARY_PATH og LD_LIBRARY_PATH):
• På Linux er det to mulige måter å sette opp det nødvendige miljøet på: via vars.sh-skript eller via modul files.
• Sette opp ett DAL-miljø via vars.sh-skript Kjør følgende kommando:
kilde ./env/vars.sh
• Sette opp ett DAL-miljø via modul files
Initialiser 1. moduler: kilde $MODULESHOME/infit/bash
NOTE Se dokumentasjonen for miljømoduler for detaljer.
Gi 2. moduler med en bane til modulen files katalog: modul
bruk ./modul files
Kjør 3.modulen:
modullast dal
• På Windows, kjør følgende kommando:
/env/vars.bat - Kopi ./eksamples/neap/dip til en skrivbar katalog om nødvendig (siden den oppretter midlertidig files):
cp r ./eksamples/oneapi/dpc ${WRITABLE_DIR} - Sett opp kompilatormiljøet for Intel® one API DPC++/C++ Compiler. Se Kom i gang med Intel® oneAPI DPC++/C++-kompileren for detaljer.
- Bygg og kjør eksenamples som viser hvordan du bruker én DAL med SYCL-støtte:
NOTE Du må ha skrivetillatelser til eksenamples mappe for å bygge eksamples, og utfør tillatelser for å kjøre dem. Ellers må du kopiere eksamples/oneapi/dpc og eksamples/oneapi/data-mappene til katalogen med riktige tillatelser. Disse to mappene må beholdes på samme katalognivå i forhold til hverandre.
• På Linux:
• På Windows:
- For å se alle tilgjengelige parametere for byggeprosedyren, skriv inn make på Linux* eller unmake på Windows*.
Den resulterende eksample binærfiler og logg files skrives inn i _results-katalogen.
NOTE Du bør kjøre eksenamples fra eksamples/oneapi/dpc-mappen, ikke fra _results-mappen. De fleste eksamples krever at data lagres i eksamples/oneapi/data-mappen og å ha en relativ kobling til den startet fra eksamples/oneapi/dip-mappen.
Du kan bygge tradisjonelle C++ examples plassert i eksamples/oneapi/cup-mappen på lignende måte.
Kompiler og bygg applikasjoner med pkg-config
Pkg-config-verktøyet er et mye brukt verktøy for å bygge programvare med avhengigheter. Intel® one API Data Analytics Library tilbyr files med pug-config metadata for kompilering og kobling av en applikasjon til biblioteket.
Sett opp miljøet
For å bruke pug-config, bygg biblioteket og sett opp miljøet ved å bruke vars.sh eller vars.bat skript:
- På Linux: kilde ./env/vars.sh
- På Windows: /env/vars.bat
Velg en metadata file
Metadataene files levert av én DAL-dekkende vertsenhetskonfigurasjon på 64-bit Linux, macOS eller Windows operativsystem for C++.
Velg metadata file basert på én DAL-trådingsmodus og koblingsmetode du bruker:
en DAL pug-config metadata files
| Enkeltrådet (ikke-trådet) | Flertrådet (innvendig gjenget) | |
| Statisk kobling | dal-statisk-sekvensiell-vert | dal-statisk-tråding-vert |
| Dynamisk kobling | dal-dynamisk-sekvensiell-vert | dal-dynamic-threading-host |
Kompiler et program ved å bruke peg-config
For å kompilere et test.cpp-program med én DAL og peg-config, oppgi navnet på den ene DAL pug-config-metadataen file som en inngangsparameter. For eksampde:
- På Linux eller macOS:
ice test.cpp pug-config –flags –libs dal-dynamic-threading-host - På Windows:
for /F “delimbs=,” %i in ('pug-config –flags –libs dal-dynamic-threading-host) gjør icl test.cpp %i
A sample-kode for svm_two_class_thunder_dense_batch eksample med SYCL-støtte. Kjør følgende fra eksenamples/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:
for /F “delis=,” %i in ('peg-config –flags –libs dal-dynamic-threading-host) gjør ill -I source/ ill svm_two_class_thunder_dense_batch.cpp %i
Finn mer
| Dokument | Beskrivelse |
| Utviklerveiledning og referanse | Se en DAL-utviklerveiledning og referanse for detaljert informasjon om implementerte algoritmer. |
| Systemkrav | Sjekk systemkravene før du installerer Intel® one API Dataanalysebibliotek. |
| Utgivelsesnotater | Se versjonsmerknadene for Intel® one API Data Analytics Bibliotek for å lære om nye oppdateringer i den siste utgivelsen. |
| Kode Samples | Lær hvordan du bruker én DAL med daal4py, en Python* API. |
| én DAL-spesifikasjon | Lær om krav til implementeringer av ett API Dataanalysebibliotek. |
Merknader og ansvarsfraskrivelser
Intel-teknologier kan kreve aktivert maskinvare-, programvare- eller tjenesteaktivering.
Ingen produkter eller komponenter kan være helt sikre.
Kostnadene og resultatene dine kan variere.
© Intel Corporation. Intel, Intel-logoen og andre Intel-merker er varemerker for Intel Corporation eller dets datterselskaper. Andre navn og merker kan gjøres krav på som andres eiendom.
Ingen lisens (uttrykkelig eller underforstått, ved estoppel eller på annen måte) til noen immaterielle rettigheter er gitt av dette dokumentet.
Produktene som beskrives kan inneholde designfeil eller feil kjent som errata som kan føre til at produktet avviker fra publiserte spesifikasjoner. Gjeldende karakteriserte errata er tilgjengelig på forespørsel.
Intel fraskriver seg alle uttrykte og underforståtte garantier, inkludert, uten begrensning, underforståtte garantier for salgbarhet, egnethet for et bestemt formål og ikke-krenkelse, samt enhver garanti som oppstår fra ytelsesforløpet, handelsforløpet eller bruk i handelen.
Dokumenter / Ressurser
 |
intel Kom i gang med oneAPI oneAPI Data Analytics Library [pdfBrukerhåndbok Kom i gang med oneAPI oneAPI Data Analytics Library, Kom i gang, med oneAPI oneAPI Data Analytics Library, Analytics Library |
