MicMac - Contributions de l’utilisateur [fr]

Install MicMac Ubuntu

2017-03-21T10:55:51Z

V.tournadre :

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 ==
===Automatically===
The script_jenkins.sh available in micmac repository (or here : [https://github.com/micmacIGN/micmac/blob/master/script_jenkins_unix.sh]) can be used for an automatic compilation from sources.

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

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

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

GCPCtrl

2017-03-21T10:48:43Z

V.tournadre : Page créée avec « ==Description== GCPCtrl can be used to assess the accuracy of a set of orientation from Check Points. The tool computes the image and ground reprojection error for each G... »

==Description==

GCPCtrl can be used to assess the accuracy of a set of orientation from Check Points.
The tool computes the image and ground reprojection error for each GCP.
The tool is documented in DocMicMac.pdf (3.10.1.6 Accuracy Control with GCPCtrl).

==DocMicMac.pdf==
In photogrammetry, a standard method to control the accuracy of georeferencing result is to use couple of points called Check Points (CP). Check points, unlike Ground Control Points (GCPs), are used either to estimate the 3d similarity (GCPBascule) or for the compensation (Campari) on ground measurements. Residuals on check points allow to qualify the accuracy of the georeferencing result. If for a dataset, several ground measurements are available, a part may serve to perform georeferencing step (GCPBascule) while the rest of ground measurements can be used to qualify the accuracy and used as check points.

===Syntax===
<pre>mm3d GCPCtrl -help</pre>
Mandatory unnamed args :
* string :: {Full name (Dir+Pat)}
* string :: {Orientation in}
* string :: {Ground Control Points File}
* string :: {Image Measurements File}
Named args :
* [Name=CPI] bool :: {when Calib Per Image has to be used}
* [Name=ShowU] bool :: {Show unused point (def=true)}

===Example===
An example of the use of GCPCtrl:

<pre>mm3d GCPCtrl ".*JPG" Ori-RTL-Bascule CP.xml MesuresFinales-S2D.xml</pre>

Where:

— Ori-RTL-Bascule : are sets of orientations computed using Ground Control Points with (GCPBascule)

— CP.xml : are Check Points coordinates (not used to compute orientations of Ori-RTL-Bascule)

— MesuresFinales-S2D.xml : 2d Check Points coordinates

Residuals are used to estimate the accuracy. It is printed by GCPCtrl where D is the 3d residual and
P is vector of deviations in axial components:

''...

''Ctrl 1 GCP-Bundle, D=0.00711013 P=[0.00157584,0.00215343,0.0065904]

''Ctrl 2 GCP-Bundle, D=0.00213116 P=[-0.000812961,-7.10012e-05,0.00196873]

''Ctrl 3 GCP-Bundle, D=0.00503373 P=[-0.00225834,0.000504016,0.00447037]

''Ctrl 4 GCP-Bundle, D=0.013416 P=[-0.00209372,0.00171374,0.0131404]

''Ctrl 5 GCP-Bundle, D=0.00778608 P=[-0.00129931,-0.000609828,-0.00765265]

''Ctrl 6 GCP-Bundle, D=0.00432863 P=[-0.00166909,-0.00255773,-0.00306743]

''Ctrl 7 GCP-Bundle, D=0.00536168 P=[0.00157972,-0.0050588,0.000812824]

''Ctrl 8 GCP-Bundle, D=0.00493167 P=[-0.000829516,0.00146171,-0.00463645]

''Ctrl 9 GCP-Bundle, D=0.00217372 P=[-0.000790291,-0.00131989,0.0015357]

''============================= ERRROR MAX PTS FL ======================

''|| Value=0.80781 for Cam=DSC08643.JPG and Pt=7 ; MoyErr=0.698737

''======================================================================

ConvertCalib

2017-03-21T10:36:17Z

V.tournadre : Page créée avec « ==Description== ConvertCalib is a tool that can be used to convert a camera model into another form (ex : convert a RadialStd model into FraserBasic). Both models (in and... »

==Description==

ConvertCalib is a tool that can be used to convert a camera model into another form (ex : convert a RadialStd model into FraserBasic).
Both models (in and out) have to be in the MicMac form.
The tool is documented in DocMicMac.pdf (16.9.1 ConvertCalib to Calibration conversion).

==DocMicMac.pdf==
Sometimes it may be necessary to export a given calibration from one model to another model. For example from Fraser terrestrial model to aerial model. Of course as the mathematicall modelisation of the camera is not the same, this conversion will generally imlply some lost of accuracy. The tool ConvertCalib allow to do such conversion.

===Syntax===

<pre>mm3d ConvertCalib -help</pre>
Mandatory unnamed args :
* string :: {Input Calibration}
* string :: {Output calibration}
Named args :
* [Name=NbXY] INT :: {Number of point of the Grid}
* [Name=NbProf] INT :: {Number of depth}
* [Name=DRMax] INT :: {Max degree of radial dist (def=depend Output calibration)}
* [Name=DegGen] INT :: {Max degree of generik polynom (def=depend Output calibration)}
* [Name=PPFree] bool :: {Principal point free (Def=true)}
* [Name=CDFree] bool :: {Distorsion center free (def=true)}
* [Name=FocFree] bool :: {Focal free (def=true)}
* [Name=DecFree] bool :: {Decentrik free (def=true when appliable)}

The first argument is a file containg the calibration to be converted.
The second is a file that contains a model of the targeted calibration.
The optional arguments can be used to control which of the parameters should be adjusted or not.

===Example===
The folder Documentation/NEW-DATA/DocConvertCalib contains data to test this tool :
— Aerial.xml a calibration with aerial model (PPA and PPS separated);
— Fraser-Affine.xml a calibration with fraser model (PPA and PPS merged, decentric distorsion);
For example , if we want to produce a convertion to fraser model, without affine distorsion and a one
parameter of radial distorsion, we can run :
mm3d ConvertCalib Aerial.xml Fraser-Affine.xml DRMax=1 DegGen=0
....

''============================= ERRROR MAX PTS FL ======================

''||

''Value=0.145258 for Cam=Fraser-Affine.xml and Pt=Pt_0_0_1 ; MoyErr=0.0623394

''======================================================================

''--- End Iter 16 ETAPE 0

The average accuracy will be 0.063 pixel, it is measured as the average error re-projection of synthetic 3d points.

SetExif

2017-03-21T10:00:20Z

V.tournadre : Page créée avec « ==Description== SetExif is a handy tool to fill in (or modify) the main exif metadata required by MicMac (Focal Length, Focal Length equivalent 35mm, Camera Model Name).... »

==Description==

SetExif is a handy tool to fill in (or modify) the main exif metadata required by MicMac (Focal Length, Focal Length equivalent 35mm, Camera Model Name).

===Syntax===
The global syntax for SetExif is
<pre>mm3d SetExif ImagePattern</pre>

As is, the above command will have no effect, as the metadata to be written in the exif has to be specified through the optional arguments.

===Example===

Here is an example to fill in the metadata for an Olympus OM-D EM-5

<pre>mm3d SetExif "DSC.*JPG" F=24 F35=48 Cam="OM-D EM-5"</pre>
Note : You can implement new camera models in DicoCam.xml or by using MicMac-LocalChantierDescripteur.xml in your working directory
===Help===
You can access to the help by typing :
<pre>mm3d SetExif -help </pre>

Mandatory unnamed args :
* string :: {Pattern of images}
Named args :
* [Name=F] REAL :: {Focal length}
* [Name=F35] REAL :: {Focal length equiv 35mm}
* [Name=Cam] string :: {Camera model}
* [Name=Purge] bool :: {Purge created exiv2 command file (Def=true)}