Installation et Préambule
Cette section est extraite et modifiée avec la permission de OpenDroneMap: The Missing Guide, par Piero Toffanin.
Quickstart
Installers for OpenDroneMap are available for purchase from UAV4Geo, and are the easiest way to get started and come with support.
https://opendronemap.org/webodm/download/#installer
That said, OpenDroneMap is a free and open source ecoystem. Community support is available for those looking to install themselves and directions follow:
Recommendations en matériel
La configuration minimale requise pour exécuter le logiciel est la suivante:
Processeurs 64 bits fabriqués à partir de 2010
espace de 20 Go sur le disque
4 GB de RAM
Les spécifications ci-dessus ne permettent pas de traiter plus de 100-200 images (le logiciel manquera de mémoire). Les exigences recommandées sont les suivantes :
Processeurs de dernière Génération
espace de 100 Go sur le disque
16 Go de RAM
Ce qui précède permettra de traiter quelques centaines d’images sans trop de problèmes. Un CPU avec plus de cœurs permettra un traitement plus rapide, tandis qu’une carte graphique (GPU) n’a actuellement aucun impact sur la performance. Pour traiter davantage d’images, ajoutez de l’espace disque et de la RAM de manière linéaire au nombre d’images à traiter.
Number of images |
RAM or RAM + Swap |
|---|---|
40 |
4 |
250 |
16 |
500 |
32 |
1500 |
64 |
2500 |
128 |
3500 |
192 |
5000 |
256 |
Installation
Nous recommandons aux gens d’utiliser docker pour exécuter ODM, que vous soyez sous Windows, macOS ou Linux.
Windows
Pour exécuter OpenDroneMap, vous devez disposer au minimum de Windows 7. Les versions précédentes de Windows ne sont pas supportées.
Étape 1. Vérifiez si la virtualisation est supportée
Docker nécessite une fonctionnalité de votre CPU appelée virtualisation, qui lui permet d’exécuter des machines virtuelles (VM). Assurez-vous que cette fonction est activée ! Parfois, cette fonction est désactivée. Pour vérifier, sous Windows 8 ou supérieur, vous pouvez ouvrir le Gestionnaire de tâches (appuyez sur CTRL+Maj+ESC) et passer à l’onglet Performance.
Virtualisation devrait être activé
Sous Windows 7, pour savoir si la virtualisation est activée, vous pouvez utiliser l’outil de détection de la virtualisation assistée par le matériel de Microsoft® à la place <http:// www.microsoft.com/en-us/download/details.aspx?id=592>`_.
Si la virtualisation est désactivée, vous devrez l’activer. La procédure est malheureusement un peu différente pour chaque modèle d’ordinateur, donc la meilleure façon de procéder est de chercher sur un moteur de recherche « comment activer la vtx pour<type your computer model here> ». Souvent, il s’agit de redémarrer l’ordinateur, d’appuyer immédiatement sur F2 ou F12 au démarrage, de naviguer dans le menu de démarrage et de modifier les paramètres pour activer la virtualisation (souvent appelée « VT-X »).
Touches spéciales à appuyer au démarrage de l’ordinateur pour accéder au menu de démarrage des différents fournisseurs de PC
Étape 2. Exigences d’installation
Tout d’abord, vous devrez installer:
Python (dernière version 3): https://www.python.org/downloads/windows/
Pour Python 3, assurez-vous de vérifier Add Python 3.x to PATH lors de l’installation.
N’oubliez pas d’ajouter l’exécutable Python à votre PATH (pour que vous puissiez exécuter des commandes avec lui)
Si vous êtes sur Windows 10 Home, Windows 8 (n’importe quelle version) ou Windows 7 (n’importe quelle version), installez :
Outils Docker: https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe
Par contre si vous êtes sur Windows 10 Professional ou une version plus récente, vous devez installer à la placer :
Docker pour Windows: https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe
Veuillez NE PAS installer les deux programmes dockers. Ils sont différents et créeront un conflit s’ils sont tous les deux installés.
Après avoir installé le docker, lancez-le à partir de l’icône du bureau qui est créée à partir de l’installation (Docker Quickstart dans le cas de Docker Toolbox, Docker for Windows pour Docker for Windows). Ceci est important, ne sautez pas cette étape. S’il y a des erreurs, suivez les invites à l’écran pour les corriger.
Étape 3. Vérifier l’allocation de la mémoire et du processeur
Docker sous Windows fonctionne en faisant tourner une Machine virtuelle (VM) en arrière-plan (considérez une VM comme un « émulateur d’ordinateur »). Cette VM dispose d’une certaine quantité de mémoire assignée et WebODM ne peut utiliser que la quantité de mémoire qui lui est allouée.
Si vous avez installé Docker Toolbox (voir ci-dessous si vous avez installé Docker pour Windows à la place) :
Ouvrir l’application VirtualBox Manager
Faites un clic droit sur la VM par défaut et appuyez sur Fermer (ACPI Shutdown) pour arrêter la machine
Faites un clic droit sur la VM par défaut et appuyez sur Réglages…
Déplacez le curseur Mémoire de base du panneau Système et allouez 60-70% de toute la mémoire disponible, en ajoutant éventuellement 50% des processeurs disponibles à partir de l’onglet Processeur également
Paramètres VM par défaut de VirtualBox
Ensuite, appuyez sur OK, faites un clic droit sur la VM par défaut et appuyez sur Start.
Si vous avez installé Docker pour Windows à la place :
Regardez dans la barre d’état système et faites un clic droit sur l’icône « baleine blanche ».
A partir du menu, appuyez Paramètres…
Dans le panneau, cliquez sur Avancé et glissez les boutons pour allouer 60-70% de toute la mémoire disponible et utiliser la moitié de tous les processeurs disponibles.
Appuyez sur Appliquer.
Étape 1 Icône du Docker
Étape 3 & 4 Paramètres du Docker
Étape 4. Télécharger WebODM
Ouvrez le programme Git Gui qui est installé avec Git. A partir de là :
Lorsque Git Gui s’ouvre, cliquez sur l’option “Cloner le référentiel existant”
Dans Localisation de la source entrez: https://github.com/OpenDroneMap/WebODM
Dans Répertoire cible, cliquez sur « Parcourir » et naviguez jusqu’à un dossier de votre choix (créez-en un si nécessaire)
Appuyez Cloner
Git Gui
Si le téléchargement a réussi, vous devriez voir cette fenêtre :
Git Gui après un téléchargement réussi (clone)
Allez dans le menu Répertoire, puis cliquez sur Créer une icône de bureau. Cela vous permettra de revenir plus facilement à cette application à l’avenir.
Étape 4. Lancer WebODM
Depuis l’interface GUI de Git, allez dans le menu Répertoire, puis cliquez sur Git Bash. Depuis le terminal en ligne de commande, tapez:
$ ./webodm.sh start &
Plusieurs composants seront téléchargés sur votre machine à ce stade, notamment WebODM, NodeODM et ODM. Après le téléchargement, vous devriez être accueilli par l’écran suivant :
Résultats de la console après le premier démarrage de WebODM.
Si vous utilisez Docker pour Windows, ouvrez http://localhost:8000 sur un navigateur web
Si vous utilisez Docker Toolbox, trouvez l’adresse IP à laquelle vous connecter en tapant :
$ docker-machine ip
Vous devriez obtenir un résultat du type suivant :
192.168.1.100
Ensuite, connectez-vous à http://192.168.1.100:8000 (en remplaçant l’adresse IP par la bonne).
macOS
La plupart des ordinateurs Mac modernes (après 2010) fonctionnant sous MacOS Sierra 10.12 ou supérieur peuvent exécuter OpenDroneMap en utilisant le docker, à condition que la virtualisation matérielle soit prise en charge (voir ci-dessous).
Étape 1. Vérifiez si la virtualisation est supportée
Ouvrez la fenêtre du Terminal et tapez :
$ sysctl kern.hv_support
Vous obtiendrez une réponse semblable à celle qui suit :
kern.hv_support: 1
Si le résultat est kern.hv_support : 1, alors votre Mac est supporté ! Procédez à l’étape 2.
Si le résultat est kern.hv_support : 0, cela signifie malheureusement que votre Mac est trop vieux pour exécuter OpenDroneMap. :(
Étape 2. Exigences d’installation
Il n’y a que deux programmes à installer :
Après avoir installé le docker, vous devriez trouver une icône qui ressemble à une baleine dans la barre des tâches.
Docker app en cours
Vous pouvez vérifier que le docker fonctionne correctement en ouvrant l’application Terminal et en tapant :
$ docker run hello-world
Qui devrait renvoyer
Hello from Docker!
Pour vérifier que Git est installé, tapez simplement:
$ git --version
Ce qui devrait donner quelque chose similaire à ce qui suit :
git version 2.20.1 (Apple Git-117)
Si vous obtenez un « bash : git : command not found », essayez de redémarrer votre application Terminal et vérifiez les erreurs éventuelles pendant le processus d’installation.
Étape 3. Vérifier l’allocation de la mémoire et du processeur
Docker sur macOS fonctionne en faisant tourner une Machine Virtuelle (VM) en arrière-plan (voyez ça comme un « émulateur d’ordinateur »). Cette VM dispose d’une certaine quantité de mémoire allouée et WebODM ne peut utiliser que la quantité de mémoire qui lui est allouée.
Faites un clic droit sur l’icône de la baleine dans la barre des tâches et cliquez sur Préférences…
Sélectionnez l’onglet Avancé.
Ajustez le curseur pour utiliser la moitié de tous les processeurs et 60-70% de toute la mémoire disponible
Appuyez Appliquer et Redémarrer
Paramètres avancés du Docker
Étape 4. Téléchargez et lancez WebODM
A partir du Terminal tapez:
$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start
Ouvrez ensuite http://localhost:8000 sur votre Navigateur web
Linux
OpenDroneMap peut fonctionner sur toute distribution Linux qui supporte le docker. Selon le site web de documentation de docker les distributions officiellement supportées sont CentOS, Debian, Ubuntu et Fedora, avec des binaires statiques disponibles pour les autres. Si vous devez choisir une distribution uniquement pour exécuter OpenDroneMap, Ubuntu est la solution recommandée.
Étape 1. Exigences d’installation
Il y a quatre programmes qui doivent être installés :
Docker
Git
Python (2 ou 3)
Pip
Nous ne pouvons pas couvrir le processus d’installation pour toutes les distributions Linux existantes, nous limiterons donc les instructions aux seules distributions officiellement prises en charge par Docker. Dans tous les cas, il suffit d’ouvrir une invite de terminal et de taper quelques commandes.
Installer sur Ubuntu / Debian
Commandes à taper:
$ sudo apt update
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo apt install -y git python python-pip
Installer sur CentOS / RHEL
Commandes à taper:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo yum -y install git python python-pip
Installer sur Fedora
Commandes à taper:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo dnf install git python python-pip
Installer sur Arch
Commandes à taper:
$ sudo pacman -Sy docker git python python-pip
Étape 2. Vérifier les exigences supplémentaires
En plus des trois programmes ci-dessus, le script dockercompose est également nécessaire. Parfois, il est déjà installé avec le docker, mais parfois il ne l’est pas. Pour vérifier s’il est installé, essayez de taper :
$ docker compose --version
Vous devriez voir quelque chose de similaire à ce qui suit :
docker compose version 24.0.5, build ced0996600
Étape 3. Télécharger et lancer WebODM
A partir du terminal, taper:
$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start
Ouvrez ensuite http://localhost:8000 sur votre Navigateur web
Commandes de base et dépannage
L’avantage de l’utilisation de docker est que 99% des tâches que vous devrez effectuer en utilisant WebODM peuvent être réalisées via le script ./webodm.sh. Vous avez déjà rencontré l’un d’entre eux :
$ ./webodm.sh start
qui s’occupe de lancer WebODM et de mettre en place un nœud de traitement par défaut (node-odm-1). Si vous voulez arrêter WebODM, vous pouvez déjà deviner quelle est la commande :
$ ./webodm.sh stop
Il existe plusieurs autres commandes que vous pouvez utiliser, ainsi que différents indicateurs. Les indicateurs sont des paramètres passés à la commande ./webodm.sh et sont généralement préfixés par un « - ». L’indicateur port, par exemple, indique à WebODM d’utiliser un port réseau différent :
$ ./webodm.sh start --port 80
D’autres commandes utiles sont énumérées ci-dessous :
# Restart WebODM (useful if things get stuck)
$ ./webodm.sh restart
# Reset the admin user's password if you forget it
$ ./webodm.sh resetadminpassword newpass
# Update everything to the latest version
$ ./webodm.sh update
# Store processing results in the specified folder instead of the default location (inside docker)
$ ./webodm.sh restart --media-dir /path/to/webodm_results
# See all options
$ ./webodm.sh --help
Le forum communautaire est l’endroit idéal pour demander de l’aide si vous êtes bloqué pendant l’une des étapes de l’installation et pour des questions générales sur l’utilisation du script ./webodm.sh.
Salut, WebODM!
Après avoir lancé ./webodm.sh et ouvert WebODM dans le navigateur, vous serez accueilli par un message de bienvenue et serez invité à créer le premier utilisateur. Prenez un peu de temps pour vous familiariser avec l’interface web et explorer ses différents menus.
Tableau de bord WebODM
Notez que dans le menu Nœuds de traitement, il y a un nœud « node-odm-1 » déjà configuré pour que vous l’utilisiez. Il s’agit d’un nœud NodeODM et il a été créé automatiquement par WebODM. Ce nœud fonctionne sur la même machine que WebODM.
Si vous êtes arrivé jusqu’ici, félicitations ! Il est maintenant temps de commencer à traiter certaines données.
En cours d’exécution sur plus d’une machine
Optionnellement: Si vous avez un autre ordinateur, vous pouvez répéter le processus d’installation (installer docker, git, python, etc.) et lancer un nouveau noeud NodeODM en tapant depuis une fenêtre Terminal/Git Bash:
docker run --rm -it -p 3000:3000 opendronemap/nodeodm -q 1 --token secret
La commande ci-dessus invite le docker à lancer un nouveau conteneur en utilisant l’image opendronemap/nodeodm du Docker Hub (la dernière version de NodeODM), en utilisant le port 3000, en fixant un nombre maximum de tâches simultanées à 1 et en protégeant le nœud contre tout accès non autorisé à l’aide du mot de passe « secret ».
À partir de WebODM, vous pouvez ensuite appuyer sur le bouton Ajouter nouveau sous Nœuds de traitement. Pour le champ hostname/IP, tapez l’IP du deuxième ordinateur. Pour le champ port, tapez « 3000 ». Pour le champ token, tapez « secret ». Vous pouvez également ajouter une étiquette facultative pour votre nœud, par exemple « second ordinateur ». Appuyez ensuite sur Enregistrer.
Si tout s’est bien passé, vous devriez maintenant avoir deux nœuds de traitement ! Vous pourrez désormais traiter plusieurs tâches en parallèle en utilisant deux machines différentes
Apprenez à éditer et aidez à améliorer cette page!