Tutoriel : Classification d’images - Rekognition
Étape 1 : Collecter vos imagesÉtape 2 : Choisir vos classesÉtape 3 : Créer un projetÉtape 4 : Créer des jeux de données d’entraînement et de testÉtape 5 : Ajouter des étiquettes au projetÉtape 6 : Attribuer des étiquettes au niveau de l’image aux jeux de données d’entraînement et de testÉtape 7 : Entraîner votre modèleÉtape 8 : Démarrer votre modèleÉtape 9 : Analyser une image avec votre modèleÉtape 10 : Arrêter votre modèle

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : Classification d’images

Ce tutoriel explique comment créer le projet et les jeux de données d’un modèle qui classe les objets, les scènes et les concepts détectés dans une image. Le modèle classe l’image dans son intégralité. Par exemple, en suivant ce tutoriel, vous pouvez entraîner un modèle afin qu’il reconnaisse les pièces d’une maison (salon, cuisine, etc.). Le tutoriel explique également comment utiliser le modèle pour analyser des images.

Nous vous recommandons de lire Présentation de la fonctionnalité Étiquettes personnalisées Amazon Rekognition avant de commencer le tutoriel.

Dans ce tutoriel, vous allez créer les jeux de données d’entraînement et de test en chargeant des images depuis votre ordinateur local. Vous attribuerez ensuite des étiquettes au niveau de l’image aux images de vos jeux de données d’entraînement et de test.

Le modèle que vous créez classe les images comme appartenant au jeu d’étiquettes que vous avez attribué au niveau de l’image aux images du jeu de données d’entraînement. Par exemple, si le jeu d’étiquettes de votre jeu de données d’entraînement est kitchen, living_room, patio et backyard, le modèle peut potentiellement trouver toutes ces étiquettes dans une seule image.

Note

Vous pouvez créer des modèles à différentes fins, par exemple pour rechercher l’emplacement d’objets sur une image. Pour plus d’informations, consultez Choix de votre type de modèle.

Étape 1 : Collecter vos images

Vous avez besoin de deux séries d’images. Une série à ajouter à votre jeu de données d’entraînement. Une autre série à ajouter à votre jeu de données de test. Les images doivent représenter les objets, les scènes et les concepts que vous souhaitez que votre modèle classe. L’image doit être au format JPEG ou PNG. Pour plus d’informations, consultez Préparation des images.

Vous devez disposer d’au moins 10 images pour votre jeu de données d’entraînement et de 10 images pour votre jeu de données de test.

Si vous n’avez pas encore d’images, utilisez celles de l’exemple de projet de classification Pièces. Une fois le projet créé, les images d’entraînement et de test se trouvent dans les compartiments Amazon S3 suivants :

  • Images d’entraînement : s3://custom-labels-console-region-numbers/assets/rooms_version number_test_dataset/

  • Images de test : s3://custom-labels-console-region-numbers/assets/rooms_version number_test_dataset/

regionest la AWS région dans laquelle vous utilisez la console Amazon Rekognition Custom Labels. numbersest une valeur que la console attribue au nom du compartiment. Version numberest le numéro de version de l'exemple de projet, à partir de 1.

La procédure suivante permet de stocker les images du projet Pièces dans des dossiers locaux de votre ordinateur nommés training et test.

Pour télécharger les fichiers image de l’exemple de projet Pièces

  1. Créez le projet Pièces. Pour plus d’informations, consultez Étape 1 : Choisir un exemple de projet.

  2. Ouvrez l’invite de commande et saisissez la commande suivante pour télécharger les images d’entraînement.

    aws s3 cp s3://custom-labels-console-region-numbers/assets/rooms_version number_training_dataset/ training --recursive

  3. À l’invite de commande, saisissez la commande suivante pour télécharger les images de test.

    aws s3 cp s3://custom-labels-console-region-numbers/assets/rooms_version number_test_dataset/ test --recursive

  4. Déplacez deux des images du dossier d’entraînement vers un dossier distinct de votre choix. Vous allez utiliser les images pour essayer le modèle que vous avez entraîné à l’Étape 9 : Analyser une image avec votre modèle.

Étape 2 : Choisir vos classes

Dressez une liste des classes que vous souhaitez que votre modèle recherche. Par exemple, si vous apprenez à un modèle à reconnaître les pièces d’une maison, vous pouvez classer l’image suivante dans living_room.

Salon confortable avec cheminée, canapé moelleux, fauteuil, donnant sur l'extérieur.

Chaque classe correspond à une étiquette au niveau de l’image. Vous attribuerez ensuite des étiquettes au niveau de l’image aux images de vos jeux de données d’entraînement et de test.

Si vous utilisez les images de l’exemple de projet Pièces, les étiquettes au niveau de l’image sont backyard (jardin arrière), bathroom (salle de bains), bedroom (chambre à coucher), closet (placard), entry_way (entrée), floor_plan (plan d’étage), front_yard (jardin avant), kitchen (cuisine), living_space (pièce de vie) et patio.

Étape 3 : Créer un projet

Pour gérer vos jeux de données et vos modèles, vous devez créer un projet. Chaque projet doit porter sur un cas d’utilisation unique (reconnaissance des pièces d’une maison, par exemple).

Pour créer un projet (console)

  1. Si vous ne l’avez pas encore fait, configurez la console Étiquettes personnalisées Amazon Rekognition. Pour plus d’informations, consultez Configuration d’Étiquettes personnalisées Amazon Rekognition.

  2. Connectez-vous à la console Amazon Rekognition AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/rekognition/.

  3. Dans le volet de gauche, choisissez Utiliser Custom Labels. La page d’accueil d’Étiquettes personnalisées Amazon Rekognition s’affiche.

  4. Sur la page d’accueil d’Étiquettes personnalisées Amazon Rekognition, choisissez Commencer

  5. Dans le volet de navigation de gauche, choisissez Projets.

  6. Sur la page Projets, choisissez Créer un projet.

  7. Dans Project name (Nom de projet), saisissez un nom pour votre projet.

  8. Choisissez Créer un projet pour créer votre projet.

    Formulaire d'interface utilisateur pour créer un nouveau projet nommé « Mon projet » avec un champ pour saisir le nom du projet et annuler ou créer des boutons de projet.

Étape 4 : Créer des jeux de données d’entraînement et de test

Dans cette étape, vous allez créer un jeu de données d’entraînement et un jeu de données de test en chargeant des images depuis votre ordinateur local. Vous pouvez charger jusqu’à 30 images à la fois. Si vous avez beaucoup d’images à charger, vous pouvez les importer depuis un compartiment Amazon S3. Pour plus d’informations, consultez Compartiment Amazon S3.

Pour plus d’informations sur les jeux de données, consultez Gestion des jeux de données.

Pour créer un jeu de données à l’aide d’images d’un ordinateur local (console)

  1. Sur la page des détails du projet, choisissez Créer un jeu de données.

    Étape de création d'un jeu de données dans le flux de travail du modèle d'entraînement : bouton Créer un ensemble de données pour télécharger des images et des étiquettes vers le modèle d'entraînement.

  2. Dans la section Démarrage de la configuration, choisissez Démarrer avec un jeu de données d’entraînement et un jeu de données de test.

  3. Dans la section Détails du jeu de données d’entraînement, choisissez Charger des images depuis votre ordinateur.

  4. Dans la section Détails du jeu de données de test, choisissez Charger des images depuis votre ordinateur.

  5. Choisissez Créer des jeux de données.

    Interface utilisateur pour créer des ensembles de données de formation et de test. Créez des ensembles de données et cliquez sur le bouton Annuler en bas.

  6. Une page s’affiche avec un onglet Entraînement et un onglet Test pour vos jeux de données respectifs.

  7. Sur la page du jeu de données, choisissez l’onglet Entraînement.

  8. Choisissez Actions, puis sélectionnez Ajouter des images au jeu de données d’entraînement.

    Vue du jeu de données présentant les options permettant d'ajouter des images aux ensembles de données d'entraînement et de test dans le menu Actions.

  9. Dans la boîte de dialogue Ajouter des images au jeu de données d’entraînement, choisissez Choisir des fichiers.

    Bouton permettant de télécharger des fichiers image pour entraîner un ensemble de données.

  10. Choisissez les images que vous souhaitez charger dans le jeu de données. Vous pouvez charger jusqu’à 30 images à la fois.

  11. Choisissez Charger des images. Étiquettes personnalisées Amazon Rekognition peut avoir besoin de quelques instants pour ajouter les images dans le jeu de données.

    Grille présentant 11 vignettes d'images prêtes à être téléchargées dans un ensemble de données d'entraînement.

  12. Si vous avez d’autres images à ajouter au jeu de données d’entraînement, répétez les étapes 9 à 12.

  13. Choisissez l’onglet Test.

  14. Répétez les étapes 8 à 12 pour ajouter des images au jeu de données de test. Pour l’étape 8, choisissez Actions, puis sélectionnez Ajouter des images au jeu de données de test.

Étape 5 : Ajouter des étiquettes au projet

Au cours de cette étape, vous allez ajouter une étiquette au projet pour chacune des classes que vous avez identifiées à l’étape Étape 2 : Choisir vos classes.

Pour ajouter une nouvelle étiquette (console)

  1. Sur la page de la galerie de jeux de données, choisissez Commencer l’étiquetage pour passer en mode d’étiquetage.

    Interface de galerie de jeux de données indiquant les étapes à suivre pour étiqueter les images : révision, ajout d'étiquettes, étiquetage de l'emplacement des objets à l'aide de cadres de délimitation et modèle de train. Le bouton Démarrer l'étiquetage est surligné.

  2. Dans la section Étiquettes de la galerie de jeux de données, choisissez Modifier les étiquettes pour ouvrir la boîte de dialogue Gérer les étiquettes.

  3. Dans la zone d’édition, saisissez un nouveau nom d’étiquette.

  4. Choisissez Ajouter une étiquette.

  5. Répétez les étapes 3 et 4 jusqu’à ce que vous ayez créé toutes les étiquettes dont vous avez besoin.

  6. Choisissez Enregistrer pour enregistrer les étiquettes que vous avez ajoutées.

Étape 6 : Attribuer des étiquettes au niveau de l’image aux jeux de données d’entraînement et de test

Au cours de cette étape, vous allez attribuer un seul niveau d’image à chaque image de vos jeux de données d’entraînement et de test. L’étiquette au niveau de l’image correspond à la classe que chaque image représente.

Pour attribuer des étiquettes au niveau de l’image à une image (console)

  1. Sur la page Ensembles de données, choisissez l’onglet Entraînement.

  2. Choisissez Commencer l’étiquetage pour passer en mode d’étiquetage.

  3. Sélectionnez une ou plusieurs images auxquelles vous souhaitez ajouter des étiquettes. Vous ne pouvez sélectionner des images que sur une seule page à la fois. Pour sélectionner une plage contiguë d’images sur une page :

    1. Sélectionnez la première image.

    2. Appuyez sur la touche Maj et maintenez-la enfoncée.

    3. Sélectionnez la deuxième image. Les images situées entre la première et la deuxième image sont également sélectionnées.

    4. Relâchez la touche Maj.

  4. Choisissez Attribuer des étiquettes au niveau de l’image.

    Interface affichant trois images de jardins résidentiels, avec le bouton « Attribuer des étiquettes de niveau d'image ».

  5. Dans la boîte de dialogue Attribuer une étiquette au niveau de l’image aux images sélectionnées, sélectionnez l’étiquette que vous souhaitez attribuer à l’image ou aux images.

  6. Choisissez Attribuer pour attribuer l’étiquette à l’image.

    Boîte de dialogue expliquant comment attribuer l'étiquette « arrière-cour » au niveau de l'image aux images sélectionnées à l'aide du bouton Attribuer.

  7. Répétez l’étiquetage jusqu’à ce que chaque image soit annotée avec les étiquettes requises.

  8. Choisissez l’onglet Test.

  9. Répétez les étapes pour attribuer des étiquettes au niveau de l’image aux images du jeu de données de test.

Étape 7 : Entraîner votre modèle

Suivez les étapes suivantes pour entraîner votre modèle. Pour plus d’informations, consultez Entraînement d’un modèle Étiquettes personnalisées Amazon Rekognition.

Pour entraîner votre modèle (console)

  1. Sur la page Ensemble de données, sélectionnez Entraîner un modèle.

    Bouton Train model pour entraîner un modèle d'apprentissage automatique sur le jeu de données du projet en cours.

  2. Sur la page Entraîner un modèle, choisissez Entraîner un modèle. L’Amazon Resource Name (ARN) de votre projet se trouve dans la zone d’édition Choisir un projet.

    Page de configuration du modèle de train affichant le champ de saisie ARN du projet, la section Tags vide et le bouton Train Model.

  3. Dans la boîte de dialogue Voulez-vous entraîner votre modèle ?, choisissez Entraîner un modèle.

    Boîte de dialogue demandant « Voulez-vous entraîner votre modèle ? » avec les boutons Annuler et Train model.

  4. Dans la section Modèles de la page du projet, vous pouvez voir que l’entraînement est en cours. Vous pouvez vérifier le statut de l’entraînement dans la colonne Model Status de la version du modèle. L’entraînement d’un modèle peut nécessiter un certain temps.

    État du modèle indiquant « TRAINING_IN_PROGRESS » indiquant que le modèle est en cours d'entraînement.

  5. Une fois l’entraînement terminé, choisissez le nom du modèle. L’entraînement est terminé lorsque le statut du modèle est TRAINING_COMPLETED.

    Informations sur le modèle de Rooms 19 indiquant le statut TRAINING_COMPLETED indiquant que le modèle est prêt.

  6. Cliquez sur le bouton Évaluer pour voir les résultats de l’évaluation. Pour plus d’informations sur l’évaluation d’un modèle, consultez Amélioration d’un modèle entraîné Étiquettes personnalisées Amazon Rekognition.

  7. Choisissez Afficher les résultats des tests pour visualiser les résultats des images des tests. Pour plus d’informations, consultez Métriques d’évaluation du modèle.

    Résultats de l'évaluation du modèle indiquant le score F1, la précision moyenne et le rappel global pour 10 étiquettes d'images avec des mesures de performance par étiquette.

  8. Après avoir consulté les résultats des tests, choisissez le nom du modèle pour revenir à la page du modèle.

    Interface affichant les résultats des tests d'un modèle entraîné sur un ensemble de données d'images de la cour arrière et de la cour avant, avec affichage des étiquettes prédites et des scores de confiance.

Étape 8 : Démarrer votre modèle

Au cours de cette étape, vous allez démarrer votre modèle. Une fois votre modèle démarré, vous pouvez l’utiliser pour analyser des images.

La durée de fonctionnement de votre modèle vous est facturée. Arrêtez votre modèle si vous n’avez pas besoin d’analyser d’images. Vous pourrez le redémarrer ultérieurement. Pour plus d’informations, consultez Exécution d’un modèle Étiquettes personnalisées Amazon Rekognition entraîné.

Pour démarrer votre modèle

  1. Choisissez l’onglet Utiliser le modèle sur la page du modèle.

  2. Dans la section Démarrer ou arrêter le modèle, procédez comme suit :

    1. Sélectionnez Démarrer.

      Interface utilisateur affichant le bouton Démarrer le modèle et les options permettant de démarrer ou d'arrêter un modèle d'apprentissage automatique pour détecter des étiquettes personnalisées. Sélectionnez le nombre d'unités d'inférence pour augmenter le débit.

    2. Dans la boîte de dialogue Démarrer le modèle, choisissez Démarrer.

  3. Patientez jusqu’à l’exécution du modèle. Le modèle est en cours d’exécution lorsque le statut indiqué dans la section Démarrer ou arrêter le modèle est En cours d’exécution.

    Indicateur d'état de fonctionnement avec un cercle vert indiquant que le modèle est en cours d'exécution, et options permettant d'arrêter le modèle ou de modifier le nombre d'unités d'inférence.

Étape 9 : Analyser une image avec votre modèle

Vous analysez une image en appelant l'DetectCustomLabelsAPI. Au cours de cette étape, vous utilisez la commande detect-custom-labels AWS Command Line Interface (AWS CLI) pour analyser un exemple d'image. Vous obtenez la AWS CLI commande depuis la console Amazon Rekognition Custom Labels. La console configure la AWS CLI commande pour utiliser votre modèle. Il vous suffit de fournir une image stockée dans un compartiment Amazon S3.

Note

La console fournit également un exemple de code Python.

Le résultat de detect-custom-labels inclut la liste des étiquettes détectées dans l’image, les cadres de délimitation (si le modèle recherche les emplacements d’objets) et le score de confiance du modèle concernant la précision des prédictions.

Pour plus d’informations, consultez Analyse d’une image avec un modèle entraîné.

Pour analyser une image (console)

  1. Si ce n'est pas déjà fait, configurez le AWS CLI. Pour obtenir des instructions, veuillez consulter Étape 4 : Configuration des AWS SDK AWS CLI et.

  2. Choisissez l’onglet Utiliser le modèle, puis Code de l’API.

    Interface affichant les détails du modèle avec option permettant d'afficher le nom de la ressource Amazon (ARN) et le code API pour utiliser le modèle.

  3. Choisissez Commande de l’interface de ligne de commande AWS.

  4. Dans la section Analyser l'image, copiez la AWS CLI commande qui appelledetect-custom-labels.

    Commande AWS CLI pour analyser une image à l'aide d'un modèle personnalisé, indiquant l'ARN du projet et les espaces réservés au nom du bucket à remplacer.

  5. Chargez une image dans un compartiment Amazon S3. Pour en savoir plus, consultez Chargement d’objets dans Amazon S3 dans le Guide de l’utilisateur Amazon Simple Storage Service. Si vous utilisez des images du projet Pièces, utilisez l’une des images que vous avez déplacées dans un dossier distinct à l’Étape 1 : Collecter vos images.

  6. À l'invite de commande, entrez la AWS CLI commande que vous avez copiée à l'étape précédente. Elle doit ressembler à l’exemple suivant.

    La valeur de --project-version-arn doit être l’Amazon Resource Name (ARN) de votre modèle. La valeur de --region doit être la région AWS dans laquelle vous avez créé le modèle.

    Remplacez MY_BUCKET et PATH_TO_MY_IMAGE par le compartiment Amazon S3 et l’image que vous avez utilisés à l’étape précédente.

    Si vous utilisez le custom-labels-accessprofil pour obtenir des informations d'identification, ajoutez le --profile custom-labels-access paramètre.

    aws rekognition detect-custom-labels \
  --project-version-arn "model_arn" \
  --image '{"S3Object": {"Bucket": "MY_BUCKET","Name": "PATH_TO_MY_IMAGE"}}' \
  --region us-east-1 \
  --profile custom-labels-access

    La sortie JSON de la commande AWS CLI doit ressembler à ce qui suit. Name est le nom de l’étiquette au niveau de l’image détectée par le modèle. Confidence (0-100) est le niveau de confiance du modèle dans l’exactitude de la prédiction.

    {
    "CustomLabels": [
        {
            "Name": "living_space",
            "Confidence": 83.41299819946289
        }
    ]
}

  7. Continuez à utiliser le modèle pour analyser d’autres images. Arrêtez le modèle si vous ne l’utilisez plus.

Étape 10 : Arrêter votre modèle

Au cours de cette étape, vous allez arrêter d’exécuter votre modèle. La durée de fonctionnement de votre modèle vous est facturée. Si vous avez fini d’utiliser le modèle, vous devez l’arrêter.

Pour arrêter votre modèle

  1. Dans la section Démarrer ou arrêter le modèle, choisissez Arrêter.

    Bouton d'arrêt pour arrêter le modèle en cours d'exécution et désactiver les unités d'inférence.

  2. Dans la boîte de dialogue Arrêter le modèle, entrez stop pour confirmer que vous souhaitez arrêter le modèle.

    Champ de saisie avec « stop » saisi, et bouton Stop pour confirmer l'arrêt d'un modèle.

  3. Choisissez Arrêter pour arrêter votre modèle. Le modèle est arrêté lorsque le statut indiqué dans la section Démarrer ou arrêter le modèle est Arrêté.

    Indicateur d'état arrêté expliquant que le modèle n'est pas en cours d'exécution et doit être démarré à l'aide du bouton Démarrer ou d'un exemple de code.