Pagsugod sa Intel®
usa ka API usa ka API Librarya sa Data Analytics

Pagsugod sa Intel® usa ka API usa ka API Data Analytics Library

Ang Intel® oneAPI Data Analytics Library (oneDAL) usa ka librarya nga nagtabang sa pagpadali sa dako nga pagtuki sa datos pinaagi sa paghatag og labing maayo nga algorithmic nga mga bloke sa pagtukod alang sa tanan ngatages sa data analytics (preprocessing, transformation, analysis, modeling, validation, ug decision making) sa batch, online, ug distributed processing modes of computation. Alang sa kinatibuk-ang impormasyon bahin sa oneDAL, bisitaha ang opisyal nga panid sa oneDAL.

Sa Dili Ka pa Magsugod
oneDAL nahimutang sa /dal nga direktoryo diin mao ang direktoryo diin gi-install ang Intel® oneAPI Base Toolkit.
Ang kasamtangan nga bersyon sa oneDAL nga adunay suporta sa SYCL anaa alang sa Linux* ug Windows* 64-bit operating system. Ang prebuilt oneDAL nga mga librarya makita sa /dal/ /sukol nga direktoryo.
Aron mahibal-an ang bahin sa mga kinahanglanon sa sistema ug ang mga dependency nga gikinahanglan aron matukod ang examples, tan-awa ang Mga Kinahanglanon sa Sistema panid.

Katapusan-sa-katapusan Example
Sa ubos makit-an nimo ang usa ka tipikal nga workflow sa paggamit alang sa usa ka oneDAL algorithm sa GPU. Ang exampAng gihatag alang sa Principal Component Analysis algorithm (PCA).

Ang mosunod nga mga lakang nagpakita kon unsaon:

• Basaha ang datos gikan sa CSV file
• Pagdalagan ang pagbansay ug mga operasyon sa inference para sa PCA
• Pag-access sa mga intermediate nga resulta nga nakuha sa pagbansay stage

1. Ilakip ang mosunod nga header nga naghimo sa tanang deklarasyon sa oneDAL nga magamit.
   
2. Paghimo og SYCL* queue nga adunay gusto nga device selector. Sa kini nga kaso, gigamit ang pagpili sa GPU:
   const auto queue = sycl::queue{ sycl::gpu_selector{} };
3. Tungod kay ang tanang deklarasyon sa oneDAL anaa sa oneapi::dal namespace, import ang tanang deklarasyon gikan sa oneapi namespace aron gamiton ang dal imbes nga oneapi::dal para sa mubu: gamit ang namespace oneapi;
4. Gamita ang tinubdan sa datos sa CSV aron mabasa ang datos gikan sa CSV file sa usa ka lamesa:
   const auto data = dal:: basaha (pila, dal::csv::tinubdan sa datos{“data.csv”});
5. Paghimo usa ka deskriptor sa PCA, i-configure ang mga parameter niini, ug padagana ang algorithm sa pagbansay sa datos nga gikarga gikan sa CSV.
   
6. I-print ang nakat-unan nga eigenvector:
   
7. Gamita ang gibansay nga modelo alang sa inference aron makunhuran ang dimensionality sa datos:
   

Pagtukod ug Pagdagan Examples
Buhata ang mosunod nga mga lakang sa pagtukod ug pagdagan examples nga nagpakita sa batakang mga senaryo sa paggamit sa usa ka DAL nga adunay suporta sa SYCL. Adto sa /dal/ ug dayon ipahimutang ang usa ka palibot sama sa gipakita sa exampsa ubos:

NOTA Ang tanan nga sulud sa ubos nga nagsugod sa # giisip nga usa ka komentaryo ug dili kinahanglan ipadagan sa code.

1. I-set up ang gikinahanglan nga palibot para sa usa ka DAL (mga variables sama sa CPATH, LIBRARY_PATH, ug LD_LIBRARY_PATH):
   • Sa Linux, adunay duha ka posibleng paagi sa pag-set up sa gikinahanglang palibot: pinaagi sa vars.sh script o pinaagi sa module files.
   • Pag-set up og usa ka DAL environment pinaagi sa vars.sh script Pagdalagan ang mosunod nga sugo:
   tinubdan ./env/vars.sh
   • Pagpahimutang sa usa ka palibot sa DAL pinaagi sa module files
   Inisyal1. modules: tinubdan $MODULESHOME/infit/bash
   NOTA Tan-awa ang dokumentasyon sa Environment Modules para sa mga detalye.
   Paghatag2. modules nga adunay dalan paingon sa module files direktoryo: module
   gamita ang ./module files
   Pagdalagan ang3.module:
   module load dal
   • Sa Windows, padagana ang mosunod nga sugo:
   /env/vars.bat
2. Kopyaha ./examples / neap / ituslob sa usa ka masulat nga direktoryo kung gikinahanglan (tungod kay kini nagmugna temporaryo files):
   cp r./examples/oneapi/dpc ${WRITABLE_DIR}
3. I-set up ang compiler environment para sa Intel® one API DPC++/C++ Compiler. Tan-awa Pagsugod sa Intel® oneAPI DPC++/C++ Compiler alang sa mga detalye.
4. Pagtukod ug pagdagan sa examples nga nagpakita kung unsaon paggamit ang usa ka DAL nga adunay suporta sa SYCL:
   NOTA Kinahanglan nga adunay ka permiso sa pagsulat sa imong examples folder sa pagtukod examples, ug ipatuman ang mga permiso sa pagpadagan niini. Kung dili, kinahanglan nimo kopyahon ang examples/oneapi/dpc ug examples/ oneapi/data nga mga folder sa direktoryo nga adunay hustong permiso. Kining duha ka mga folder kinahanglang ipabilin sa samang lebel sa direktoryo nga may kalabotan sa usag usa.
   • Sa Linux:
   • Sa Windows:
   
5. Aron makita ang tanang magamit nga parameter sa pamaagi sa pagtukod, i-type ang make on Linux* o unmake sa Windows*.
   Ang resulta nga example binaries ug log files kay gisulat sa _results directory.
   NOTA Dapat mo run ang examples gikan sa examples/oneapi/dpc folder, dili gikan sa _results folder. Kadaghanan sa examples nagkinahanglan data nga tipigan sa examples/oneapi/data folder ug aron adunay paryente nga link niini nagsugod gikan sa examples/oneapi/dip folder.
   Mahimo nimong tukuron ang tradisyonal nga C++ examples nahimutang sa examples/oneapi/cup folder sa susamang paagi.

Pag-compile ug paghimo og mga aplikasyon gamit ang pkg-config
Ang tool sa pkg-config kay kaylap nga gigamit nga himan para sa pagtukod og software nga adunay mga dependency. Ang Intel® usa ka API Data Analytics Library naghatag files nga adunay pug-config metadata alang sa pag-compile ug pag-link sa usa ka aplikasyon sa librarya.

Ipahimutang ang palibot
Aron magamit ang pug-config, buhata ang librarya ug i-set up ang palibot gamit ang vars.sh o vars.bat nga mga script:

• Sa Linux: tinubdan ./env/vars.sh
• Sa Windows: /env/vars.bat

Pagpili og metadata file
Ang metadata files nga gihatag sa usa ka DAL nga naglangkob lamang sa host device configuration sa 64-bit Linux, macOS, o Windows operating system para sa C++.
Pilia ang metadata file base sa usa ka DAL threading mode ug linking method nga imong gigamit:

usa ka DAL pug-config metadata files

Single-threaded (non-threaded)		Multi-threaded (internally threaded)
Static nga pagsumpay	dal-static-sequential-host	dal-static-threading-host
Kusog nga pag-link	dal-dynamic-sequential-host	dal-dynamic-threading-host

Pag-compile sa usa ka programa gamit ang peg-config
Sa pag-compile sa usa ka test.cpp nga programa nga adunay usa ka DAL ug peg-config, ihatag ang ngalan sa usa ka DAL pug-config metadata file isip usa ka input parameter. Kay example:

• Sa Linux o macOS:
  ice test.cpp pug-config –flags –libs dal-dynamic-threading-host
• Sa Windows:
  para sa /F “delimbs=,” %i in ('pug-config –flags –libs dal-dynamic-threading-host) buhata ang icl test.cpp %i
  Usa ka sample code para sa svm_two_class_thunder_dense_batch example nga adunay suporta sa SYCL. Dagan ang mosunod gikan sa examples/oneapi/cpp nga direktoryo:
• Sa Linux o macOS:
  icc -Ako tinubdan/ tinubdan/svm/svm_two_class_thunder_dense_batch.cpp icc test.cpp pkg-config –cflags –libs dal-dynamic-threading-host
• Sa Windows:
  kay / F “delis=,” %i sa ('peg-config –flags –libs dal-dynamic-threading-host) magbuhat og sakit -I source/ ill svm_two_class_thunder_dense_batch.cpp %i

Pangitag Dugang

Dokumento	Deskripsyon
Giya sa Developer ug Reperensya	Tan-awa ang usa ka DAL Developer Guide ug Reference para sa detalyado nga kasayuran bahin sa gipatuman nga mga algorithm.
Mga Kinahanglanon sa Sistema	Susiha ang mga kinahanglanon sa sistema sa dili pa nimo i-install ang Intel® one API Librarya sa Data Analytics.
Release Notes	Tan-awa ang pagpagawas sa mga nota para sa Intel® one API Data Analytics Library aron mahibal-an ang bahin sa mga bag-ong update sa pinakabag-o nga pagpagawas.
Kodigo Samples	Pagkat-on unsaon paggamit ang usa ka DAL nga adunay daal4py, usa ka Python* API.
usa ka Detalye sa DAL	Pagkat-on mahitungod sa mga kinahanglanon alang sa pagpatuman sa usa ka API Librarya sa Data Analytics.

Mga Notice ug Disclaimers
Ang mga teknolohiyang Intel mahimong manginahanglan aktibo nga hardware, software o pag-aktibo sa serbisyo.
Wala’y produkto o sangkap nga mahimong hingpit nga sigurado.
Mahimong magkalainlain ang imong mga gasto ug mga sangputanan.

© Intel Corporation. Ang Intel, ang logo sa Intel, ug uban pang mga marka sa Intel mga marka sa pamatigayon sa Intel Corporation o mga subsidiary niini. Ang ubang mga ngalan ug mga tatak mahimong maangkon ingon nga kabtangan sa uban.
Walay lisensya (gipahayag o gipasabot, pinaagi sa estoppel o uban pa) sa bisan unsang mga katungod sa intelektwal nga kabtangan ang gihatag niini nga dokumento.
Ang mga produkto nga gihulagway mahimong adunay mga depekto sa disenyo o mga sayup nga nailhan nga errata nga mahimong hinungdan sa pagtipas sa produkto gikan sa gipatik nga mga detalye. Ang kasamtangan nga kinaiya nga sayop anaa sa hangyo.
Gipanghimakak sa Intel ang tanang gipahayag ug gipasabot nga mga garantiya, lakip ang walay limitasyon, ang gipasabot nga mga garantiya sa pagkahimong mamaligya, kaangayan alang sa usa ka partikular nga katuyoan, ug dili paglapas, ingon man ang bisan unsang garantiya nga naggikan sa dagan sa pasundayag, dagan sa pagdumala, o paggamit sa pamatigayon.

Mga Dokumento / Mga Kapanguhaan

intel Pagsugod sa usaAPI oneAPI Data Analytics Library [pdf] Giya sa Gumagamit Pagsugod sa oneAPI oneAPI Data Analytics Library, Pagsugod, uban sa oneAPI oneAPI Data Analytics Library, Analytics Library

Mga pakisayran

• Manwal sa Gumagamit