scripts/hugin-gopro-fusion/README.md

4.4 KiB

Couture de photos 360 faites à la goproFusion avec Hugin

Ce script utilise une config de hugin pour assembler des paires de photos prises à intervalle régulier avec la GoProFusion (et son GPS activé) et aucun autre modèle. Cette gopro n'est plus produite depuis 2019, les versions suivantes font l'assemblage dans la gopro et perdent de la vitesse de capture de ce fait. Pour des tutos sur la capture, faites un tour sur le forum des géocommuns.fr: https://forum.geocommuns.fr

Descriptions

Le script main.ts ne lit pas les photos, il va juste créer un fichier .pto pour hugin pour assembler chaque paire de photos GB*** et GF***, ainsi qu'un script bash afin de lancer l'assemblage en masse. La configuration de ce script pour Hugin est définie en dur dans le script. Vous pouvez faire des essais d'assemblages dans Hugin et sauvegarder un pto, puis copier sa configuration dans le script main.ts pour changer mes configurations.

  • Configurer le dossier rempli de photos dans main.ts
  • Renseigner le numéro minimum et maximum de la capture dans les variables de config mix et max. J'utilise un dossier fixe pour mes dépots de code, c'est pourquoi ce dossier ainsi que ceux des photos gopro sont inscrits en dur dans les scripts: /home/poule/encrypted/stockage-syncable/www/development/html/

Flux de travail

  • Capturer les séquences avec la gopro
  • Copier les dossiers depuis la gopro (2 disques StillImg/DCIM) par câble usb dans un dossier prédéfini: /home/poule/encrypted/stockage-syncable/photos/imageries/gopro/INBOX_a_assembler
  • Créer les fichiers d'assemblages pour chaque paire de photos
  • Faire l'assemblage (stitching) et l'attribution des infos GPS en masse dans un dossier défini /home/poule/encrypted/stockage-syncable/photos/imageries/gopro/hugin_assemblages_script_output.
  • Déplacer les paires de photos dans un dossier qui indique le traitement réalisé /home/poule/encrypted/stockage-syncable/photos/imageries/gopro/INBOX_assemblage_fait
  • Retravailler les orientations de photos dans JOSM
  • Envoyer sur Panoramax les assemblages contenant les infos GPS

Installation

Vous aurez besoin de ts-node, node version stable (testé en version 20 sur Ubuntu), hugin.

exiftool, ts-node, minimist, hugin, et des captures photo faites avec la gopro fusion.

sudo apt install node hugin
cd /home/poule/encrypted/stockage-syncable/www/development/html/
git clone https://forge.chapril.org/tykayn/scripts && cd scripts && npm i
# on installe ts-node en global pour lancer les scripts depuis le dossier à proximité des photos. 
npm i -g ts-node

Le dossier de travail pour prendre les photos de gopro est par défaut /home/poule/encrypted/stockage-syncable/photos/imageries/gopro Les assemblages seront générés par défaut dans /home/poule/encrypted/stockage-syncable/photos/imageries/gopro/hugin_assemblages_script_output

Lancer le script pour générer des fichiers pto, exemple pour les photos GF012000.JPG à GF013000.JPG.

ts-node /home/poule/encrypted/stockage-syncable/www/development/html/scripts/hugin-gopro-fusion/main.ts --goproMin=12000 --goproMax=13000 --folder=route_benerie

Ceci va générer un paquet de fichiers .pto dans le dossier output_pto ainsi qu'un fichier bash pour les exécuter en masse. Il faudra ensuite exécuter hugin_batch.sh pour faire les fusions. Ce script ne fera les assemblages que si le fichier de destination n'existe pas déjà. Ce qui permet de reprendre un assemblage de série même si votre ordinateur passe en veille en cours de route.

Une fois les assemblages réalisés

Il faut encore remettre les infos GPS dans les fichiers générés. Pour cela il existe le script exif_batch.sh.

Suivi des assemblages

On arrive vite a avoir de nombreux dossiers de capture. La gopro fait un nouveau dossier dès que l'on stoppe une capture. Pour se repérer dans les assemblages faits et restant à configurer, il vaut mieux s'aider d'une feuille de calcul. !feuille

ainsi qu'un script bash qui permet de faire tous les assemblages de photos stéréoscopiques. Il reste à lancer le script bash pour faire tous les assemblages à la suite et remplir les infos exif dans le dossier assemblé.

Envoi sur panoramax

Une fois les assemblages réalisés et les infos de GPS présentes, les infos d'orientation réalisées avec JOSM, il n'y a plus qu'à envoyer les assemblages sur panoramax avec geovisio_cli.

geovisio upload --api-url https://panoramax.openstreetmap.fr .