Intel - Logo

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
  1. Incluez l'en-tête suivant qui rend toutes les déclarations oneDAL disponibles.
    intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI - Premiers pas avec Intel 1
  2. 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{} } ;
  3. É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 ;
  4. 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"}) ;
  5. 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.
    intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI - Premiers pas avec Intel 2
  6. Imprimez les vecteurs propres appris :
    intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI - Premiers pas avec Intel 3
  7. Utilisez le modèle formé pour l'inférence afin de réduire la dimensionnalité des données :
    intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI - Premiers pas avec Intel 4

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.

  1. 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
  2. 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}
  3. 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.
  4. 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 :
    intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI - Premiers pas avec Intel 5• Sous Windows :
    intel Premiers pas avec oneAPI bibliothèque d'analyse de données oneAPI - Premiers pas avec Intel 6
  5. 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.

Intel - Logo

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

Références

Laisser un commentaire

Votre adresse email ne sera pas publiée. Les champs obligatoires sont marqués *