MicMac tools

2016-11-25T10:29:23Z

BorisLeroux : /* C */

== About all commands ==
All commands come with an inline Help that can be accessed by typing :

<pre>mm3d CommandName -help</pre>

Commands have Unnamed and Named arguments. The Unnamed are mandatory and must be given in order while the Named can be given in any order. For instance:

<pre>mm3d CommandName UnnamedValue1 UnnamedValue2 NamedArg1=NamedValue1 NamedArg2=NamedValue2</pre>

If you have a version of MicMac that include the QT tools (binaries from the [http://logiciels.ign.fr/?Telechargement,20 IGN download page] or self compiled with the QT option activated), each command come with a GUI containing the options to fill and a file selection tool when appropriate. These GUI can be called using the command with a ''v'' prefix:

<pre>mm3d vCommandName</pre>

== Commands ==
=== A ===
*[[ AperiCloud]] : Visualization of camera in ply file
*[[ Apero]] : Compute external and internal orientations
*[[ Apero2Meshlab]] : Convert Orientation from Apero-Micmac workflow to a meshlab-compatible format
*[[ Apero2NVM]] : Matthieu Moneyrond's convertor to VSfM, MVE, SURE, MeshRecon
*[[ Apero2PMVS]] : Convert Orientation from Apero-Micmac workflow to PMVS format
*[[ AperoChImSecMM]] : Select secondary images for MicMac
*[[ Arsenic]] : IN DEV : Radiometric equalization from tie points
*[[ Aspro]] : Init External orientation of calibrated camera from GCP

=== B ===
*[[ Bascule]] : Generate orientations coherent with some physical information on the scene
*[[ BatchFDC]] : Tool for batching a set of commands
*[[ Blinis]] : Block Initialisation
=== C ===
*[[ C3DC]] : Automatic Matching from Culture 3D Cloud project
*[[ CalibFinale]] : Compute Final Radial distortion model
*[[ CalibInit]] : Compute Initial Radial distortion model
*[[ Campari]] : Interface to Apero, for compensation of heterogeneous measures
*[[ CASA]] : Analytic Surface Estimation
*[[ CenterBascule]] : Relative to absolute using embedded GPS
*[[ ChantierClip]] : Clip Chantier
*[[ CheckDependencies]] : check dependencies to third-party tools
*[[ ChgSysCo]] : Change coordinate system of orientation
*[[ ClipIm]] : Clip Chantier
*[[ CmpCalib]] : Compare two calibrations
*[[ CmpIm]] : Basic tool for images comparison
*[[ CmpOri]] : Compare two sets of orientation
*[[ CoherEpip]] : Test coherence between conjugate epipolar depth-map
*[[ ContrastFilter]] : Some contrast filtering
*[[ Convert2GenBundle]] : Import RPC or other to MicMac format, for adjustment, matching ...
*[[ ConvertCalib]] : Conversion of calibration from one model 2 the other
*[[ ConvertIm]] : Tool for convertion inside tiff-format
*[[ CreateEpip]] : Create epipolar images
*[[ Coordinates Systems]] : How coordinates systems are defined on MicMac.

=== D ===
*[[ Dequant]] : Tool for dequantifying an image
*[[ Digeo]] : In development- Will compute tie points
*[[ DIV]] : Videos development (require ffmpeg)
*[[ Donuts]] : Cyl to Torus (Donuts like)
*[[ Drunk]] : Images distortion removing tool

=== E ===
*[[ ExtractAppui3D]] : Extract points from a 3D appui points xml file
*[[ ExtractMesure2D]] : Extract points from a 2D measures xml file

=== F ===
*[[ FFTKugelhupf]] : Version of Kugelhupf using FFT, expecetd faster when it works (if ever ...)
*[[ FieldDep3d]] : To export results of matching as 3D shifting
=== G ===
*[[ GCPBascule]] : Relative to absolute using GCP
*[[ GCPConvert]] : Convert GCP from Txt 2 XML
*[[ GCPCtrl]] : Control accuracy with GCP
*[[ GCPVisib]] : Print a list of GCP visibility in images
*[[ Genepi]] : Generate 3D/2d synthetical points from orientation
*[[ Genere_Header_TiffFile]] : Generate Header for internal tiling format
*[[ GenPairsFile]] : Generate pairs files between one image and a pattern
*[[ GrapheHom]] : Compute XML-Visibility graph from approximate orientation
*[[ GrShade]] : Compute shading from depth image

=== H ===
*[[ HomolFilterMasq]] : Tool for filter homologous points according to masq
*[[ HomolMergePDVUnik]] : Tool for merge homologous point from unik point of view
=== I ===
*[[ Im2XYZ]] : tool to transform a 2D point (text file) to their 3D cloud homologous
*[[ ImMire]] : For generation of some synthetic calibration image
*[[ Impaint]] : Basic Impainting
*[[ ImRandGray]] : Generate Random Gray Textured Images
*[[ Init11P]] : Init Internal & External from GCP using 11-parameters algo
*[[ InitOriLinear]] : Initialize orientation for linear acquisition
=== K ===
*[[ Kugelhupf]] : Semi-automatic fiducial points determination
=== L ===
*[[ Liquor]] : Orientation specialized for linear acquisition
*[[ LumRas]] : Compute image mixing with raking light
=== M ===
*[[ MakeGrid]] : Generate orientations in a grid format
*[[ Malt]] : Simplified matching (interface to MicMac)
*[[ MapCmd]] : Transforms a command working on a single file in a command working on a set of files
*[[ Martini]] : New orientation initialisation (uncomplete, still in dev...)
*[[ MartiniGin]] : New orientation initialisation (uncomplete, still in dev...)
*[[ MergeDepthMap]] : Merging of individual, stackable, depth maps
*[[ MergeHomol]] : Merge Homol dir
*[[ MergePly]] : Merge ply files
*[[ MeshProjOnImg]] : Reproject mesh on image
*[[ MICMAC]] : Computes image matching from oriented images
*[[ MICMACSaisieLiaisons]] : Low level version of SEL, not recommended
*[[ MM1P]] : Matching One Pair of images
*[[ MM2DPosSism]] : Simplified interface for post 2D post sismic deformation
*[[ MMByP]] : Matching By Pair of images
*[[ MMCalcSzWCor]] : Compute Image of Size of correlation windows (Atomic tool, for adaptive window in geom image)
*[[ MMHomCorOri]] : Tool to compute homologues for correcting orientation in epip matching
*[[ MMInitialModel]] : Initial Model for MicMac
*[[ MMMergeCloud]] : Merging of low resol cloud, in preparation 2 MicMac
*[[ MMPyram]] : Computes pyram for micmac (internal use)
*[[ MMTestAllAuto]] : Full automatic version for 1 view point, test mode
*[[ MMTestOrient]] : Tool for testing quality of orientation
*[[ MMXmlXif]] : Generate Xml from Xif (internal use mainly)
*[[ mmxv]] : Interface to xv (due to problem in tiff lib)
*[[ Morito]] : Merge set of Orientations with common values
*[[ MpDcraw]] : Interface to dcraw
*[[ MPDtest]] : My own test
*[[ MyRename]] : File renaming using posix regular expression
=== N ===
*[[ NewTapas]] : Replace OldTapas - now same as Tapas
*[[ Nuage2Ply]] : Convert depth map into point cloud
*[[ NuageBascule]] : To Change geometry of depth map
=== O ===
*[[ OldTapas]] : Interface to Apero to compute external and internal orientations
*[[ Ori2Xml]] : Convert "historical" Matis'Ori format to xml
*[[ OriConvert]] : Convert Orientation from Txt 2 XML
*[[ OriExport]] : Export orientation from XML to XML or TXT with specified convention
*[[ OriRedTieP]] : Tie points filtering, using Martini results
=== P ===
*[[ PanelIm]] : Tool for creating a panel of images
*[[ Pasta]] : Compute external calibration and radial basic internal calibration
*[[ Pastis]] : Tie points detection
*[[ PatFromOri]] : Get pattern of images from Ori folder
*[[ PHO_MI]] : Filter homologue points from initial orientation to reduce number of observations
*[[ PIMs]] : Per Image Matchings
*[[ PIMs2Mnt]] : Generate Mnt from Per Image Matchings
*[[ PIMs2Ply]] : Generate Ply from Per Image Matchings
*[[ Porto]] : Generates a global ortho-photo
*[[ Prep4masq]] : Generates files for making Masks (if SaisieMasq unavailable)

=== R ===
*[[ Ratafia]] : Some stuff to be described later
*[[ RedTieP]] : Test tie points filtering
*[[ RepLocBascule]] : Tool to define a local repair without changing the orientation
*[[ ReprojImg]] : Reproject an image into geometry of another
*[[ ReSampFid]] : Resampling using one fiducial mark

=== S ===
*[[ SaisieAppuisInit]] : Interactive tool for initial capture of GCP
*[[ SaisieAppuisInitQT]] : Interactive tool for initial capture of GCP
*[[ SaisieAppuisPredic]] : Interactive tool for assisted capture of GCP
*[[ SaisieAppuisPredicQT]] : Interactive tool for assisted capture of GCP
*[[ SaisieBasc]] : Interactive tool to capture information on the scene
*[[ SaisieBascQT]] : Interactive tool to capture information on the scene
*[[ SaisieBoxQT]] : Interactive tool to capture 2D box
*[[ SaisieCyl]] : Interactive tool to capture information on the scene for cylinders
*[[ SaisieCylQT]] : Interactive tool to capture information on the scene for cylinders
*[[ SaisieMasq]] : Interactive tool to capture masq
*[[ SaisieMasqQT]] : Interactive tool to capture masq
*[[ SaisiePts]] : Tool to capture GCP (low level, not recommended)
*[[ Sake]] : Simplified MicMac interface for satellite images
*[[ SateLib]] : Library of satellite images meta-data handling - early work in progress!
*[[ SBGlobBascule]] : Tool for 'scene based global' bascule
*[[ ScaleIm]] : Tool for image scaling
*[[ ScaleNuage]] : Tool for scaling internal representation of point cloud
*[[ Schnaps]] : Reduction of homologue points in image geometry
*[[ ScriptCalib]] : Do some stuff
*[[ SEL]] : Tool to visualize tie points
*[[ SetExif]] : Modification of exif file (requires exiv2)
*[[ SetGpsExif]] : Add GPS infos in images exif meta-data (requires exiv2)
*[[ Sift]] : Tool for extracting points of interest using Lowe's SIFT method
*[[ SimplePredict]] : Project ground points on oriented cameras
*[[ SMDM]] : Simplified Merging of individual, stackable, depth maps
*[[ SplitMPO]] : tool to develop MPO stereo format in pair of images
*[[ StackFlatField]] : Basic Flat Field estimation by image stacking
*[[ StatIm]] : Tool for basic stat on an image
*[[ SupMntIm]] : Tool for superposition of Mnt Im & level curve
*[[ SysCoordPolyn]] : Tool for creating a polynomial coordinate system from a set of known pair of coordinate
=== T ===
*[[ Tapas]] : NEW version !! Compatible . Call "OldTapas" if problem specific to this version
*[[ Tapioca]] : Interface to Pastis for tie point detection and matching
*[[ Tarama]] : Compute a rectified image
*[[ Tawny]] : Interface to Porto to generate ortho-image
*[[ Tequila]] : Texture mesh
*[[ TestBundleInter]] : Block Initialisation
*[[ TestCam]] : Test camera orientation convention
*[[ TestChantier]] : Test global acquisition
*[[ TestCmds]] : Test MM3D commands on micmac_data sets
*[[ TestDistM2C]] : Basic Test for problematic camera
*[[ TestKey]] : Test Keys for Sets and Assoc
*[[ TestLib]] : To call the program illustrating the library
*[[ TestMTD]] : Test meta data of image
*[[ TestNameCalib]] : Test Name of calibration
*[[ TestPbRPC]] : Test possible Problems on RPC
*[[ TestRegEx]] : Test regular expression
*[[ TiePAll]] : matches points of interest of two images
*[[ TiePByMesh]] : Raffiner pts homologue par mesh
*[[ TiePLine]] : matches points of interest of two images
*[[ TiePMS]] : matches points of interest of two images
*[[ TifDev]] : Develop raw-jpg-tif, in suitable tiff file
*[[ tiff_info]] : Tool for giving information about a tiff file
*[[ TiPunch]] : Compute mesh
*[[ to8Bits]] : Tool for converting 16 or 32 bit image in a 8 bit image.
*[[ TripleSec]] : Test Non Regression
=== U ===
*[[ Undist]] : Tool for removing images distortion
=== V ===
*[[ Vino]] : Image Viewer
*[[ Vodka]] : IN DEV : Compute the vignette correction parameters from tie points
*[[ VV]] : A very simplified tool for 3D model of visage out of video, just for fun

=== X ===
*[[ XifGps2Txt]] : Export embedded EXIF GPS data 2 Txt
*[[ XifGps2Xml]] : Create MicMac-Xml struct from GPS embedded in EXIF
*[[ XLib]] : Xeres Lib - early work in progress!
*[[ XYZ2Im]] : tool to transform a 3D point (text file) to their 2D proj in cam or cloud
=== Z ===
*[[ Zlimit]] : Crop Depth image (or DEM) in Z

Accueil

2016-11-23T09:40:39Z

BorisLeroux :

'''This wiki is under construction : Thank you for your understanding !'''

{| cellspacing=5 cellpadding=5 border=0 width=100%
|- style="background:#cee18e; color:black; font-size:18px; -moz-border-radius:8px;"
! width="75%" colspan="2" | Welcome on the Wiki dedicated to MicMac !
|-
|valign=middle|

Here you will find various informations related to Micmac, the photogrammetry software developped at the [http://www.ign.fr/ IGN] (French National Geographic Institute) and [http://www.ensg.eu/ ENSG] (French national school for geographic sciences). This wiki is maintained by the department of Aerial and Spatial Imagery (DIAS) of [http://www.ensg.eu/ ENSG] school.<br>

<table>
<tr>
<td>[[Image:IconeIntro.png|50px|link=Presentation]]</td>
<td style="width:50%">
<div style="padding:5px">
[[Presentation|<b>What is MicMac ?</b>]]<br>
<p style="font-size:8pt">Presentation of MicMac</p>
</div>
</td>
<td>[[Image:IconeTuto.png|50px|link=Tutorials]]</td>
<td>
<div style="padding:5px">
[[Tutorials|<b>Tutorials</b>]]<br>
<p style="font-size:8pt">Some exercices to learn how to use MicMac</p>
</div>
</td>
</tr>
<tr>
<td>[[Image:IconeInstall.png|50px|link=Install]]</td>
<td>
<div style="padding:5px">
[[Install|<b>Installation</b>]]<br>
<p style="font-size:8pt">How to install MicMac</p>
</div>
</td>
<td>[[Image:IconeTools.png|50px|link=MicMac tools]]</td>
<td>
<div style="padding:5px">
[[MicMac tools|<b>Tools</b>]]<br>
<p style="font-size:8pt">List of MicMac commands</p>
</div>
</td>
</tr>
<tr>
<td>[[Image:IconeForum.png|50px|link=Forum]]</td>
<td style="width:50%">
<div style="padding:5px">
[[Forum|<b>Forum</b>]]<br>
<p style="font-size:8pt">The Forum dedicated to MicMac</p>
</div>
</td>
<td>[[Image:IconeBiblio.png|50px|link=Bibliography]]</td>
<td>
<div style="padding:5px">
[[Bibliography|<b>Bibliography</b>]]<br>
<p style="font-size:8pt">Scientific papers presenting/using MicMac</p>
</div>
</td>
</tr>
<tr>
<td>[[Image:IconeContributor.png|50px|link=Contributors]]</td>
<td style="width:50%">
<div style="padding:5px">
[[Contributors|<b>Contributors</b>]]<br>
<p style="font-size:8pt">People who work on MicMac</p>
</div>
</td>
<td></td>
<td style="width:50%">
<div style="padding:5px">
[[Courses|<b>Courses</b>]]<br>
<p style="font-size:8pt">Digital photogrammetry courses</p>
</div>
</td>

</tr>
</table>

|halign=mid|[[Image:Micmac_gif2.gif]]
|}


{| cellspacing=5 cellpadding=5 border=0 width=100%
|- style="background:#cee18e; color:black; font-size:16px; -moz-border-radius:8px;"
! width="66%" | About the wiki !! External links
|-
|valign=top|
=====New MicMac Wiki=====
<noinclude>
* If you never used MediaWiki, you can find more information about it here : [https://meta.wikimedia.org/wiki/Help:Contents User Guide] + [https://www.mediawiki.org/wiki/Manual:FAQ FAQ MediaWiki]
* Here you can find [[Special:Allpages | every pages already online ]]
* If you have already an account, you can create your own personal profile [[ Special:Listusers | (Access with your UserId)]], once you are [[Special:Userlogin | logged]]
<br>

=====How to participate=====
If you want to take part of the building of this wiki, you are really welcome. But to keep this documentation structured and coherent, we use a special formalism :
* [[MicMacWiki_develop | How to collaborate in MicMac wiki ]].
|
{{External links}}

Accueil

2016-11-22T20:53:58Z

BorisLeroux : /* Rotation matrix */

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
The tool OriExport can convert MicMac external oriention to the de facto standard codification using
omega-phi-kappa. For now it's quite basic and all the options are not implemented. However, it should solve the majority
of problem relative to exporting resuls in classical photogrammetric softwares.

===Syntax===
The global syntax for OriExport is :
<pre>mm3d OriExport FullName Results NamedArgs</pre>

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

Mandatory unnamed args :
* string :: {Full Directory (Dir+Pattern)}
* string :: {Results}
Named args :
* [Name=AddF] bool :: {Add format as first line of header, def= false}
* [Name=ModeExp] string :: {Mode export, def=WPK (Omega Phi Kapa)}

==Example==
An example with Cuxha data set :
<pre>mm3d OriExport Ori-All-Rel/Orientation-Abbey-IMG_034.*.jpg.xml res.txt</pre>

=Formalism=
==Output==
OriExport will generate the file res.txt containinig :
<pre>
Abbey-IMG_0340.jpg -4.304443 11.785803 136.229854 -5.491274 2.702560 -0.004106
Abbey-IMG_0341.jpg -3.775959 11.249636 137.040260 -6.109496 2.042527 0.097497
Abbey-IMG_0342.jpg -3.849398 11.231276 137.533559 -6.707432 1.351133 0.224315
Abbey-IMG_0343.jpg -3.921196 11.302498 137.899618 -7.334180 0.668316 0.362218
</pre>
Which correspond to :
<pre>ImageName X Y Z omega phi kappa</pre>
NB : The image coordinates are exported in the system you have choosen (often a local euclidian frame).

==Rotation matrix==
Matrix R gives rotation terms to compute parameters in matrix encoding with respect to $\omega$-$\phi$-$\kappa$
angles given by the tool OriExport.

\begin{equation}
R=
\begin{pmatrix}
\cos(\phi)\cos(\kappa) & \cos(\phi)\sin(\kappa) & -\sin(\phi)\\
\cos(\omega)\sin(\kappa) + \sin(\omega)\sin(\phi)\cos(\kappa) & -\cos(\omega)\cos(\kappa) + \sin(\omega)\sin(\phi)\sin(\kappa) & \sin(\omega)\cos(\phi)\\
\sin(\omega)\sin(\kappa)-\cos(\omega)\sin(\phi)\cos(\kappa) & -\sin(\omega)\cos(\kappa)-\cos(\omega)\sin(\phi)\sin(\kappa) & -\cos(\omega)\cos(\phi)
\end{pmatrix}
\end{equation}

For example OriExport will give in degree:

The corresponding matrix encoding using R is:
<pre>
<ParamRotation>
<CodageMatr>
<L1>0.969777798578237427 -0.210783330505758815 0.122887790140630643</L1>
<L2>-0.199121821850641506 -0.974794184828703614 -0.100631989382226852</L2>
<L3>0.141001849092942777 0.0731210284736428379 -0.987305319416100224</L3>
</CodageMatr>
</ParamRotation>
</pre>