intel Get Started with oneAPI oneAPI Data Analytics Library User Guide

Iniziate cù Intel®
una API una API Biblioteca di Data Analytics

Iniziate cù Intel® one API one API Data Analytics Library

Intel® oneAPI Data Analytics Library (oneDAL) hè una libreria chì aiuta à accelerà l'analisi di big data fornendu blocchi algoritmici altamente ottimizzati per tutti i s.tages di analitiche di dati (preprocessing, trasfurmazioni, analisi, mudeli, validazione, è decisione) in batch, online, è modi di trasfurmazioni distribuitu di calculu. Per infurmazione generale nantu à oneDAL, visitate a pagina ufficiale di oneDAL.

Prima di principià
oneDAL si trova in /dal repertoriu induve hè u cartulare in quale hè statu installatu Intel® oneAPI Base Toolkit.
A versione attuale di oneDAL cù supportu SYCL hè dispunibule per i sistemi operativi Linux * è Windows * 64-bit. E librerie oneDAL prebuilt ponu esse truvate in u /dal/ /resist directory.
Per sapè nantu à i requisiti di u sistema è e dependenzii necessarii per custruisce examples, riferite à u Requisiti di u sistema pagina.

Da punta à punta Esample
Quì sottu pudete truvà un flussu di travagliu di usu tipicu per un algoritmu oneDAL in GPU. L'example hè furnitu per l'algoritmu di analisi di cumpunenti principali (PCA).

I seguenti passi mostranu cumu fà:

• Leghjite i dati da CSV file
• Eseguite l'operazioni di furmazione è inferenza per PCA
• Accede à i risultati intermedi ottenuti à a furmazione stage

1. Includite l'intestazione seguente chì rende disponibile tutte e dichjarazioni oneDAL.
   
2. Crea una fila SYCL * cù u selettore di u dispositivu desideratu. In questu casu, u selettore GPU hè adupratu:
   const auto queue = sycl::queue{ sycl::gpu_selector{} };
3. Siccomu tutte e dichjarazioni oneDAL sò in l'oneapi::dal namespace, impurtate tutte e dichjarazioni da u namespace oneapi per utilizà dal invece di oneapi::dal per brevità: use namespace oneapi;
4. Utilizà a fonte di dati CSV per leghje e dati da u CSV file in una tavola:
   const auto data = dal::read (queue, dal::csv::data source {"data.csv"});
5. Crea un descrittore PCA, cunfigurà i so paràmetri, è eseguite l'algoritmu di furmazione nantu à i dati caricati da CSV.
   
6. Stampa i vettori propri appresi:
   
7. Aduprate u mudellu furmatu per inferenza per riduce a dimensionalità di e dati:
   

Custruisce è Esegui Examples
Eseguite i seguenti passi per custruisce è eseguisce examples chì dimustranu i scenarii di usu basi di un DAL cù supportu SYCL. Andà à /dal/ è poi crià un ambiente cum'è mostra in l'example quì sottu:

NOTA Tuttu u cuntenutu sottu chì principia cù # hè cunsideratu cum'è un cumentu è ùn deve esse eseguitu cù u codice.

1. Configurate l'ambiente necessariu per un DAL (variabili cum'è CPATH, LIBRARY_PATH è LD_LIBRARY_PATH):
   • In Linux, ci sò duie manere pussibuli di stallà l'ambiente necessariu: via vars.sh script o via modulu files.
   • Configurazione di un ambiente DAL via script vars.sh Eseguite u cumandimu seguente:
   fonte ./env/vars.sh
   • Stallà un ambiente DAL via modulu files
   Inizializà 1. moduli: fonte $MODULESHOME/infit/bash
   NOTA Vede a documentazione di i Moduli di Ambiente per i dettagli.
   furnisce 2. moduli cù una strada à u modulu files repertoriu: modulu
   aduprà ./module files
   Eseguite u 3.module:
   carica di modulu dal
   • In Windows, eseguisce u cumandimu seguente:
   /env/vars.bat
2. Copia ./examples/neap/dip à un repertoriu scrivibile se ne necessariu (perchè crea un tempurale files):
   cp r ./examples/oneapi/dpc ${WRITABLE_DIR}
3. Configurate l'ambiente di compilatore per Intel® one API DPC++/C++ Compiler. Vede Iniziate cù Intel® oneAPI DPC++/C++ Compiler per i dettagli.
4. Custruite è eseguite l'example chì mostranu cumu utilizà un DAL cù supportu SYCL:
   NOTA Avete bisognu di avè permessi di scrittura à l'examples folder per custruisce examples, è eseguite permessi per eseguisce. Altrimenti, avete bisognu di cupià examples/oneapi/dpc è examples/oneapi/data cartulare à u cartulare cù i permessi ghjusti. Sti dui cartulare deve esse ritenuti in u listessu livellu di repertoriu relative unu à l'altru.
   • In Linux:
   • In Windows:
   
5. Per vede tutti i paràmetri dispunibuli di a prucedura di creazione, scrivite make in Linux * o unmake in Windows *.
   L'example binari è log files sò scritti in u cartulare _results.
   NOTA Duvete eseguisce l'examples da examples/oneapi/dpc, micca da u cartulare _results. A maiò parte exampi richiedenu dati per esse almacenati in examples/oneapi/data cartulare è avè un ligame relative à ellu principiatu da exampcartella les/oneapi/dip.
   Pudete custruisce tradiziunale C ++ exampi situati in examples/oneapi/cup folder in una manera simile.

Cumpilà è custruisce applicazioni cù pkg-config
L'uttellu pkg-config hè un strumentu assai utilizatu per custruisce software cù dipendenze. Intel® one API Data Analytics Library furnisce files cù metadata pug-config per cumpilà è ligà una applicazione à a biblioteca.

Stallà l'ambiente
Per utilizà pug-config, custruite a biblioteca è poi cunfigurà l'ambienti cù script vars.sh o vars.bat:

• In Linux: fonte ./env/vars.sh
• In Windows: /env/vars.bat

Sceglite una metadata file
I metadati files forniti da un DAL copre solu a cunfigurazione di u dispositivu host in u sistema operatore Linux, macOS o Windows 64-bit per C++.
Sceglite i metadati file basatu annantu à un modu di filettatura DAL è u metudu di ligame chì utilizate:

una metadata DAL pug-config files

Cumpilà un prugramma cù peg-config
Per cumpilà un prugramma test.cpp cù un DAL è peg-config, furnisce u nome di l'una metadata DAL pug-config file cum'è un paràmetru di input. Per esampLe:

• In Linux o macOS:
  ice test.cpp pug-config -flags -libs dal-dynamic-threading-host
• À Windows:
  per /F "delimbs=", %i in ('pug-config –flags –libs dal-dynamic-threading-host) fà icl test.cpp %i
  A sampu codice per svm_two_class_thunder_dense_batch example cù supportu SYCL. Eseguite i seguenti da l'exampannuariu les/oneapi/cpp:
• In Linux o macOS:
  icc -I source/ source/svm/svm_two_class_thunder_dense_batch.cpp icc test.cpp pkg-config –cflags –libs dal-dynamic-threading-host
• À Windows:
  per /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

Truvate di più

Avvisi è Disclaimers
I tecnulugii Intel ponu necessità attivazione di hardware, software o serviziu.
Nisun pruduttu o cumpunente pò esse assolutamente sicuru.
I vostri costi è risultati pò varià.

© Intel Corporation. Intel, u logu Intel è altri marchi Intel sò marchi di Intel Corporation o di e so filiali. Altri nomi è marche ponu esse rivendicate cum'è a pruprietà di l'altri.
Nisuna licenza (espressa o implicita, per estoppel o altrimenti) à qualsiasi diritti di pruprietà intellettuale hè cuncessa da stu documentu.
I prudutti descritti ponu cuntene difetti di cuncepimentu o errori cunnisciuti cum'è errata chì ponu causà à u pruduttu di devià da e specificazioni publicate. L'errata carattarizatu attuale sò dispunibili nantu à dumanda.
Intel declina tutte e garanzie espresse è implicite, cumprese senza limitazione, e garanzie implicite di cummerciabilità, idoneità per un scopu particulari, è non-infrazione, è ancu qualsiasi guaranzia derivante da u cursu di prestazione, u cursu di trattu o l'usu in u cummerciu.