scripts/hugin-gopro-fusion/README.md

# 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**.

Exemple pour assembler les infos exif depuis les images gopro front se trouvant dans INBOX_a_assembler/rouen_3 vers les
assemblages du même numéro.

```bash 
bash /home/poule/encrypted/stockage-syncable/www/development/html/scripts/hugin-gopro-fusion/exif_batch.sh 36077 38695 INBOX_a_assembler/rouen_3
```

## 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](img.png)

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 .
```