MicMac - Contributions de l’utilisateur [fr]

Utilisateur:LewisKelleher

2018-10-12T11:48:16Z

Maximeseguin : Page blanchie

HomolFilterMasq

2018-10-11T15:40:11Z

Maximeseguin :

==Description==

This command can be used when you have the necessary spatial information to retrieve false tie points.
The command HomolFilterMasq can do some filtering on tie points. The masking process can be purerly in image geometry or can be done in some ground geometry.

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

===Workflow===
HomolFilterMasq is a tool dedicated to filter tie point. So you have to use it after tie points computation by Tapioca and before orientation computation by Tapas (or Martini) and before tie point reduction by Schnaps.<br>
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]]<br>
[[Image:Picto-next.png|20px]] Next Command : [[Schnaps]],[[Tapas]],[[Martini]].<br>


===Help===
You can access to the help by typing :
<pre>mm3d HomolFilterMasq -help</pre>

Mandatory unnamed args :
* string :: {Full name (Dir+Pat)}
Named args :
* [Name=PostPlan] string :: {Post to plan, Def : toto ->toto_Masq.tif like with SaisieMasq}
* [Name=GlobalMasq] string :: {Global Masq to add to all image}
* [Name=KeyCalculMasq] string :: {For tuning masq per image}
* [Name=KeyEquivNoMasq] string :: {When given if KENM(i1)==KENM(i2), don't masq}
* [Name=Resol] REAL :: {Sub Resolution for masq storing, Def=10}
* [Name=ANM] bool :: {Accept no mask, def = true if MasqGlob and false else}
* [Name=ExpTxt] bool :: {Ascii format for in and out, def=false}
* [Name=PostIn] string :: {Post for Input dir Hom, Def=}
* [Name=PostOut] string :: {Post for Output dir Hom, Def=MasqFiltered}
* [Name=OriMasq3D] string :: {Orientation for Masq 3D}
* [Name=Masq3D] string :: {File of Masq3D, Def=AperiCloud_${OriMasq3D}.ply}
* [Name=SelecTer] Pt2dr :: {[Per,Prop] Period of tiling on ground selection, Prop=proporion of selected}
* [Name=DistId] REAL :: {Supress pair such that d(P1,P2) < DistId, def unused}
* [Name=DistH] REAL :: {Distance for filtering homologous point}

==Main options==

===PostPlan===
Set PostPlan=Filter if you have changed the default postfix used by SaisieMasq.
By default it will generate an error if a masq does not exist : set ANM=true if you know that non existing masq for some images is normal.

===GlobalMasq===
Set GlobalMasq if you have a masq common to all images (for example if you want to filter fiducial marqs).

===KeyCalculMasq===
If you want to apply a set of masks depending on the name of the pictures, you can add a computation key in MicMac-LocalChantierDescripteur.xml.

Example :
<pre>
<Global>
<ChantierDescripteur>
[...]
<KeyedNamesAssociations>
<IsParametrized> true </IsParametrized>
<Calcs>
<Arrite> 1 1 </Arrite>
<Direct>
<PatternTransform> [0-9]{4}_cam_([0-9]{3})\.tif </PatternTransform>
<CalcName> masq_$1.tif </CalcName>
</Direct>
</Calcs>
<Key> MyKeyCalculMasq </Key>
</KeyedNamesAssociations>
</ChantierDescripteur>
</Global>
</pre>
Then use KeyCalculMasq=MyKeyCalculMasq on HomolFilterMasq command line to automatically use the correct mask.

===Masq3D===
To use a file 3D masq as seized by SaisieMasqQT with a AperiCloud.ply file.
If you want to use this option, the orientation must be indicated with the option OriMasq3D.

===SelecTer===
This option can be used to decrease the number of tie-points while maintaining the proportion of multiplicity.
If SelecTer=[Per,Prop], then in each tile of size S = Per * Resol in the ground coordinate 1 the point are selected in the subtile of size S * Prop^0.5

===DistId===
This option supress the pair of point P1,P2 such that d(P1,P2) < DistId. This can be usefull when the acquistion was made using a turn table to automatically supress the points on the background.

HomolFilterMasq

2018-10-11T15:28:58Z

Maximeseguin :

==Description==

This command can be used when you have the necessary spatial information to retrieve false tie points.
The command HomolFilterMasq can do some filtering on tie points. The masking process can be purerly in image geometry or can be done in some ground geometry.

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

===Workflow===
HomolFilterMasq is a tool dedicated to filter tie point. So you have to use it after tie points computation by Tapioca and before orientation computation by Tapas (or Martini) and before tie point reduction by Schnaps.<br>
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]]<br>
[[Image:Picto-next.png|20px]] Next Command : [[Schnaps]],[[Tapas]],[[Martini]].<br>


===Help===
You can access to the help by typing :
<pre>mm3d HomolFilterMasq -help</pre>

Mandatory unnamed args :
* string :: {Full name (Dir+Pat)}
Named args :
* [Name=PostPlan] string :: {Post to plan, Def : toto ->toto_Masq.tif like with SaisieMasq}
* [Name=GlobalMasq] string :: {Global Masq to add to all image}
* [Name=KeyCalculMasq] string :: {For tuning masq per image}
* [Name=KeyEquivNoMasq] string :: {When given if KENM(i1)==KENM(i2), don't masq}
* [Name=Resol] REAL :: {Sub Resolution for masq storing, Def=10}
* [Name=ANM] bool :: {Accept no mask, def = true if MasqGlob and false else}
* [Name=ExpTxt] bool :: {Ascii format for in and out, def=false}
* [Name=PostIn] string :: {Post for Input dir Hom, Def=}
* [Name=PostOut] string :: {Post for Output dir Hom, Def=MasqFiltered}
* [Name=OriMasq3D] string :: {Orientation for Masq 3D}
* [Name=Masq3D] string :: {File of Masq3D, Def=AperiCloud_${OriMasq3D}.ply}
* [Name=SelecTer] Pt2dr :: {[Per,Prop] Period of tiling on ground selection, Prop=proporion of selected}
* [Name=DistId] REAL :: {Supress pair such that d(P1,P2) < DistId, def unused}
* [Name=DistH] REAL :: {Distance for filtering homologous point}

==Main options==

===PostPlan===
Set PostPlan=Filter if you have changed the default postfix used by SaisieMasq.
By default it will generate an error if a masq does not exist : set ANM=true if you know that non existing masq for some images is normal.

===GlobalMasq===
Set GlobalMasq if you have a masq common to all images (for example if you want to filter fiducial marqs).

===KeyCalculMasq===
If you want to apply a set of masks depending on the name of the pictures, you can add a computation key in MicMac-LocalChantierDescripteur.xml.
<\br>
Example :

<Global>
<ChantierDescripteur>
[...]
<KeyedNamesAssociations>
<IsParametrized> true </IsParametrized>
<Calcs>
<Arrite> 1 1 </Arrite>
<Direct>
<PatternTransform> [0-9]{4}_cam_([0-9]{3})\.tif </PatternTransform>
<CalcName> masq_$1.tif </CalcName>
</Direct>
</Calcs>
<Key> MyKeyCalculMasq </Key>
</KeyedNamesAssociations>
</ChantierDescripteur>
</Global>

Then use KeyCalculMasq=MyKeyCalculMasq on HomolFilterMasq command line to automatically use the correct mask.

===Masq3D===
To use a file 3D masq as seized by SaisieMasqQT with a AperiCloud.ply file.
If you want to use this option, the orientation must be indicated with the option OriMasq3D.

===SelecTer===
This option can be used to decrease the number of tie-points while maintaining the proportion of multiplicity.
If SelecTer=[Per,Prop], then in each tile of size S = Per � Resol in the ground coordinate 1 the
point are selected in the subtile of size S �
p
Prop

===DistId===
This option supress the pair of point P1,P2 such that d(P1,P2) < DistId. This can be usefull when the acquistion was made using a turn table to automatically supress the points on the background.

HomolFilterMasq

2018-10-11T15:08:20Z

Maximeseguin : Page créée avec « ==Description== This command can be used when you have the necessary spatial information to retrieve false tie points. The command HomolFilterMasq can do some filtering o... »

LumRas

2018-05-27T12:21:04Z

Maximeseguin :

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
The LumRas command, allows to mix a master image with raking lights images.

===Syntax===
The global syntax for LumRas is :
<pre>mm3d LumRas MasterImage RakingLightImages NamedArgs</pre>

===Workflow===

[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]]<br>


===Help===

Mandatory unnamed args :
*string :: {Master Image}
*string :: {Raking Light Images Files}
Named args :
*[Name=Masq] string :: postfix for masq file (default=_Masq)

===Example===
For this example, we consider :
* a master image with ambiant light : IMG_0001.JPG,
* a masq on the object in the master image (result of command : SaisieMasq "IMG_0001.JPG"),
* three raking light images.

<pre>mm3d LumRas "IMG_0001.JPG" "IMG_000[2-4].JPG" Masq="_Masq"</pre>

LumRas

2018-05-27T12:20:18Z

Maximeseguin :

LumRas

2018-05-27T12:16:02Z

Maximeseguin : Page créée avec « 25px List of commands ==Description== The LumRas command, allows to mix a master image with raking lights images. ===Syntax=== The g... »

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
The LumRas command, allows to mix a master image with raking lights images.

===Syntax===
The global syntax for LumRas is :
<pre>mm3d LumRas MasterImage RakingLightsImages NamedArgs</pre>

===Help===

Mandatory unnamed args :
*string :: {Full name (Dir+Pat)}
*string :: {Raking Light Images Files}
Named args :
*[Name=Masq] string :: postfix for masq file (default=_Masq)

===Example===
For this example, we consider :
* a master image with ambiant light : IMG_0001.JPG,
* a masq on the object in the master image (result of command : SaisieMasq "IMG_0001.JPG"),
* three raking light images.

<pre>mm3d LumRas "IMG_0001.JPG" "IMG_000[2-4]" Masq="_Masq"</pre>

Install MicMac MAC

2018-05-27T08:24:29Z

Maximeseguin : Ajout de -DWITH_QT5=1 suite à une issue sur Gihtub : https://github.com/micmacIGN/micmac/issues/69

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 cask install qt-creator
brew install qt5
brew cask 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 GitHub ===

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

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.

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