MicMac - Contributions de l’utilisateur [fr]

Compilation de MicMac sur ARM (RaspBerryPi)

2016-12-21T14:07:52Z

Nguyengiang41 :

Cette page est exclusivement consacrée à la compilation du logiciel de l'IGN MicMac sur des processeurs ARM tels que les RaspBerryPi. Cette page
présente ainsi les différentes étapes de compilation.*

[[Remarque :]] ''Pensez à vous munir de carte SD au moin 16Go pour éviter tout défaut de compilation...''

== Les librairies ==

Dans un premier temps, nous allons installer toutes les librairies indispensables à l'installation. Pour cela, il suffit d'éxecuter les commandes qui suivent dans un terminal :
<pre> sudo apt-get update </pre>

L'option ''update'' met à jour la liste des fichiers disponibles de configuration /etc/apt/sources.list. L'exécuter régulièrement est une bonne pratique, afin de maintenir à jour votre liste de paquets disponibles.

NB : la commande ''apt-get'' est un outil logiciel à utiliser en ligne de commande. Il permet d'effectuer l'installation et la désinstallation de paquets.

<pre> sudo apt-get upgrade </pre>

L'option ''upgrade'' met à jour tous les paquets installés sur le système vers les dernières versions (couramment utilisé).

<pre> sudo apt-get install x11proto-core-dev make cmake libx11-dev git git-all subversion imagemagick gcc g++ exiv2 libimage-exiftool-perl libgeo-proj4-perl mesa-common-dev libgl1-mesa-dev libglapi-mesa libglu1-mesa qt5-default </pre>

[[Remarque :]] l'installation de dépôt de ''Git'' vient remplacer celle de ''Mercurial''. Le dépôt de Mercurial n'est plus mettre à jour par le développeurs. En effet, ''Git'' est de loin le plus rapide des systèmes de gestion de versions existants et les dépôts ''Git'' sont particulièrement compacts. Il se distingue notamment par sa rapidité et sa gestion des branches qui permettent de développer en parallèle de nouvelles fonctionnalités, ce qui est très intéressant pour des travaux dits de "clustering".

<pre> sudo apt-get install x11proto-resource-dev cmake-curses-gui extra-cmake-modules libx11-6-dbg hgsubversion libimage-magick-perl </pre>

== Téléchargement de MicMac ==

Pour cloner MicMac dans le répertoire culture3d/ (vous pouvez choisir un nom de vous-même):

<pre> git clone https://github.com/micmacIGN/micmac.git culture3d</pre>

[[Remarque :]] Si vous avez le problème de cloner avec git à cause de proxy, utiliser cette command
<pre> git config --global http.proxy your_proxy_address </pre>

Ne vous inquiétez pas, le téléchargement peut prendre plusieurs minutes !

== Logiciel de compilation ==

À partir du répertoire d'installation, accédez au répertoire 'culture3d':

<pre> cd culture3d </pre>

Ensuite, vous devez créer un répertoire de build et y aller:

<pre>
mkdir build
cd build
</pre>

Ensuite, vous devez générer le makefile avec les bonnes options. Pour générer le makefile défaut, exécutez ce qui suit :

<pre> sudo cmake ../ </pre>
<pre> sudo ccmake ../ </pre>

[[Remarque :]] Maintenant que vous êtes dans les configurations de cmake, afin de compiler plus vite sur Raspberry, mettez toutes les options de ''cmake'' en OFF, seule l'option ''WITH_HEADER_PRECOMP'' reste sur ON, puis configurez (''c'') et générez (''g''). Pour l'instant, on est sure que ca marche sur le Raspberry avec cette configuration. À tester avec les autres option ENABLE

Afin de compiler, on modifie un peu le source code, entrez dans :
<pre>culture3d/CodeExterne/Siftpp/</pre>

Il faut nécessairement vous placer dans le bon environnement afin de modifier le fichier Makefile.
Ajoutez-y la ligne :
<pre>Linux_armv71_ARCH : =glx</pre>

De la même manière, vous allez modifier le fichier ''sift_driver.cpp'' et ajouter la ligne ''#include<cstdint>''. En effet, le fichier Makefile tente de configurer automatiquement quelques paramètres. Si cela échoue, il renvoie une erreur. Ainsi, les commandes précédentes permettront au programme d'être exécuté sans aucun problème. Pour ce faire, c'est la commande ''vi '' (on peut utilise n'importe quelle editeur de texte) qui va vous permettre de modifier à votre guise le fichier au sein même du terminal. Nous vous présentons succinctement son fonctionnement ci-dessous.

== Présentation de la commande ''vi'' ==
''vi'' offre deux modes de fonctionnement : le mode ''commande'' et le mode ''insertion''.

Au démarrage il est en mode commande, qui permet de déplacer le curseur, de parcourir le document et de copier-coller. On le quitte, en entrant du même coup en mode insertion, en utilisant une commande d'insertion ou de modification. En mode insertion il est possible de saisir du texte. Appuyez sur la touche Esc pour revenir en mode commande.

Pour sauvegarder ou quitter un fichier ''vi'', vous pouvez écrire différentes requêtes :
<pre>:w qui permet de sauvegarder le contenu du fichier
:x sauvegarde puis quitte
:q quitte vi sans sauvegarder les modifications
:q! quitte immédiatement, sans rien faire d'autre
</pre>
Vous pouvez également vous déplacer dans le document édité :
<pre>
f descend d'une page
b remonte d'une page
d descend d'1/2 page
u remonte d'1/2 page
X va à la ligne numérotée X
</pre>
Il se peut que vous vouliez insérer du texte, pour cela il vous suffit de vous inspirer de ce qu'il suit :
<pre>
i active le mode insertion
a active le mode insertion, un caractère après le curseur
I insère au début de la ligne
A insère à la fin de la ligne
O insère une ligne au-dessus du curseur et passe en mode insertion
o insère une ligne en dessous du curseur et passe en mode insertion
ESC quitte le mode insertion, revient en mode commande
</pre>
Pour supprimer du texte, il vous faut connaître les différentes requêtes suivantes :
<pre>
x supprime un caractère
dw supprime un mot
dnw supprime n mots
dd supprime une ligne
ndd supprime n lignes
</pre>
Ne vous inquiétez surtout pas en cas de modifications erronées, il existe un équivalent du ''Ctrl+z'' dans le terminal qui annule ou répète des modifications :
<pre>
u annule la dernière modification
U annule toutes les modifications effectuées sur la ligne courante
. répète les dernières modifications
</pre>

== Lancement de la compilation ==

Maintenant, nous pouvons enfin construire les sources en lançant les dernières commandes suivantes :

<pre> sudo make -j$NBRP </pre> où NBRP correspond au nombre de processeurs sur votre ARM (suite aux nombreuses phases de tests, nous avons pu remarquer qu'il valait mieux mettre seulement 2 cœurs pour que la compilation se déroule sans problème) :
<pre> NBRP=2</pre>

Pour le lancement de la compilation, il ne vous reste plus qu'à écrire une dernière commande :
<pre> sudo make install </pre>

== Ajouter MicMac au chemin ==

Afin de permeter system connaitre la command de micmac quand on les appeler depuis un terminal, il fault le répertoire d'éxecutable de MicMac se trouve dans le system PATH. Par default, l'éxecutable de MicMac se produit après la compilation et se trouve dans '~/culture3d/bin'.
Pour verifier le contenu de PATH, dans un terminal, éxecute :

<pre> echo $PATH </pre>

Pour ajouter le répertoire d'éxecutable de MicMac dans PATH en permanent, on peut mettre un command dans ~/.bashrc. On ouvre fichier ~/.bashrc avec un editeur de text :

<pre> sudo vi ~/.bashrc </pre>

Et on ajoute le répertoire d'éxecutable de MicMac en ajoute cette commande à la fin du fichier ~/.bashrc:

<pre> export PATH=$PATH:~/culture3d/bin </pre>

MicMac devrait maintenant être installé dans votre dépôt personnel.

Pour vérifier si MicMac est bien installé sur votre Raspberry, vous pouvez taper dans un terminal:

<pre> mm3d </pre>

== Mis à jour MicMac ==

Depuis un terminal, rentrez dans le répertoire 'build' de MicMac:

<pre> cd ~/culture3d/build </pre>

Mis à jour avec git :

<pre> git pull </pre>

Recompiler après mis à jour:

<pre> sudo make install </pre>

Compilation de MicMac sur ARM (RaspBerryPi)

2016-12-21T14:04:20Z

Nguyengiang41 : /* Ajouter MicMac au chemin */

Compilation de MicMac sur ARM (RaspBerryPi)

2016-12-21T13:56:21Z

Nguyengiang41 :

Cette page est exclusivement consacrée à la compilation du logiciel de l'IGN MicMac sur des processeurs ARM tels que les RaspBerryPi. Cette page
présente ainsi les différentes étapes de compilation.*

[[Remarque :]] ''Pensez à vous munir de carte SD au moin 16Go pour éviter tout défaut de compilation...''

== Les librairies ==

Dans un premier temps, nous allons installer toutes les librairies indispensables à l'installation. Pour cela, il suffit d'éxecuter les commandes qui suivent dans un terminal :
<pre> sudo apt-get update </pre>

L'option ''update'' met à jour la liste des fichiers disponibles de configuration /etc/apt/sources.list. L'exécuter régulièrement est une bonne pratique, afin de maintenir à jour votre liste de paquets disponibles.

NB : la commande ''apt-get'' est un outil logiciel à utiliser en ligne de commande. Il permet d'effectuer l'installation et la désinstallation de paquets.

<pre> sudo apt-get upgrade </pre>

L'option ''upgrade'' met à jour tous les paquets installés sur le système vers les dernières versions (couramment utilisé).

<pre> sudo apt-get install x11proto-core-dev make cmake libx11-dev git git-all subversion imagemagick gcc g++ exiv2 libimage-exiftool-perl libgeo-proj4-perl mesa-common-dev libgl1-mesa-dev libglapi-mesa libglu1-mesa qt5-default </pre>

[[Remarque :]] l'installation de dépôt de ''Git'' vient remplacer celle de ''Mercurial''. Le dépôt de Mercurial n'est plus mettre à jour par le développeurs. En effet, ''Git'' est de loin le plus rapide des systèmes de gestion de versions existants et les dépôts ''Git'' sont particulièrement compacts. Il se distingue notamment par sa rapidité et sa gestion des branches qui permettent de développer en parallèle de nouvelles fonctionnalités, ce qui est très intéressant pour des travaux dits de "clustering".

<pre> sudo apt-get install x11proto-resource-dev cmake-curses-gui extra-cmake-modules libx11-6-dbg hgsubversion libimage-magick-perl </pre>

== Téléchargement de MicMac ==

Pour cloner MicMac dans le répertoire culture3d/ (vous pouvez choisir un nom de vous-même):

<pre> git clone https://github.com/micmacIGN/micmac.git culture3d</pre>

[[Remarque :]] Si vous avez le problème de cloner avec git à cause de proxy, utiliser cette command
<pre> git config --global http.proxy your_proxy_address </pre>

Ne vous inquiétez pas, le téléchargement peut prendre plusieurs minutes !

== Logiciel de compilation ==

À partir du répertoire d'installation, accédez au répertoire 'culture3d':

<pre> cd culture3d </pre>

Ensuite, vous devez créer un répertoire de build et y aller:

<pre>
mkdir build
cd build
</pre>

Ensuite, vous devez générer le makefile avec les bonnes options. Pour générer le makefile défaut, exécutez ce qui suit :

<pre> sudo cmake ../ </pre>
<pre> sudo ccmake ../ </pre>

[[Remarque :]] Maintenant que vous êtes dans les configurations de cmake, afin de compiler plus vite sur Raspberry, mettez toutes les options de ''cmake'' en OFF, seule l'option ''WITH_HEADER_PRECOMP'' reste sur ON, puis configurez (''c'') et générez (''g''). Pour l'instant, on est sure que ca marche sur le Raspberry avec cette configuration. À tester avec les autres option ENABLE

Afin de compiler, on modifie un peu le source code, entrez dans :
<pre>culture3d/CodeExterne/Siftpp/</pre>

Il faut nécessairement vous placer dans le bon environnement afin de modifier le fichier Makefile.
Ajoutez-y la ligne :
<pre>Linux_armv71_ARCH : =glx</pre>

De la même manière, vous allez modifier le fichier ''sift_driver.cpp'' et ajouter la ligne ''#include<cstdint>''. En effet, le fichier Makefile tente de configurer automatiquement quelques paramètres. Si cela échoue, il renvoie une erreur. Ainsi, les commandes précédentes permettront au programme d'être exécuté sans aucun problème. Pour ce faire, c'est la commande ''vi '' (on peut utilise n'importe quelle editeur de texte) qui va vous permettre de modifier à votre guise le fichier au sein même du terminal. Nous vous présentons succinctement son fonctionnement ci-dessous.

== Présentation de la commande ''vi'' ==
''vi'' offre deux modes de fonctionnement : le mode ''commande'' et le mode ''insertion''.

Au démarrage il est en mode commande, qui permet de déplacer le curseur, de parcourir le document et de copier-coller. On le quitte, en entrant du même coup en mode insertion, en utilisant une commande d'insertion ou de modification. En mode insertion il est possible de saisir du texte. Appuyez sur la touche Esc pour revenir en mode commande.

Pour sauvegarder ou quitter un fichier ''vi'', vous pouvez écrire différentes requêtes :
<pre>:w qui permet de sauvegarder le contenu du fichier
:x sauvegarde puis quitte
:q quitte vi sans sauvegarder les modifications
:q! quitte immédiatement, sans rien faire d'autre
</pre>
Vous pouvez également vous déplacer dans le document édité :
<pre>
f descend d'une page
b remonte d'une page
d descend d'1/2 page
u remonte d'1/2 page
X va à la ligne numérotée X
</pre>
Il se peut que vous vouliez insérer du texte, pour cela il vous suffit de vous inspirer de ce qu'il suit :
<pre>
i active le mode insertion
a active le mode insertion, un caractère après le curseur
I insère au début de la ligne
A insère à la fin de la ligne
O insère une ligne au-dessus du curseur et passe en mode insertion
o insère une ligne en dessous du curseur et passe en mode insertion
ESC quitte le mode insertion, revient en mode commande
</pre>
Pour supprimer du texte, il vous faut connaître les différentes requêtes suivantes :
<pre>
x supprime un caractère
dw supprime un mot
dnw supprime n mots
dd supprime une ligne
ndd supprime n lignes
</pre>
Ne vous inquiétez surtout pas en cas de modifications erronées, il existe un équivalent du ''Ctrl+z'' dans le terminal qui annule ou répète des modifications :
<pre>
u annule la dernière modification
U annule toutes les modifications effectuées sur la ligne courante
. répète les dernières modifications
</pre>

== Lancement de la compilation ==

Maintenant, nous pouvons enfin construire les sources en lançant les dernières commandes suivantes :

<pre> sudo make -j$NBRP </pre> où NBRP correspond au nombre de processeurs sur votre ARM (suite aux nombreuses phases de tests, nous avons pu remarquer qu'il valait mieux mettre seulement 2 cœurs pour que la compilation se déroule sans problème) :
<pre> NBRP=2</pre>

Pour le lancement de la compilation, il ne vous reste plus qu'à écrire une dernière commande :
<pre> sudo make install </pre>

== Ajouter MicMac au chemin ==

Nous devons maintenant éditer le fichier contenant le chemin environnement qui se trouve dans ''/etc/culture3d/bin''. Ouvrez un terminal et tapez:
<pre> ~/.bashrc </pre>

'''Remarque :''' les fichiers dans "/ etc /" doivent être ouverts en tant qu'administrateur uniquement. Pour cela, ajoutez les lignes suivantes au bas du fichier:

<pre> export PATH=$PATH:~/culture3d/bin </pre>

MicMac devrait maintenant être installé dans votre dépôt personnel.

Pour vérifier si MicMac est bien installé sur votre ARM, vous pouvez taper dans un terminal:

<pre> mm3d </pre>

Compilation de MicMac sur ARM (RaspBerryPi)

2016-12-21T13:53:49Z

Nguyengiang41 :

Cette page est exclusivement consacrée à la compilation du logiciel de l'IGN MicMac sur des processeurs ARM tels que les RaspBerryPi. Cette page
présente ainsi les différentes étapes de compilation.*

[[Remarque :]] ''Pensez à vous munir de carte SD au moin 16Go pour éviter tout défaut de compilation...''

== Les librairies ==

Dans un premier temps, nous allons installer toutes les librairies indispensables à l'installation. Pour cela, il suffit d'éxecuter les commandes qui suivent dans un terminal :
<pre> sudo apt-get update </pre>

L'option ''update'' met à jour la liste des fichiers disponibles de configuration /etc/apt/sources.list. L'exécuter régulièrement est une bonne pratique, afin de maintenir à jour votre liste de paquets disponibles.

NB : la commande ''apt-get'' est un outil logiciel à utiliser en ligne de commande. Il permet d'effectuer l'installation et la désinstallation de paquets.

<pre> sudo apt-get upgrade </pre>

L'option ''upgrade'' met à jour tous les paquets installés sur le système vers les dernières versions (couramment utilisé).

<pre> sudo apt-get install x11proto-core-dev make cmake libx11-dev git git-all subversion imagemagick gcc g++ exiv2 libimage-exiftool-perl libgeo-proj4-perl mesa-common-dev libgl1-mesa-dev libglapi-mesa libglu1-mesa qt5-default </pre>

[[Remarque :]] l'installation de dépôt de ''Git'' vient remplacer celle de ''Mercurial''. Le dépôt de Mercurial n'est plus mettre à jour par le développeurs. En effet, ''Git'' est de loin le plus rapide des systèmes de gestion de versions existants et les dépôts ''Git'' sont particulièrement compacts. Il se distingue notamment par sa rapidité et sa gestion des branches qui permettent de développer en parallèle de nouvelles fonctionnalités, ce qui est très intéressant pour des travaux dits de "clustering".

<pre> sudo apt-get install x11proto-resource-dev cmake-curses-gui extra-cmake-modules libx11-6-dbg hgsubversion libimage-magick-perl </pre>

== Téléchargement de MicMac ==

Pour cloner MicMac dans le répertoire culture3d/ (vous pouvez choisir un nom de vous-même):

<pre> git clone https://github.com/micmacIGN/micmac.git culture3d</pre>

Ne vous inquiétez pas, le téléchargement peut prendre plusieurs minutes !

== Logiciel de compilation ==

À partir du répertoire d'installation, accédez au répertoire 'culture3d':

<pre> cd culture3d </pre>

Ensuite, vous devez créer un répertoire de build et y aller:

<pre>
mkdir build
cd build
</pre>

Ensuite, vous devez générer le makefile avec les bonnes options. Pour générer le makefile défaut, exécutez ce qui suit :

<pre> sudo cmake ../ </pre>
<pre> sudo ccmake ../ </pre>

[[Remarque :]] Maintenant que vous êtes dans les configurations de cmake, afin de compiler plus vite sur Raspberry, mettez toutes les options de ''cmake'' en OFF, seule l'option ''WITH_HEADER_PRECOMP'' reste sur ON, puis configurez (''c'') et générez (''g''). Pour l'instant, on est sure que ca marche sur le Raspberry avec cette configuration. À tester avec les autres option ENABLE

Afin de compiler, on modifie un peu le source code, entrez dans :
<pre>culture3d/CodeExterne/Siftpp/</pre>

Il faut nécessairement vous placer dans le bon environnement afin de modifier le fichier Makefile.
Ajoutez-y la ligne :
<pre>Linux_armv71_ARCH : =glx</pre>

De la même manière, vous allez modifier le fichier ''sift_driver.cpp'' et ajouter la ligne ''#include<cstdint>''. En effet, le fichier Makefile tente de configurer automatiquement quelques paramètres. Si cela échoue, il renvoie une erreur. Ainsi, les commandes précédentes permettront au programme d'être exécuté sans aucun problème. Pour ce faire, c'est la commande ''vi '' (on peut utilise n'importe quelle editeur de texte) qui va vous permettre de modifier à votre guise le fichier au sein même du terminal. Nous vous présentons succinctement son fonctionnement ci-dessous.

== Présentation de la commande ''vi'' ==
''vi'' offre deux modes de fonctionnement : le mode ''commande'' et le mode ''insertion''.

Au démarrage il est en mode commande, qui permet de déplacer le curseur, de parcourir le document et de copier-coller. On le quitte, en entrant du même coup en mode insertion, en utilisant une commande d'insertion ou de modification. En mode insertion il est possible de saisir du texte. Appuyez sur la touche Esc pour revenir en mode commande.

Pour sauvegarder ou quitter un fichier ''vi'', vous pouvez écrire différentes requêtes :
<pre>:w qui permet de sauvegarder le contenu du fichier
:x sauvegarde puis quitte
:q quitte vi sans sauvegarder les modifications
:q! quitte immédiatement, sans rien faire d'autre
</pre>
Vous pouvez également vous déplacer dans le document édité :
<pre>
f descend d'une page
b remonte d'une page
d descend d'1/2 page
u remonte d'1/2 page
X va à la ligne numérotée X
</pre>
Il se peut que vous vouliez insérer du texte, pour cela il vous suffit de vous inspirer de ce qu'il suit :
<pre>
i active le mode insertion
a active le mode insertion, un caractère après le curseur
I insère au début de la ligne
A insère à la fin de la ligne
O insère une ligne au-dessus du curseur et passe en mode insertion
o insère une ligne en dessous du curseur et passe en mode insertion
ESC quitte le mode insertion, revient en mode commande
</pre>
Pour supprimer du texte, il vous faut connaître les différentes requêtes suivantes :
<pre>
x supprime un caractère
dw supprime un mot
dnw supprime n mots
dd supprime une ligne
ndd supprime n lignes
</pre>
Ne vous inquiétez surtout pas en cas de modifications erronées, il existe un équivalent du ''Ctrl+z'' dans le terminal qui annule ou répète des modifications :
<pre>
u annule la dernière modification
U annule toutes les modifications effectuées sur la ligne courante
. répète les dernières modifications
</pre>

== Lancement de la compilation ==

Maintenant, nous pouvons enfin construire les sources en lançant les dernières commandes suivantes :

<pre> sudo make -j$NBRP </pre> où NBRP correspond au nombre de processeurs sur votre ARM (suite aux nombreuses phases de tests, nous avons pu remarquer qu'il valait mieux mettre seulement 2 cœurs pour que la compilation se déroule sans problème) :
<pre> NBRP=2</pre>

Pour le lancement de la compilation, il ne vous reste plus qu'à écrire une dernière commande :
<pre> sudo make install </pre>

== Ajouter MicMac au chemin ==

Nous devons maintenant éditer le fichier contenant le chemin environnement qui se trouve dans ''/etc/culture3d/bin''. Ouvrez un terminal et tapez:
<pre> ~/.bashrc </pre>

'''Remarque :''' les fichiers dans "/ etc /" doivent être ouverts en tant qu'administrateur uniquement. Pour cela, ajoutez les lignes suivantes au bas du fichier:

<pre> export PATH=$PATH:~/culture3d/bin </pre>

MicMac devrait maintenant être installé dans votre dépôt personnel.

Pour vérifier si MicMac est bien installé sur votre ARM, vous pouvez taper dans un terminal:

<pre> mm3d </pre>

Compilation de MicMac sur ARM (RaspBerryPi)

2016-12-21T13:39:57Z

Nguyengiang41 :

Cette page est exclusivement consacrée à la compilation du logiciel de l'IGN MicMac sur des processeurs ARM tels que les RaspBerryPi. Cette page
présente ainsi les différentes étapes de compilation.*

[[Remarque :]] ''Pensez à vous munir de carte SD au moin 16Go pour éviter tout défaut de compilation...''

== Les librairies ==

Dans un premier temps, nous allons installer toutes les librairies indispensables à l'installation. Pour cela, il suffit d'éxecuter les commandes qui suivent dans un terminal :
<pre> sudo apt-get update </pre>

L'option ''update'' met à jour la liste des fichiers disponibles de configuration /etc/apt/sources.list. L'exécuter régulièrement est une bonne pratique, afin de maintenir à jour votre liste de paquets disponibles.

NB : la commande ''apt-get'' est un outil logiciel à utiliser en ligne de commande. Il permet d'effectuer l'installation et la désinstallation de paquets.

<pre> sudo apt-get upgrade </pre>

L'option ''upgrade'' met à jour tous les paquets installés sur le système vers les dernières versions (couramment utilisé).

<pre> sudo apt-get install x11proto-core-dev make cmake libx11-dev git git-all subversion imagemagick gcc g++ exiv2 libimage-exiftool-perl libgeo-proj4-perl mesa-common-dev libgl1-mesa-dev libglapi-mesa libglu1-mesa qt5-default </pre>

[[Remarque :]] l'installation de dépôt de ''Git'' vient remplacer celle de ''Mercurial''. Le dépôt de Mercurial n'est plus mettre à jour par le développeurs. En effet, ''Git'' est de loin le plus rapide des systèmes de gestion de versions existants et les dépôts ''Git'' sont particulièrement compacts. Il se distingue notamment par sa rapidité et sa gestion des branches qui permettent de développer en parallèle de nouvelles fonctionnalités, ce qui est très intéressant pour des travaux dits de "clustering".

<pre> sudo apt-get install x11proto-resource-dev cmake-curses-gui extra-cmake-modules libx11-6-dbg hgsubversion libimage-magick-perl </pre>

== Téléchargement de MicMac ==

Pour cloner MicMac dans le répertoire culture3d/ (vous pouvez choisir un nom de vous-même):

<pre> git clone https://geoportail.forge.ign.fr/culture3d/grit.git culture3d</pre>

Ne vous inquiétez pas, le téléchargement peut prendre plusieurs minutes !

== Logiciel de compilation ==

À partir du répertoire d'installation, accédez au répertoire 'culture3d':

<pre> cd culture3d </pre>

Ensuite, vous devez créer un répertoire de build et y aller:

<pre>
mkdir build
cd build
</pre>

Ensuite, vous devez générer le makefile avec les bonnes options. Pour générer le makefile défaut, exécutez ce qui suit :

<pre> sudo cmake ../ </pre>
<pre> sudo ccmake ../ </pre>

[[Remarque :]] Maintenant que vous êtes dans les configurations de cmake, afin de compiler plus vite sur Raspberry, mettez toutes les options de ''cmake'' en OFF, seule l'option ''WITH_HEADER_PRECOMP'' reste sur ON, puis configurez (''c'') et générez (''g''). Pour l'instant, on est sure que ca marche sur le Raspberry avec cette configuration. À tester avec les autres option ENABLE

Afin de compiler, on modifie un peu le source code, entrez dans :
<pre>culture3d/CodeExterne/Siftpp/</pre>

Il faut nécessairement vous placer dans le bon environnement afin de modifier le fichier Makefile.
Ajoutez-y la ligne :
<pre>Linux_armv71_ARCH : =glx</pre>

De la même manière, vous allez modifier le fichier ''sift_driver.cpp'' et ajouter la ligne ''#include<cstdint>''. En effet, le fichier Makefile tente de configurer automatiquement quelques paramètres. Si cela échoue, il renvoie une erreur. Ainsi, les commandes précédentes permettront au programme d'être exécuté sans aucun problème. Pour ce faire, c'est la commande ''vi '' (on peut utilise n'importe quelle editeur de texte) qui va vous permettre de modifier à votre guise le fichier au sein même du terminal. Nous vous présentons succinctement son fonctionnement ci-dessous.

== Présentation de la commande ''vi'' ==
''vi'' offre deux modes de fonctionnement : le mode ''commande'' et le mode ''insertion''.

Au démarrage il est en mode commande, qui permet de déplacer le curseur, de parcourir le document et de copier-coller. On le quitte, en entrant du même coup en mode insertion, en utilisant une commande d'insertion ou de modification. En mode insertion il est possible de saisir du texte. Appuyez sur la touche Esc pour revenir en mode commande.

Pour sauvegarder ou quitter un fichier ''vi'', vous pouvez écrire différentes requêtes :
<pre>:w qui permet de sauvegarder le contenu du fichier
:x sauvegarde puis quitte
:q quitte vi sans sauvegarder les modifications
:q! quitte immédiatement, sans rien faire d'autre
</pre>
Vous pouvez également vous déplacer dans le document édité :
<pre>
f descend d'une page
b remonte d'une page
d descend d'1/2 page
u remonte d'1/2 page
X va à la ligne numérotée X
</pre>
Il se peut que vous vouliez insérer du texte, pour cela il vous suffit de vous inspirer de ce qu'il suit :
<pre>
i active le mode insertion
a active le mode insertion, un caractère après le curseur
I insère au début de la ligne
A insère à la fin de la ligne
O insère une ligne au-dessus du curseur et passe en mode insertion
o insère une ligne en dessous du curseur et passe en mode insertion
ESC quitte le mode insertion, revient en mode commande
</pre>
Pour supprimer du texte, il vous faut connaître les différentes requêtes suivantes :
<pre>
x supprime un caractère
dw supprime un mot
dnw supprime n mots
dd supprime une ligne
ndd supprime n lignes
</pre>
Ne vous inquiétez surtout pas en cas de modifications erronées, il existe un équivalent du ''Ctrl+z'' dans le terminal qui annule ou répète des modifications :
<pre>
u annule la dernière modification
U annule toutes les modifications effectuées sur la ligne courante
. répète les dernières modifications
</pre>

== Lancement de la compilation ==

Maintenant, nous pouvons enfin construire les sources en lançant les dernières commandes suivantes :

<pre> sudo make -j$NBRP </pre> où NBRP correspond au nombre de processeurs sur votre ARM (suite aux nombreuses phases de tests, nous avons pu remarquer qu'il valait mieux mettre seulement 2 cœurs pour que la compilation se déroule sans problème) :
<pre> NBRP=2</pre>

Pour le lancement de la compilation, il ne vous reste plus qu'à écrire une dernière commande :
<pre> sudo make install </pre>

== Ajouter MicMac au chemin ==

Nous devons maintenant éditer le fichier contenant le chemin environnement qui se trouve dans ''/etc/culture3d/bin''. Ouvrez un terminal et tapez:
<pre> ~/.bashrc </pre>

'''Remarque :''' les fichiers dans "/ etc /" doivent être ouverts en tant qu'administrateur uniquement. Pour cela, ajoutez les lignes suivantes au bas du fichier:

<pre> export PATH=$PATH:~/culture3d/bin </pre>

MicMac devrait maintenant être installé dans votre dépôt personnel.

Pour vérifier si MicMac est bien installé sur votre ARM, vous pouvez taper dans un terminal:

<pre> mm3d </pre>

Compilation de MicMac sur ARM (RaspBerryPi)

2016-12-09T14:34:13Z

Nguyengiang41 : /* Téléchargement de MicMac */

Cette page est exclusivement consacrée à la compilation du logiciel de l'IGN MicMac sur des processeurs ARM tels que les RaspBerryPi. Cette page
présente ainsi les différentes étapes de compilation.

== Les librairies ==

Dans un premier temps, nous allons installer toutes les librairies indispensables à l'installation. Pour cela, il suffit d'écrire les différentes commandes qui suivent dans un terminal :
<pre> sudo apt-get update </pre>

L'option ''update'' met à jour la liste des fichiers disponibles de configuration /etc/apt/sources.list. L'exécuter régulièrement est une bonne pratique, afin de maintenir à jour votre liste de paquets disponibles.

NB : la commande ''apt-get'' est un outil logiciel à utiliser en ligne de commande. Il permet d'effectuer l'installation et la désinstallation de paquets.

<pre> sudo apt-get upgrade </pre>

L'option ''upgrade'' met à jour tous les paquets installés sur le système vers les dernières versions (couramment utilisé).

<pre> sudo apt-get install x11proto-core-dev make cmake libx11-dev mercurial git git-all subversion imagemagick gcc g++ exiv2 libimage-exiftool-perl libgeo-proj4-perl mesa-common-dev libgl1-mesa-dev libglapi-mesa libglu1-mesa qt5-default </pre>

[[Remarque :]] l'installation de ''Git'' vient remplacer celle de ''Mercurial''. En effet, ''Git'' est de loin le plus rapide des systèmes de gestion de versions existants et les dépôts ''Git'' sont particulièrement compacts. Il se distingue notamment par sa rapidité et sa gestion des branches qui permettent de développer en parallèle de nouvelles fonctionnalités, ce qui est très intéressant pour des travaux dits de "clustering".

<pre> sudo apt-get install x11proto-resource-dev cmake-curses-gui extra-cmake-modules libx11-6-dbg hgsubversion libimage-magick-perl </pre>

== Téléchargement de MicMac ==

Pour cloner MicMac dans le répertoire culture3d/ :

<pre> git clone https://geoportail.forge.ign.fr/culture3d/grit.git culture3d</pre>

Rentrez le login et le mot de passe suivants :
<pre> login: culture3d
pswd: culture3d </pre>

Ne vous inquiétez pas, le téléchargement peut prendre plusieurs minutes !

== Logiciel de compilation ==

À partir du répertoire d'installation, accédez au répertoire 'culture3d':

<pre> cd culture3d </pre>

Ensuite, vous devez créer un répertoire de construction et y aller:

<pre>
mkdir build
cd build
</pre>

Ensuite, vous devez générer le makefile avec les bonnes options. Pour générer le makefile défaut, exécutez ce qui suit :

<pre> sudo cmake ../ </pre>
<pre> sudo ccmake ../ </pre>

[[Remarque :]] Maintenant que vous êtes dans les configurations de cmake, mettez toutes les options de ''cmake'' en OFF, seule l'option ''WITH_HEADER_PRECOMP'' reste sur ON, puis configurez (''c'') et générez (''g'').

A partir de là, entrez dans :
<pre>culture3d/CodeExterne/Siftpp/</pre>

Il faut nécessairement vous placer dans le bon environnement afin de modifier le fichier Makefile.
Ajoutez-y la ligne :
<pre>Linux_armv71_ARCH : =glx</pre>

De la même manière, vous allez modifier le fichier ''sift_driver.cpp'' et ajouter la ligne ''#include<cstdint>''. En effet, le fichier Makefile tente de configurer automatiquement quelques paramètres. Si cela échoue, il renvoie une erreur. Ainsi, les commandes précédentes permettront au programme d'être exécuté sans aucun problème. Pour ce faire, c'est la commande ''vi '' qui va vous permettre de modifier à votre guise le fichier au sein même du terminal. Nous vous présentons succinctement son fonctionnement ci-dessous.

== Présentation de la commande ''vi'' ==
''vi'' offre deux modes de fonctionnement : le mode ''commande'' et le mode ''insertion''.

Au démarrage il est en mode commande, qui permet de déplacer le curseur, de parcourir le document et de copier-coller. On le quitte, en entrant du même coup en mode insertion, en utilisant une commande d'insertion ou de modification. En mode insertion il est possible de saisir du texte. Appuyez sur la touche Esc pour revenir en mode commande.

Pour sauvegarder ou quitter un fichier ''vi'', vous pouvez écrire différentes requêtes :
<pre>:w qui permet de sauvegarder le contenu du fichier
:x sauvegarde puis quitte
:q quitte vi sans sauvegarder les modifications
:q! quitte immédiatement, sans rien faire d'autre
</pre>
Vous pouvez également vous déplacer dans le document édité :
<pre>
f descend d'une page
b remonte d'une page
d descend d'1/2 page
u remonte d'1/2 page
X va à la ligne numérotée X
</pre>
Il se peut que vous vouliez insérer du texte, pour cela il vous suffit de vous inspirer de ce qu'il suit :
<pre>
i active le mode insertion
a active le mode insertion, un caractère après le curseur
I insère au début de la ligne
A insère à la fin de la ligne
O insère une ligne au-dessus du curseur et passe en mode insertion
o insère une ligne en dessous du curseur et passe en mode insertion
ESC quitte le mode insertion, revient en mode commande
</pre>
Pour supprimer du texte, il vous faut connaître les différentes requêtes suivantes :
<pre>
x supprime un caractère
dw supprime un mot
dnw supprime n mots
dd supprime une ligne
ndd supprime n lignes
</pre>
Ne vous inquiétez surtout pas en cas de modifications erronées, il existe un équivalent du ''Ctrl+z'' dans le terminal qui annule ou répète des modifications :
<pre>
u annule la dernière modification
U annule toutes les modifications effectuées sur la ligne courante
. répète les dernières modifications
</pre>

== Lancement de la compilation ==

Maintenant, nous pouvons enfin construire les sources en lançant les dernières commandes suivantes :

<pre> sudo make -j$NBRP </pre> où NBRP correspond au nombre de processeurs sur votre ARM (si vous n'êtes pas sûr de combien de cœurs vous avez, il suffit d'écrire un grand nombre et tous les noyaux seront utilisés) :
<pre> NBRP=$(cat /proc/cpuinfo | grep processor | wc -l)</pre>

Pour le lancement de la compilation, il ne vous reste plus qu'à écrire une dernière commande :
<pre> sudo make install </pre>

== Ajouter MicMac au chemin ==

Nous devons maintenant éditer le fichier contenant le chemin environnement qui se trouve dans ''/etc/culture3d/bin''. Ouvrez un terminal et tapez:
<pre> ~/.bashrc </pre>

'''Remarque :''' les fichiers dans "/ etc /" doivent être ouverts en tant qu'administrateur uniquement. Pour cela, ajoutez les lignes suivantes au bas du fichier:

<pre> export PATH=$PATH:~/culture3d/bin </pre>

MicMac devrait maintenant être installé dans votre dépôt personnel.

Pour vérifier si MicMac est bien installé sur votre ARM, vous pouvez taper dans un terminal:

<pre> mm3d </pre>

Install MicMac Ubuntu

2016-12-09T14:29:41Z

Nguyengiang41 : From Mecurial to Git

MicMac is an open source project and you can download the source code and compile the project yourself. This page presents the steps of the installation on a Linux system using apt-get (such as Ubuntu), but similar steps work on other systems.

Beware : the code available in the latest revision might not be stable or might not compile in a given OS.

== Get the source ==

The MicMac project is now hosted on the GitHub platform.
''On the former Mercuriel server (https://geoportail.forge.ign.fr/hg/culture3d), no source code updates will be applied (7017 is the latest revision).''

=== Install GitHub ===

<pre>sudo apt-get install git</pre>

=== Download the source ===
Go to the installation directory, where you want to install MicMac.

For “optimisation” reasons, the project files were divided into three GitHub sub-projects:

* https://github.com/micmacIGN/micmac : contains the source code of MicMac

* https://github.com/micmacIGN/Documentation : contains the documentation/manuals

* https://github.com/micmacIGN/Papers : contains some publications and other reports concerning MicMac

To retrieve the source code to micmac folder:
<pre>
git clone https://github.com/micmacIGN/micmac.git micmac
</pre>

== Build from sources ==
=== Classic installation ===
From the installation directory, move to the 'micmac' directory :
<pre>cd micmac/</pre>
Then, you have to create a build directory and go in it :
<pre>
mkdir build
cd build
</pre>
Then we have to generate the makefile with the right options. To generate the defaut makefile, run :
<pre>cmake ..</pre>
Now we can finally build the sources by launching :
<pre>
make install -jK
</pre>
Where K="number of processor in your computer" (if you are not sure how many cores you have, just write a big number and all of the cores will be used).

=== With Qt tools ===
If you want to use tools GUI such : SaisieAppuisInitQT, SaisieMasqQT etc... Use instead :
<pre>cmake -DWITH_QT5=1 ../</pre>
You have perhaps to install QT if it's not done :
<pre>sudo apt-get install qt5-default qttools5-dev-tools</pre>
NB : Version 5 is used here, use "-DWITH_QT4=1" instead if ou have QT v4.
Then you can run the normal process, see above.

==Add MicMac to path==
We have now to edit the file wich contains environnement path which is located in "/etc/bash.bashrc". The file is maybe hidden, so press CTRL+H, or activate "Hidden files" in Display (Top bar).
So open a terminal and type :
<pre>
sudo gedit /etc/bash.bashrc
</pre>
NB : files in "/etc/" have to be opened in super user mode.<br>
Add the following lines at the bottom of the file :<br>
<code>export PATH=/''micmac_install_directory''/micmac/bin:$PATH</code>

==Check Installation==
===List of MicMac tools===
To check if MicMac is well installed, you can type in a terminal :
<pre>mm3d</pre>
This will return the list of all tools available for micmac library.<br>

===Check dependencies===
Sometimes, even when the MicMac installation is good, you can encounter messages in the terminal such as :
*"Warning Exiftool not installed"
This warnings means that MicMac can't find an external tools.
MicMac integrates a module which can check if all dependencies are correctly installed. It can be called by typing :<br>
<pre>
mm3d CheckDependencies
</pre>

[[Image:checkdependencies.png|thumb|250px||alt=Exemple d'image en hauteur|Screenshot 1]]

You will get an output like Screenshot 1, with different informations :
*MicMac revision : micmac source code version number
*Qt : "enabled" permit you to use graphical interfaces such SaisieAppuisQT
*Kakadu : Image library for JPEG2000 management
*MicMac directory : Directory where MicMac is installed
*make :
*exiftool : library of image metadata management
*exiv2 : library of image metadata management
*convert :
*proj : library for cartographic projection
*cs2cs :

== Update sources ==
To update the sources, go in the installtion directory ("installation_directory/micmac") and type:
<pre>
git pull
</pre>

You have now to build again the sources:
<pre>
cd build
cmake ..
make install -j8
</pre>
NB : if you want still use QT, don't forget to use <code>cmake -DWITH_QT5=1 ../</code>

== Troubleshooting ==
=== Errors with cmake ===
*<code>...Could NOT find OpenGL (missing: OPENGL_gl_LIBRARY OPENGL_INCLUDE_DIR)...</code> => Try to install Qt

[[Category:Installation]]