Premiers pas avec Intel®
une API une API Bibliothèque d'analyse de données
Premiers pas avec la bibliothèque d'analyse de données Intel® One API One API
La bibliothèque d'analyse de données Intel® oneAPI (oneDAL) est une bibliothèque qui permet d'accélérer l'analyse de données volumineuses en fournissant des blocs de construction algorithmiques hautement optimisés pour toustages d'analyse de données (prétraitement, transformation, analyse, modélisation, validation et prise de décision) dans des modes de traitement par lots, en ligne et distribués. Pour des informations générales sur oneDAL, visitez la page officielle de oneDAL.
Avant de commencer
oneDAL est situé dans /dal répertoire où est le répertoire dans lequel Intel® oneAPI Base Toolkit a été installé.
La version actuelle de oneDAL avec prise en charge de SYCL est disponible pour les systèmes d'exploitation Linux* et Windows* 64 bits. Les bibliothèques oneDAL prédéfinies se trouvent dans le /dal/ répertoire /resist.
Pour en savoir plus sur la configuration système requise et les dépendances nécessaires pour compiler examples, reportez-vous au Configuration requise page.
Ex de bout en boutample
Vous trouverez ci-dessous un flux de travail d'utilisation typique pour un algorithme oneDAL sur GPU. Le EXampLe fichier est fourni pour l'algorithme d'analyse en composantes principales (ACP).
Les étapes suivantes décrivent comment :
- Lire les données du CSV file
- Exécuter les opérations de formation et d'inférence pour PCA
- Accéder aux résultats intermédiaires obtenus lors des formationstage
- Incluez l'en-tête suivant qui rend toutes les déclarations oneDAL disponibles.
- Créez une file d'attente SYCL* avec le sélecteur de périphérique souhaité. Dans ce cas, le sélecteur GPU est utilisé :
const auto queue = sycl::queue{ sycl::gpu_selector{} } ; - Étant donné que toutes les déclarations oneDAL se trouvent dans l'espace de noms oneapi::dal, importez toutes les déclarations de l'espace de noms oneapi pour utiliser dal au lieu de oneapi::dal par souci de brièveté : using namespace oneapi ;
- Utiliser la source de données CSV pour lire les données du CSV file dans un tableau :
const données automatiques = dal :: lire (file d'attente, dal::csv::datasource{"data.csv"}) ; - Créez un descripteur PCA, configurez ses paramètres et exécutez l'algorithme de formation sur les données chargées à partir de CSV.
- Imprimez les vecteurs propres appris :
- Utilisez le modèle formé pour l'inférence afin de réduire la dimensionnalité des données :
Construire et exécuter Examples
Effectuez les étapes suivantes pour créer et exécuter exampfichiers démontrant les scénarios d'utilisation de base d'un DAL avec prise en charge de SYCL. Aller à /dal/ puis configurez un environnement comme indiqué dans l'exampci-dessous:
NOTE Tout le contenu ci-dessous commençant par # est considéré comme un commentaire et ne doit pas être exécuté avec le code.
- Configurez l'environnement requis pour une DAL (variables telles que CPATH, LIBRARY_PATH et LD_LIBRARY_PATH) :
• Sous Linux, il existe deux manières possibles de configurer l'environnement requis : via le script vars.sh ou via le module files.
• Configuration d'un environnement DAL via le script vars.sh Exécutez la commande suivante :
source ./env/vars.sh
• Configuration d'un environnement DAL via le module files
Initialiser1. modules : source $MODULESHOME/infit/bash
NOTE Reportez-vous à la documentation des modules d'environnement pour plus de détails.
Fournir2. modules avec un chemin vers le module filerépertoire s : module
utilisez ./module files
Exécutez le3.module :
module charge dal
• Sous Windows, exécutez la commande suivante :
/env/vars.bat - Copier ./examples/neap/dip dans un répertoire accessible en écriture si nécessaire (puisqu'il crée des files):
cp r ./exampfichiers/oneapi/dpc ${WRITABLE_DIR} - Configurez l'environnement du compilateur pour le compilateur Intel® one API DPC++/C++. Voir Premiers pas avec le compilateur Intel® oneAPI DPC++/C++ pour plus de détails.
- Construire et exécuter l'exampchiers qui montrent comment utiliser un DAL avec le support SYCL :
NOTE Vous devez avoir des autorisations d'écriture sur l'exampdossier les à construire exampfichiers et exécuter les autorisations pour les exécuter. Sinon, vous devez copier examples/oneapi/dpc et examples/oneapi/data dans le répertoire avec les bonnes autorisations. Ces deux dossiers doivent être conservés au même niveau de répertoire l'un par rapport à l'autre.
• Sous Linux :
• Sous Windows :
- Pour voir tous les paramètres disponibles de la procédure de construction, tapez make sous Linux* ou unmake sous Windows*.
L'ex résultantample binaire et log files sont écrits dans le répertoire _results.
NOTE Vous devriez exécuter l'examples de l'exampdossier les/oneapi/dpc, pas du dossier _results. La plupart des examples fichiers nécessitent que les données soient stockées dans exampdossier les/oneapi/data et d'avoir un lien relatif vers celui-ci à partir de exampdossier les/oneapi/dip.
Vous pouvez construire ex C++ traditionnelamples situés en exampdossier les/oneapi/cup de la même manière.
Compiler et créer des applications avec pkg-config
L'outil pkg-config est un outil largement utilisé pour créer des logiciels avec des dépendances. La bibliothèque d'analyse de données Intel® One API fournit files avec les métadonnées pug-config pour compiler et lier une application à la bibliothèque.
Mettre en place l'environnement
Pour utiliser pug-config, créez la bibliothèque, puis configurez l'environnement à l'aide des scripts vars.sh ou vars.bat :
- Sous Linux : source ./env/vars.sh
- Sous Windows : /env/vars.bat
Choisissez une métadonnée file
Les métadonnées fileLes s fournis par une DAL couvrent uniquement la configuration du périphérique hôte sur les systèmes d'exploitation Linux, macOS ou Windows 64 bits pour C++.
Choisissez les métadonnées file basé sur un mode de threading DAL et une méthode de liaison que vous utilisez :
une métadonnée DAL pug-config files
Filetage unique (non fileté) | Multi-thread (filetage interne) | |
Liens statiques | dal-statique-hôte-séquentiel | hôte de thread-statique-dal |
Liaison dynamique | dal-dynamique-séquentiel-hôte | hôte de thread dynamique dal |
Compiler un programme avec peg-config
Pour compiler un programme test.cpp avec une DAL et peg-config, indiquez le nom de la métadonnée DAL pug-config file comme paramètre d'entrée. Par exempleample:
- Sous Linux ou macOS :
ice test.cpp pug-config –flags –libs dal-dynamic-threading-host - Sous Windows :
for /F "delimbs=," %i in ('pug-config –flags –libs dal-dynamic-threading-host) do icl test.cpp %i
Commeample code pour svm_two_class_thunder_dense_batch exampfichier avec prise en charge SYCL. Exécutez ce qui suit à partir de l'examprépertoire les/oneapi/cpp : - Sous Linux ou macOS :
icc -I source/ source/svm/svm_two_class_thunder_dense_batch.cpp icc test.cpp pkg-config –cflags –libs dal-dynamic-threading-host - Sous 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
En savoir plus
Document | Description |
Guide du développeur et référence | Reportez-vous à un guide et référence du développeur DAL pour des informations détaillées sur les algorithmes mis en œuvre. |
Configuration requise | Vérifiez la configuration système requise avant d'installer Intel® One API Bibliothèque d'analyse de données. |
Notes de mise à jour | Reportez-vous aux notes de mise à jour pour Intel® one API Data Analytics Bibliothèque pour en savoir plus sur les nouvelles mises à jour de la dernière version. |
Codesamples | Apprenez à utiliser une DAL avec daal4py, une API Python*. |
une spécification DAL | En savoir plus sur les exigences pour les implémentations d'une API Bibliothèque d'analyse de données. |
Avis et avis de non-responsabilité
Les technologies Intel peuvent nécessiter une activation matérielle, logicielle ou de service activée.
Aucun produit ou composant ne peut être absolument sûr.
Vos coûts et vos résultats peuvent varier.
©Intel Corporation. Intel, le logo Intel et les autres marques Intel sont des marques commerciales d'Intel Corporation ou de ses filiales. D'autres noms et marques peuvent être revendiqués comme la propriété d'autrui.
Aucune licence (expresse ou implicite, par préclusion ou autre) sur aucun droit de propriété intellectuelle n'est accordée par ce document.
Les produits décrits peuvent contenir des défauts de conception ou des erreurs appelés errata qui peuvent entraîner un écart par rapport aux spécifications publiées. Les errata caractérisés actuels sont disponibles sur demande.
Intel décline toute garantie expresse et implicite, y compris, sans s'y limiter, les garanties implicites de qualité marchande, d'adéquation à un usage particulier et d'absence de contrefaçon, ainsi que toute garantie découlant du cours des performances, du cours des transactions ou de l'utilisation dans le commerce.
Documents / Ressources
![]() |
intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI [pdf] Guide de l'utilisateur Premiers pas avec la bibliothèque d'analyse de données oneAPI oneAPI, Premiers pas, avec la bibliothèque d'analyse de données oneAPI oneAPI, Bibliothèque d'analyse |