Ressources numériques en sciences humaines et sociales OpenEdition Nos plateformes OpenEdition Books OpenEdition Journals Hypothèses Calenda Bibliothèques OpenEdition Freemium Suivez-nous

Tutoriel Callico – Pictoria

Tutoriel consacré à l’application d’annotation Callico, réalisé par Pierre Husson, Fantin Le Ber et Mathieu Taybi

Présentation

Callico est une application open source développée par l’entreprise Teklia permettant d’organiser des campagnes collaboratives d’annotations d’images, en particulier pour l’entraînement de modèles d’intelligence artificielle.

Callico accompagne la plateforme Arkindex. Arkindex est consacré au traitement et à l’analyse des images à l’aide d’outils d’intelligence artificielle et peut utiliser les images annotées sur Callico pour entraîner des modèles ou y appliquer des traitements.

Ce tutoriel décrit uniquement les étapes à suivre dans Arkindex pour importer les images et configurer les paramètres d’annotation requis par Callico. Pour une utilisation plus avancée de la plateforme Arkindex, nous vous invitons à consulter notre autre tutoriel et la documentation produite par Teklia

L’instance Callico fournie par Pictoria est disponible à cette adresse : https://pictoria-annotation.huma-num.fr/projects/ .

1. Import des images dans Arkindex

Avant d’utiliser Callico, les images à annoter doivent d’abord être importées dans Arkindex. Les classes d’annotations utilisées sont également paramétrées dans cette plateforme. Voici le lien de l’instance PictorIA d’Arkindex : https://pictoria-doc.huma-num.fr/

Accueil d'arkindex, le bouton new project est entouré en rouge
Img. 1 : Accueil d’Arkindex.

La première étape consiste à créer un nouveau projet pour rassembler les images. Pour cela il suffit d’appuyer sur le bouton “New Project” en haut à droite (image 1). Le projet ne contient alors aucune image.

Accueil d'un projet arkindex, le bouton Import/export est entouré en rouge
Img. 2 : Le projet « Découverte », pour l’instant entièrement vide.

Dans le menu « import/Export » en haut à droite (image 2), cliquer sur « Import Files ».

Ecran d'import des images d'Arkindex, le bouton select files est entouré en rouge
Img. 3 : Panneau d’import des images.

Vous pouvez importer depuis un URL ou importer depuis votre ordinateur. Dans le cadre de notre tutoriel nous importerons depuis notre ordinateur, en utilisant le bouton « Select Files ». Une fois que le dossier souhaité pour l’import est sélectionné, des paramètres d’import apparaissent (image 4).

Ecran d'import des images d'arkindex
Img. 4 : Sélection des paramètres lors de l’import des images.

Sur cet écran, on peut personnaliser certains « tags » par défaut associés aux fichiers importés. Dans la majorité des cas, les éléments « page » et « folder » sont les plus appropriés, même pour des corpus composés uniquement d’images. Voir la documentation Arkindex à ce sujet : https://doc.arkindex.org/project/element/ et https://doc.arkindex.org/project/type/ .

2. Création des classes et des éléments dans Arkindex

Pour préparer l’annotation des images, il faut définir les classes et/ou les éléments qui seront utilisés. Cette étape s’effectue toujours dans la plateforme Arkindex, dans le menu d’édition du projet. On accède à ce menu en cliquant sur le crayon à côté du titre du projet, en haut à gauche de l’écran, sous le logo Arkindex (image 5).

Ecran d'accueil d'un projet arkindex, le bouton crayon, qui permet de modifier un projet, est entouré en rouge
Img. 5 : L’écran d’accueil du projet, avec le dossier d’images importées. 
Ecran de gestion d'un projet arkindex, les onglets Elements et Classes sont entourés en rouge
Img. 6 : Le menu d’édition du projet

Ici il y a deux onglets qui sont utiles dans l’annotation dans Callico :

  • L’onglet « éléments » définit quels objets peuvent être identifiés, segmentés et annotés dans les images qu’on a importées. Voici quelques exemples :
    • pour des documents textuels : des éléments peuvent correspondre à des paragraphes, des lignes, des mots
    • pour un recueil d’images ou de photographies (avec des marges), les éléments peuvent être les images/photographies à isoler
    • pour des photographies/des images, ces éléments peuvent être des personnes, des objets, des parties pertinentes à identifier

L’onglet « classes » permet de faire de la classification, en déterminant le(s) type(s) du document ou de l’élément

Pour ajouter un élément ou une classe il suffit de remplir les champs de texte au bas de la liste préexistante, et de cliquer sur le bouton « + » qui se dégrisera alors.

Dans notre cas, on a ajouté deux classes (donc applicables à un document) pour désigner si la page est majoritairement occupée par du texte ou par des illustrations. Nous avons également créé des éléments pour annoter les personnes représentées selon leur genre, en plus de la liste d’éléments par défaut visibles sur l’image 7.

Onglet Elements de l'écran de gestion de projet Arkindex
Img. 7 : l’onglet de gestion des éléments (les couleurs d’affichage sont utiles sur Arkindex mais ne seront pas transmises à Callico).
Onglet Classe de l'écran de gestion de projet Arkindex
Img. 8 : l’onglet de gestion des classes

Après avoir créé les éléments et classes utilisés lors de l’annotation, copiez l’identifiant du projet (« Projet ID ») pour lier votre projet Arkindex à l’application Callico (image 9).

Gros plan sur le haut d'une page d'arkindex, le bouton "copier l'ID du projet" est entouré.
Img. 9 : Copier le « Project ID » sur Arkindex

3. Création du projet Callico

Il faut se rendre sur l’application Callico pour créer la campagne d’annotation. Voici le lien de l’instance PictorIA de Callico : https://pictoria-annotation.huma-num.fr/

Pages d'accueil de callico, le bouton créer un projet est entouré
Img. 10 : Accueil de Callico

Il faut d’abord créer un projet Callico en appuyant sur le bouton « Créer un projet » en haut à droite (image 10). Les projets existants s’affichent dans l’onglet « Mes projets ».

Lors de la création du projet (image 11), il faut renseigner un nom de projet Callico, le fournisseur de l’instance Arkindex (par exemple Arkindex Pictoria dans notre cas), et l’identifiant du projet Arkindex (Project ID) dans lequel on a préparé les images (étape 1), les classes et les éléments (étape 2). Le Project ID a été copié à la fin de l’étape 2.

Ecran de création d'un projet Callico, la zone ou rentrer l'ID de projet arkindex est entourée en rouge
Img. 11 : Création du projet Callico.

4. Import des données depuis Arkindex

ecran de gestion de projet Callico, le bouton "importer depuis arkindex" est entouré en rouge
Img. 12 : Accueil du projet.

Le menu « Importer depuis Arkindex » permet d’importer les images, les classes, les éléments et les métadonnées de notre projet Arkindex sur Callico. Par défaut, lorsqu’on lance l’import, toutes ces données sont importées lors de la création du projet Callico, mais on peut définir quels dossiers d’images ou quels types d’annotations inclure ou exclure lors du processus. La page du processus d’import ne se rafraîchit pas automatiquement à la fin de l’opération, il est donc nécessaire de l’actualiser régulièrement manuellement pour connaître son avancement. Le seul champ obligatoire est le « nom de l’import », ce nom n’a pas d’importance pour le projet.

Ecran d'import des images, les images sont en cours d'import.
Img. 13 : Le processus d’import.

5. Ajout de collaboratrices et collaborateurs

L’étape suivante consiste à inviter les annotateurs ou annotatrices qui travailleront sur ce projet. Pour cela il faut se rendre dans le menu « Inviter des utilisateurs ». Un lien est généré et il peut être envoyé aux personnes concernées.

Ecran de gestion de projet Callico, le bouton "Inviter des utilisateurs" est entouré en rouge
Img. 14 : Inviter des utilisateurs

6. Création d’une campagne d’annotations

Une fois que les utilisateurs ont rejoint le projet, il faut créer la campagne d’annotation.

Ecran de gestion de projet Callico, le bouton "Créer" de la section campagne est entouré en rouge
Img. 15 : Créer une campagne
Ecran de création d'une campagne Callico, le menu déroulement du mode d'annotation est encadré en rouge
Img. 16 : Choix du mode d’annotation

Six types ou “mode” d’annotations différentes sont proposées :

  • « Transcription » : pour la transcription textuelle
  • « Entité » : pour annoter des entités textuelles dans un texte déjà transcrits (ex : noms de personnes, dates, lieux, rôles,…)
  • « Formulaire d’entité » : pour annoter les entités textuelles présents dans une images à l’aide d’un formulaire à remplir
  • « Éléments » : annotations dans l’image à l’aide de boîtes rectangulaires ou polygonales
  • « Regroupement d’éléments » : utilisé afin de grouper ensemble des éléments (ex : utile pour rassembler plusieurs lignes en un même paragraphe)
  • « Classification » : pour catégoriser selon les classes du projet les pages ou les éléments d’une page dans un document

Pour en apprendre davantage sur ces six modes de campagnes, nous vous invitons à consulter la documentation Callico : https://doc.callico.eu/campaigns/configure/. Plusieurs campagnes avec des modes différents peuvent être créées pour le même corpus d’images. Dans ce tutoriel, nous prenons pour exemple le mode « éléments », qui permet de délimiter des zones sur une image, et de les associer à des éléments Arkindex. C’est le format d’annotation adapté pour ensuite travailler avec des algorithmes de segmentation. 

7. Configuration de la campagne

Une fois la campagne créée, une page de configuration apparaît (image 17). 

  • La « Description » permet de renseigner les consignes d’annotation.
  • Le « Nombre de tâches à assigner par volontaire » désigne le nombre de pages à annoter que recevront chaque participant.e 
  • Le « Nombre d’assignation pour les tâches disponibles » correspond au nombre de fois qu’une même image peut être annotée par des personnes différentes
  • Les « Éléments » utilisés lors de l’annotation. 

Tous ces éléments sont éditables à tout moment, même après la création de la campagne.

Ecran de configuration de la campagne
 Img. 17 : la configuration de la campagne.

8. Assignation des tâches aux annotateurs et annotatrices

Une fois la campagne créée, il faut créer des « tâches », c’est-à-dire assigner les images aux annotateurs et annotatrices. Cliquez sur le bouton « Créer » de la section « tâches » sur la gauche dans le menu de la campagne (image 18). Ce menu de la campagne est accessible sur l’accueil du projet. 

Ecran de gestion de la campagne, le bouton "créer" de la section tâches est entouré en rouge
Img. 18 : Menu de la campagne

Le menu de création de tâches (image 19) permet de configurer :

  • sur quel type d’élément l’annotation est effectuée (généralement sur la page si c’est à l’échelle d’une image)
  • les annotateurs ou annotatrices à qui les images sont confiées
  • comment les images sont attribuées (aléatoire ou autre)
  • les catégories d’éléments à utiliser pour annoter
  • le nombre maximum de tâches par personne (dans la limite du nombre d’images disponibles)

L’outil de prévisualisation offre un aperçu de l’interface d’annotation que verront les contributeurs chargés d’effectuer la tâche.

Ecran de création de tâches
Img. 19 : La création de tâches

9. Annotation des images

Les personnes à qui l’on a attribué les tâches peuvent ensuite annoter. 

Dans le mode « Éléments », que nous utilisons comme exemple, elles peuvent tracer des rectangles et des polygones, en sélectionnant la classe utilisée puis en traçant la forme. Le bouton « Soumettre » valide la tâche et la propose au modérateur. Le bouton « Ignorer la tâche » permet de passer à la tâche suivante sans effectuer d’annotation.

Ecran d'annotation, une image de soldats issues d'un journal des années 1910 est annoté à l'aide de "bounding box" et de polygones
Img. 20 : Interface de la personne chargée de l’annotation.

10. Modération de l’annotation

Les modérateurs et modératrices de la campagne peuvent consulter le travail des annotateurs et annotatrices grâce à l’onglet « lister » des tâches de la campagne (image 21), puis en cliquant sur le bouton « modérer » (image 22). 

Ecran de gestion de la campagne, le bouton "lister" de la section tâches est entouré en rouge
Img. 21 : Le bouton Lister dans la page de la campagne d’annotation
Ecran de liste des tâches de la campagne
Img. 22 : L’interface « Lister »
Ecran de correction des annotations, une page de journal segmentée à l'aide de bounding boxes s'affiche en face d'une liste de types d'éléments
Img. 23 : modération d’une image annotée.

La section de modération permet de voir, d’ajouter, de modifier, de supprimer, d’accepter ou de rejeter des annotations.

11. Exporter les annotations vers Arkindex

Une fois la campagne d’annotation terminée, les données peuvent être exportées vers Arkindex, grâce à la fonction « Exporter vers arkindex » disponible dans le menu vertical sur la gauche de la page de la campagne. 

Ecran de gestion des campagnes, l'option "Vers Arkindex" est entourée en rouge
Img. 24 : Bouton exporter vers Arkindex dans la page campagne.

Callico permet aussi d’exporter les campagnes en .csv ou .xlsx, mais ces exports se contentent des informations relatives à la campagne d’annotations et n’incluent pas les annotations réalisées. 

Des options pour personnaliser les données qu’on veut exporter ou non sont disponibles.

Ecran d'export des annotations vers arkindex

Img. 25 : la page d’export vers Arkindex. 

12. Téléchargement des données sur Arkindex

Les annotations peuvent être téléchargées sur Arkindex dans l’onglet Import/export (sous forme de base de données,…).

Il est également possible de continuer à travailler avec les images manuellement ou à l’aide des « workers » (contenant des modèles d’IA) intégrés à la plateforme. Pour plus d’informations sur Arkindex, voir le tutoriel que nous avons réalisé au sujet de la plateforme


OpenEdition vous propose de citer ce billet de la manière suivante :
fleber (25 août 2025). Tutoriel Callico – Pictoria. Consortium-HN pictorIA. Consulté le 11 novembre 2025 à l’adresse https://pictoria.hypotheses.org/4707


Vous aimerez aussi...