Voir la source de Install MicMac MAC

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 Mac system using  [https://brew.sh HomeBrew].  Xcode and "command line developer tools" (sudo xcode-select --install) should be also installed

 brew install qt-creator
 brew install qt5
 brew install qt-creator-dev
 
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 Git ===

<pre> brew 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 ==
===Automatically===
This script [https://raw.githubusercontent.com/sbonaime/micmac/master/macos_script_install.sh script] can be used for an automatic compilation from sources on macos

=== Manually ===

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 -DWITH_QT5=1 ..</pre>

<div class="toccolours mw-collapsible mw-collapsed" style="background-color: Lavender">
<h6 style="font-family: Helvetica:font-size: 40px">About option -DWITH_QT5=1</h6>
<div class="mw-collapsible-content">

Use this option if you want to use tools GUI such : SaisieAppuisInitQT, SaisieMasqQT etc... Instead, use :
<pre>cmake ../</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.

</div>
</div>

In case cmake complains about missing Widgets library, you must export manually CMAKE_PREFIX_PATH with <pre>cmake -DWITH_QT5=1 -DCMAKE_PREFIX_PATH=/usr/local/Cellar/qt/5.10.0/ ../</pre> replacing 5.10.0 with whatever version is the latest being used.

We need to find the number of available processor on your mac using the following command

sysctl -n hw.ncpu

The result is the number should be used to finally build the sources by launching :
<pre>
make install -jK
</pre>
Where K is the number previously found (like 8 or 16...)

==Add MicMac to path==
For convenience we can add micmac bin folder to the PATH variable

Depending of the result of the command
<pre>
echo $0
</pre>

* for bash you should modify ~/.bashrc
* for zsh you should modify  ~/.zshrc

And add the following lines at the bottom of the file :<br>
<code>export PATH=/''micmac_install_directory/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> 'stdlib.h' file not found" </code> => [https://discourse.slicer.org/t/building-on-mac-10-14-mojave/4554]
*<code>Could NOT find OpenGL (missing: OPENGL_gl_LIBRARY OPENGL_INCLUDE_DIR)</code> => Try to install Qt
*<code>No CMAKE_CXX_COMPILER could be found. </code> => install g++ (sudo apt-get install g++)
*<code>Could not find a package configuration file provided by "Qt5OpenGL"</code> => install libqt5opengl5-dev
[[Category:Installation]]