Skip to main content

Assistant Agouti - Manuel d’utilisation

Pour les bénévoles · Version 1.1.6 · 9 octobre 2026

Sommaire du manuel

Préparer les photos et vidéos d’une caméra, les envoyer vers Agouti et retrouver les données du projet Hérisson : ce guide vous accompagne dans les principales opérations.

Le parcours en trois étapes

  1. Source média : choisir le dossier et vérifier les dates, la position et, si nécessaire, préparer les images issues des vidéos.
  2. Cible Agouti : choisir l’emplacement et la caméra, puis vérifier la période du déploiement.
  3. Exécution : envoyer le lot et attendre la confirmation de réussite.
Votre accèsLes possibilités
Token nominatifPréparer et transférer les médias ; consulter le journal.
Accès avancé, avec une clé APIMême parcours, plus consultation des déploiements, emplacements, observations et statistiques.

Un média est une photo ou une vidéo. Un lot regroupe les fichiers à envoyer ensemble. Un déploiement correspond à l’utilisation d’une caméra sur un emplacement pendant une période donnée.

Version de référence : 1.1.6. Captures prises dans l’interface réelle de cette version, avec des réponses de démonstration et des données fictives. Aucun transfert réel ni suppression de photos n’a été effectué pour réaliser ce guide.

1. Se connecter

Retour au sommaire
  1. Dans Connexion, choisissez Accès transfert photos si vous disposez d’un token fourni par le groupe.
  2. Collez votre token personnel, puis cliquez sur Activer. Une fois l’accès validé, ouvrez Upload.
À la première ouverture, choisissez un mode d’accès avant de saisir vos informations.
À la première ouverture, choisissez un mode d’accès avant de saisir vos informations.

Sans token, contactez gt.herissons@natagora.be. Ne partagez pas votre token : il est nominatif. L’application conserve la configuration pour les prochaines ouvertures ; Déconnexion permet de retirer cet accès.

L’accès avancé

Il s’adresse aux personnes disposant d’une clé API Agouti personnelle. Sélectionnez Accès avancé et renseignez les paramètres demandés. Les onglets de consultation deviennent disponibles après connexion.

En cas de refus ou d’indisponibilité, lisez le message avant de modifier le token : un réseau ou un proxy peut bloquer le service d’activation, même avec un token valide.

2. Choisir et analyser les médias

Retour au sommaire

Préparez de préférence un dossier correspondant à une caméra, un emplacement et une période. Gardez une sauvegarde des originaux. Dans Étape 1 — Source média, cliquez sur Choisir… et sélectionnez ce dossier.

Le résumé indique les médias détectés et si leur date peut être utilisée.
Le résumé indique les médias détectés et si leur date peut être utilisée.

Les sous-dossiers sont également parcourus. Les dossiers THUMB et les fichiers dont le nom contient THUMB sont ignorés pour éviter d’envoyer des miniatures. Le compteur suit l’analyse ; Annuler l’analyse arrête le scan, sans supprimer vos fichiers.

Que vérifier dans le résultat ?

  1. Le nombre de photos et de vidéos correspond-il au contenu attendu ?
  2. La date est-elle exploitable ? Les informations de prise de vue sont prioritaires ; la date de copie du fichier sur l’ordinateur n’est pas une référence fiable.
  3. Une alerte rouge signale-t-elle une date future ? Vérifiez le réglage de la caméra, notamment une éventuelle confusion jour/mois.

Une date lisible n’est pas forcément une date correcte. Les étapes suivantes apparaissent lorsque le lot est prêt. Si aucun fichier n’a de date exploitable, l’envoi ne peut pas continuer.

3. Vérifier et corriger les dates

Retour au sommaire

Certaines photos ne contiennent pas de date de prise de vue interne. Si leur nom comporte une date et une heure utilisables, l’application peut créer des copies datées. Exemple : CAM_20260915_210000.JPG correspond au 15 septembre 2026 à 21:00:00.

Une correction peut être proposée à partir du nom des fichiers.
Une correction peut être proposée à partir du nom des fichiers.

Cliquez sur Créer des copies avec date/heure corrigée et choisissez le dossier de destination. Préférez un dossier distinct. Les originaux restent inchangés ; les copies préparées sont utilisées pour le transfert. Attendez la confirmation avant de poursuivre.

Seulement si l’horloge de la caméra est incorrecte

  1. Vérifiez que l’heure de l’ordinateur est correcte. Cliquez sur Figer l’heure réelle et relevez, au même instant, l’heure affichée par la caméra.
  2. Renseignez Heure caméra, avec la date et les secondes. Cliquez sur Appliquer le décalage caméra : l’heure réelle figée ne change pas.
  3. Créez les copies corrigées ou générez les images vidéo après cette validation. Le décalage peut aussi corriger une erreur de plusieurs jours.
Ici, l’horloge de la caméra retarde de deux minutes : les prises de vue sont décalées en conséquence.
Ici, l’horloge de la caméra retarde de deux minutes : les prises de vue sont décalées en conséquence.

N’appliquez pas un décalage deviné si la caméra a été remise à l’heure depuis les prises de vue. Les fichiers sans date récupérable peuvent être exclus : vous pouvez envoyer les fichiers utilisables, après avoir vérifié le nombre d’exclus.

4. Préparer les vidéos

Retour au sommaire

Si le dossier contient des vidéos, un bloc de traitement apparaît à l’étape 1. Le module vidéo n’est nécessaire que pour ces fichiers. S’il manque, l’application propose son téléchargement : une connexion Internet est alors requise.

L’intervalle d’extraction est exprimé en secondes ; l’estimation indique le nombre d’images attendu.
L’intervalle d’extraction est exprimé en secondes ; l’estimation indique le nombre d’images attendu.
  1. Choisissez Convertir les vidéos en images horodatées, sauf consigne différente du groupe.
  2. Vérifiez l’intervalle d’extraction. Un intervalle plus court produit davantage d’images.
  3. Si nécessaire, appliquez d’abord le décalage de l’horloge caméra. Cliquez ensuite sur Générer les images vidéo.
La fenêtre de progression montre que la génération est en cours.
La fenêtre de progression montre que la génération est en cours.

Les vidéos originales sont conservées. La date des images générées provient des informations encodées dans la vidéo ou d’un nom de fichier exploitable, pas de la date de création des nouvelles images sur l’ordinateur.

Attendez la fin du traitement et sa confirmation. Si vous changez ensuite le décalage caméra, regénérez les images. L’option Conserver les vidéos telles quelles est également disponible ; suivez les consignes du projet.

5. Choisir la cible Agouti

Retour au sommaire

Lorsque les médias sont prêts, Étape 2 — Cible Agouti devient accessible. Choisissez l’emplacement où la caméra était installée et la caméra utilisée. Vérifiez soigneusement ces deux choix avant d’envoyer.

Exemple de cible prête : emplacement, caméra, période et contrôles de préparation.
Exemple de cible prête : emplacement, caméra, période et contrôles de préparation.

Les dates de début et de fin sont préremplies à partir des médias. Elles ne correspondent pas forcément aux dates réelles d’installation et de récupération : ajustez-les à partir de vos notes de terrain si vous connaissez la période complète.

En Wallonie, Heure d’été correspond à UTC+2 ; lorsqu’elle est décochée, l’heure d’hiver correspond à UTC+1. Le choix est estimé à partir de la date des prises de vue : vérifiez-le. Il est distinct du décalage caméra ; n’ajoutez pas vous-même une ou deux heures aux photos pour cette raison.

Le traitement IA est décoché par défaut. Ne l’activez que si cela est souhaité pour ce lot. Renseignez le nourrissage et les notes si nécessaire. Un déploiement existant en attente de médias peut être proposé ; un déploiement déjà finalisé n’est pas rouvert automatiquement.

6. Vérifier l’emplacement

Retour au sommaire

Si des photos contiennent une position GPS utilisable, Utiliser cette position aide à choisir un emplacement existant ou à préparer sa création. Les positions 0,0 sont ignorées. La position proposée résume les positions valides du groupe principal, mais reste approximative.

Détail de la fenêtre d’emplacement : coordonnées, carte et emplacement existant à proximité.
Détail de la fenêtre d’emplacement : coordonnées, carte et emplacement existant à proximité.
  1. Vérifiez la position sur la carte. Vous pouvez passer de Plan OSM à Vue satellite.
  2. Réutilisez l’emplacement existant s’il correspond au véritable lieu de pose : évitez de créer un doublon simplement à cause d’une dérive GPS.
  3. Pour un nouveau lieu, renseignez la commune, la rue et le numéro, puis le complément utile. Une saisie de coordonnées ou un clic sur la carte ajuste le repère.

Après validation, contrôlez Emplacement cible à l’étape 2. Si un emplacement proche a été réutilisé, un retour visuel le confirme. En l’absence de GPS, choisissez le lieu à partir de vos informations de terrain.

7. Plusieurs lieux ou une nouvelle caméra

Retour au sommaire

Une alerte sur plusieurs positions GPS

La vérification GPS présente les groupes de positions et leurs périodes pour aider à comprendre le lot.
La vérification GPS présente les groupes de positions et leurs périodes pour aider à comprendre le lot.

Des positions très éloignées peuvent révéler des photos provenant de plusieurs installations. Ouvrez Vérifier les emplacements et comparez les dates avec vos notes. L’alerte ne crée pas automatiquement plusieurs déploiements.

Si plusieurs lieux sont réellement mélangés, séparez les fichiers en dossiers par emplacement et période, puis envoyez chaque lot avec sa bonne cible. Si toutes les photos proviennent du même lieu, vérifiez qu’il s’agit d’une dérive GPS avant de poursuivre. Les photos sans GPS doivent aussi être affectées à partir des informations de terrain.

Ajouter une caméra cible

Les informations présentes dans les photos peuvent préremplir certains champs de la caméra.
Les informations présentes dans les photos peuvent préremplir certains champs de la caméra.

Cliquez sur Ajouter à côté de Caméra cible uniquement si elle n’existe pas déjà. Vérifiez le nom, la marque, le modèle et le numéro de série proposés : toutes les caméras ne fournissent pas ces informations. Utilisez le nom connu dans l’inventaire du groupe.

8. Envoyer et vérifier le résultat

Retour au sommaire

À l’étape 3, vérifiez les contrôles puis cliquez sur Envoyer le lot vers Agouti. Si des fichiers sont exclus, lisez leur nombre avant de confirmer. Gardez la carte mémoire et le réseau disponibles jusqu’à la fin.

Le suivi affiche le nombre envoyé, le temps écoulé et une estimation du temps restant.
Le suivi affiche le nombre envoyé, le temps écoulé et une estimation du temps restant.

Masquer la progression ferme seulement le suivi : le transfert continue. Réduire l’application la place dans la barre des tâches, sans arrêter l’envoi. Afficher la progression permet de retrouver la fenêtre. L’estimation peut varier avec la vitesse du réseau ; attendez aussi la finalisation du déploiement.

Le message de réussite confirme la fin du transfert et identifie le déploiement.
Le message de réussite confirme la fin du transfert et identifie le déploiement.

En cas d’anomalies, distinguez fichiers transmis, acceptés, refusés et doublons : ils ne signifient pas tous la même chose. Consultez le journal avant de renvoyer tout le lot. Un transfert réussi ne signifie pas que les observations ont été examinées ou identifiées.

9. Conserver ou supprimer les photos source

Retour au sommaire

Après un transfert réussi et un déploiement correctement finalisé, l’application peut proposer de supprimer les photos transférées du dossier source. Cette opération est facultative : les photos restent conservées tant que vous ne demandez rien.

Avant toute suppression, vérifiez le dossier, le nombre de photos et les fichiers concernés.
Avant toute suppression, vérifiez le dossier, le nombre de photos et les fichiers concernés.
  1. Conservez une sauvegarde indépendante si ces photos constituent votre seule copie de terrain.
  2. Si vous souhaitez nettoyer la carte, ouvrez Supprimer les photos transférées du dossier source… et vérifiez la liste proposée.
  3. Choisissez Conserver les photos pour ne rien effacer, ou Confirmer la suppression définitive après vérification.

Attention : la suppression est définitive, notamment sur une carte mémoire ; ne comptez pas sur la corbeille pour les récupérer. Seules les photos dont le transfert est confirmé et qui passent les contrôles de sécurité sont proposées. Les vidéos, miniatures, fichiers exclus ou non confirmés ne doivent pas être supprimés par cette opération.

Pour le prochain lot, choisissez à nouveau le dossier source et vérifiez la nouvelle cible. Ne réutilisez pas sans contrôle l’emplacement d’une installation précédente.

10. Consulter les déploiements

Retour au sommaire

Les fonctions de consultation présentées dans ce chapitre et les deux suivants sont réservées à l’accès avancé. L’onglet Déploiements affiche d’abord les données disponibles, puis actualise la liste. Sélectionnez une ligne pour afficher son résumé.

La liste et le résumé permettent de retrouver une période, un lieu et, lorsqu’il est fourni, le créateur du déploiement.
La liste et le résumé permettent de retrouver une période, un lieu et, lorsqu’il est fourni, le créateur du déploiement.
Pourcentage inspectéLecture du statut
0 %Déploiement non examiné
Entre 0 et 100 %Déploiement en cours d’examen
100 %Déploiement totalement analysé

Ce pourcentage concerne l’examen des séquences, pas le transfert des photos. Les états techniques, comme l’attente de médias, peuvent également apparaître. Le nom du créateur dépend des informations transmises par Agouti.

Annoter ce déploiement ouvre dans Agouti une séquence à examiner ; le bouton devient indisponible lorsque l’examen est terminé. Un double-clic sur un déploiement ouvre sa page Agouti.

Autres accès avancés

Emplacements permet de consulter les lieux et leur carte. Prêt caméras et Gestion tokens donnent accès aux sites dédiés du groupe, selon vos droits : natagora-cameras.tunza.fr et natagora-agouti.tunza.fr.

11. Filtrer les observations et exporter

Retour au sommaire
Les filtres s’appliquent à la liste des observations ; une sélection affiche les détails associés.
Les filtres s’appliquent à la liste des observations ; une sélection affiche les détails associés.
  1. Utilisez la recherche et les filtres pour retrouver les observations d’un lieu ou d’une période.
  2. Choisissez Avec espèce identifiée ou Sans espèce identifiée selon votre besoin. Un tiret à la place de l’espèce indique une absence d’identification ; ce n’est pas forcément une image vide.
  3. Vous pouvez aussi choisir Hérisson uniquement ou Avec média lié.
Exemple : ne garder que les observations dont l’espèce n’est pas identifiée.
Exemple : ne garder que les observations dont l’espèce n’est pas identifiée.

Exporter le filtre (CSV) exporte les données correspondant aux filtres, pas seulement la page visible. Le fichier peut être ouvert dans Excel ou un autre tableur. Il s’agit d’un CSV, et non d’un classeur Excel avec mise en forme.

Voir les médias et examiner dans Agouti

Sélectionnez une observation : les médias associés sont chargés à la demande pour ne pas alourdir toute la liste. Ouvrir dans l’application affiche la photo dans une fenêtre interne. Leur disponibilité dépend des liens et des autorisations Agouti.

Un double-clic sur une observation ouvre la séquence d’annotation dans Agouti. Ne confondez pas ce lien d’examen externe avec le visualiseur de photo intégré.

12. Lire les statistiques avec prudence

Retour au sommaire
Les indicateurs sont regroupés par présence, activité, abondance apparente et effort.
Les indicateurs sont regroupés par présence, activité, abondance apparente et effort.

Présence : où et quand le hérisson est détecté. Activité : combien de séquences ou passages sont enregistrés. Abondance apparente : notamment le maximum d’individus visibles sur une séquence. Effort : durée de surveillance exprimée en nuits-caméra et taux de détection standardisé.

Une nuit-caméra correspond à une caméra en fonctionnement pendant une nuit. Un taux pour 10 nuits-caméra sert à comparer des durées de surveillance différentes ; ce n’est pas un nombre réellement observé. L’indicateur pour 100 nuits-caméra n’est affiché qu’à partir de 100 nuits-caméra.

La carte peut être agrandie et son indicateur modifié ; la taille des points dépend du choix effectué.
La carte peut être agrandie et son indicateur modifié ; la taille des points dépend du choix effectué.

Dans le mode hérisson, les lieux sans séquence hérisson ne sont pas représentés. Un grand point signifie davantage d’activité selon l’indicateur choisi, pas nécessairement davantage d’animaux différents.

Le même animal peut passer plusieurs fois. Ces résultats ne donnent donc pas un effectif d’individus uniques. Vérifiez aussi les périodes de déploiement avant de comparer les sites et actualisez les données après des annotations dans Agouti.

13. Aide, mises à jour et checklist

Retour au sommaire

Avant chaque envoi

  1. Le lot correspond à la bonne caméra, au bon lieu et à la bonne période.
  2. Les dates, le décalage éventuel et le choix été/hiver ont été vérifiés.
  3. Les fichiers exclus sont compris ; les copies ou images vidéo nécessaires sont prêtes.
  4. Les originaux sont sauvegardés et la connexion réseau est disponible.

Si quelque chose ne fonctionne pas

Analyse longue : surveillez le compteur et utilisez Annuler l’analyse si nécessaire. Étape suivante absente : vérifiez les dates exploitables et la fin de la préparation. Date future : contrôlez la caméra avant de continuer. Transfert avec anomalies : gardez les photos et consultez le journal avant une nouvelle tentative.

Une date future est signalée en rouge ; la caméra peut avoir été mal réglée.
Une date future est signalée en rouge ; la caméra peut avoir été mal réglée.

Dans Journal, Ouvrir le fichier journal aide à retrouver le détail des opérations. Vérifier le cache est un contrôle local en lecture seule ; un résultat OK ne prouve pas à lui seul que tous les fichiers ont été transférés.

Exemple de diagnostic local avec une date de dernier import lisible.
Exemple de diagnostic local avec une date de dernier import lisible.

Version et assistance

Le numéro de version apparaît dans l’interface. Les mises à jour sont proposées au démarrage ; Rechercher une mise à jour permet également de vérifier leur disponibilité dans Connexion. Terminez vos opérations en cours avant d’installer une mise à jour.

Pour demander de l’aide : gt.herissons@natagora.be. Indiquez la version, l’action tentée, le message exact, le nombre de fichiers et le déploiement concerné si vous l’avez. Joignez une capture utile ou le journal après vérification ; ne transmettez jamais votre token ou votre clé API.

Partager sur :Email

Soutenez Natagora

Vous aimez la nature ? Aidez-la !

Participez avec Natagora à la préservation de l’environnement en Wallonie et à Bruxelles. Apportez votre voix à la nature en devenant membre de Natagora et soutenez activement nos actions en rejoignant notre groupe de travail.
 

JE DEVIENS MEMBREJE VOUS REJOINS

Faire un don

Vos dons rendent possibles toutes les actions de Natagora. Déductibilité fiscale à partir de 40 € de dons par an.
 

JE PARTICIPE