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

 brew install git

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:

git clone https://github.com/micmacIGN/micmac.git micmac

Build from sources

Automatically

This script script can be used for an automatic compilation from sources on macos

Manually

From the installation directory, move to the 'micmac' directory :

cd micmac/

Then, you have to create a build directory and go in it :

mkdir build
cd build

Then we have to generate the makefile with the right options. To generate the defaut makefile, run :

cmake -DWITH_QT5=1 ..

About option -DWITH_QT5=1

Use this option if you want to use tools GUI such : SaisieAppuisInitQT, SaisieMasqQT etc... Instead, use :

cmake ../

You have perhaps to install QT if it's not done :

sudo apt-get install qt5-default qttools5-dev-tools

NB : Version 5 is used here, use "-DWITH_QT4=1" instead if ou have QT v4.

In case cmake complains about missing Widgets library, you must export manually CMAKE_PREFIX_PATH with

cmake -DWITH_QT5=1 -DCMAKE_PREFIX_PATH=/usr/local/Cellar/qt/5.10.0/ ../

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 :

make install -jK

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

echo $0

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

And add the following lines at the bottom of the file :
export PATH=/micmac_install_directory/bin:$PATH

Check Installation

List of MicMac tools

To check if MicMac is well installed, you can type in a terminal :

mm3d

This will return the list of all tools available for micmac library.

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 :

mm3d CheckDependencies

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:

git pull

You have now to build again the sources:

cd build
cmake ..
make install -j8

NB : if you want still use QT, don't forget to use cmake -DWITH_QT5=1 ../

Troubleshooting

Errors with cmake

• 'stdlib.h' file not found" => [1]
• Could NOT find OpenGL (missing: OPENGL_gl_LIBRARY OPENGL_INCLUDE_DIR) => Try to install Qt
• No CMAKE_CXX_COMPILER could be found. => install g++ (sudo apt-get install g++)
• Could not find a package configuration file provided by "Qt5OpenGL" => install libqt5opengl5-dev