Free open-source photogrammetry software tools
Permalink
Failed to load latest commit information.
BenchElise Qq evol doc Nov 24, 2016
CodeExterne Try to adopt a consistent and modern cmake style May 31, 2018
CodeGenere Bug dans Census corrigé Nov 18, 2018
ExtDataPrep Qq evol doc Nov 24, 2016
MMVII Evolution ds MMVII et recherche PtHom Nov 15, 2018
applis In AperiCloud : Option save point cloud without color attribute Sep 11, 2017
binaire-aux mm3d TestLib ConvHomolVSFM2MM => Convertir Homol du "Visual SFM" au M… May 30, 2017
completions Update completions to support arguments completion Mar 22, 2017
config Qq evol doc Nov 24, 2016
data Clean legacy files from subversion [ci skip] Dec 8, 2016
fdsc Qq evol doc Nov 24, 2016
include Bug dans Census corrigé Nov 18, 2018
install Micmac Qq evol doc Nov 24, 2016
scripts Qq evol doc Nov 24, 2016
src Bug dans Census corrigé Nov 18, 2018
.gitignore Try to adopt a consistent and modern cmake style May 31, 2018
.travis.yml Revert "Fix travis and appveyor compile without QT" Oct 29, 2018
CMakeLists.txt Revert "Fusion" Oct 29, 2018
COPYING Qq evol doc Nov 24, 2016
Doxyfile.in Qq evol doc Nov 24, 2016
LISEZMOI.md Correct links in LISEZMOI.md as well May 29, 2018
Makefile-XML2CPP Dans le debut de la doc MMVII Dec 3, 2017
README.md Merge pull request #79 from bonaime/patch-1 May 29, 2018
appveyor.yml Revert "Fix travis and appveyor compile without QT" Oct 29, 2018
build_MSVS2010.bat Qq evol doc Nov 24, 2016
build_Unix.sh Qq evol doc Nov 24, 2016
clonehg.txt Qq evol doc Nov 24, 2016
make_binaries_package.sh Qq evol doc Nov 24, 2016
make_interface_source_archive.sh Qq evol doc Nov 24, 2016
make_source_archive.sh Qq evol doc Nov 24, 2016
mk_ubuntu_src.sh Qq evol doc Nov 24, 2016
output_elise_files.cmake Qq evol doc Nov 24, 2016
pom.xml Qq evol doc Nov 24, 2016
precompiled_headers.cmake Update precompiled_headers.cmake Dec 7, 2016
script_create_bin_dist.sh Update script_create_bin_dist.sh May 28, 2018
script_jenkins_unix.sh Qq evol doc Nov 24, 2016
set_macosx_dylib.sh Qq evol doc Nov 24, 2016
simple_makefile Qq evol doc Nov 24, 2016
test_Unix.sh Qq evol doc Nov 24, 2016
test_Win.bat Qq evol doc Nov 24, 2016
vincennes_test.sh Qq evol doc Nov 24, 2016

README.md

Version française

Prerequisites

Some external tools need to be present on your system for Micmac to run properly :

  • make for parallel processes management,
  • convert, from ImageMagick, for image format conversion,
  • exiftool and exiv2, to read/write image meta-data,
  • proj4 for coordinate system conversion.

On Debian/Ubuntu distribution you can easily install these tools by calling this command:

sudo apt-get install make imagemagick libimage-exiftool-perl exiv2 proj-bin qt5-default

You can check before-hand that Micmac is able to find those programs by calling the command:

bin/mm3d CheckDependencies (in Micmac directory)

NOT FOUND near one of the tools indicates either the specified executable is not on your disk or it cannot be found in the directories of the PATH environment variable. There is also a special directory for tool finding which is named binaire-aux, in Micmac directory. When an external program is needed, this directory is always scanned whatever the value of PATH.

Additionnal notes for Windows

You will need Visual C++ 2010 runtime redistribuables to run pre-compiled binaries of micmac. Both pre-compiled and compiled from source executables will need :

One of WINDIR or SystemRoot environment variable must be set to Windows' installation directory (C:\Windows in much cases). This prevents Micmac from calling a convert.exe that is not ImageMagick's convert tool but a network utility used by the system. Since Windows does not have an easy-to-use package manager, a version of make, convert, exiftool and exiv2 are delivered with the source and Windows binaries archives. They are placed in the binaire-aux directory.

Compiling from the sources' archive

Prerequisites

In addition of previously named tools, people willing to compile binaries from the source code will need to install the cmake program. Linux and MacOS X users may also want to get X11 header files in order to generate graphical functionalities like SaisieBasc, SaisieMasque, etc ... The package of X11 headers is general called libx11-dev under Linux distributions. X11-based tools are not available in the Windows version. Windows users may need Qt5 libraries to generate graphical interfaces such as SaisieMasqQT.

Compiling process for Linux / MacOS X

  • clone the git repository : git clone https://github.com/micmacIGN/micmac.git
  • enter 'micmac' directory : cd micmac
  • create a directory for the build's intermediate files, then enter it : mkdir build & cd build
  • generate makefiles using cmake : cmake ../
  • process compilation : make install -j*cores number* (ex.: make install -j4)

Compiling process for Visual C++ (Windows)

The first steps are the same as for a Linux/MacOS build except for the make call. Instead of makefiles, Cmake generates a Visual C++ solution, named micmac.sln. Open it and compile the INSTALL project. Be sure to be in Release configuration, for Micmac is much faster built this way than in Debug mode. Again, do not compile the entire solution but just the INSTALL project, otherwise compiled binaries won't be copied in the bin directory and this will prevent Micmac from working.

Installation test

The website logiciels.ign.fr also provides a test dataset called Boudha_dataset.zip. This file contains images and configuration files needed to compute the Boudha example from Micmac's documentation. By calling the script this way :

./boudha_test.sh my_micmac_bin/

assuming your working directory is the Boudha directory contained in the file, you can process all the tool-chain until dense point matching.

'my_micmac_bin' is a path to the 'bin' directory of your installation. ex.: ./boudha_test.sh ../micmac/bin/ This example assumes 'Boudha' directory (containing data) and 'micmac' (installation directory) have the same parent directory. Notice the ending '/', it's mandatory for the script to work. After some computation time, you may find three 'ply' files in the 'MEC-6-Im' directory with the three parts of the dense points cloud of the statue's head. Open the PLY files with a viewer like meshlab to check everything proceeded correctly.

Additionnal notes

You can append the full path of the bin directory to PATH environment variable to call Micmac commands from anywhere. However, it is not necessary to add the binaire-aux directory to the PATH variable.

For Linux / MacOSX, you have to append the path to the lib directory to LD_LIBRARY_PATH in .bashrc to be able to use QT tools. Add the following line: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/micmac/lib/

For MacOSX, if you want to use QT tools with precompiled binaries available on logiciels.ign.fr, you need to install Qt libraries for Mac from http://download.qt-project.org