MicMac - Contributions de l’utilisateur [fr]

PIMs

2018-08-14T16:08:34Z

Mgaudin :

[[Image:picto-liste.png|25px]] [[Command|List of commands]]

==Description==
PIMs (Per Image Matchings tool) performs the dense matching in image geometry : it computes depth map for each image.

==Syntax==

The global syntax for PIMs is :
<pre>mm3d PIMs Type Immage_Pattern Orientation</pre>

===Mandatory unnamed args===
* string :: {Type in (Ground, Statue, Forest, TestIGN, QuickMac, MicMac, BigMac, MTDTmp)}
* string :: {Full Name (Dir+Pattern)}
* string :: {Orientation}

===Unmandatory named args===
* [Name=Masq3D] string :: {3D masq for point selection}
* [Name=Out] string :: {final result (Def=C3DC.ply)}
* [Name=SzNorm] INT :: {Sz of param for normal evaluation (<=0 if none, Def=2 means 5x5) }
* [Name=PlyCoul] bool :: {Colour in ply ? (Def = true)}
* [Name=Tuning] bool :: {Will disappear one day ...}
* [Name=Purge] bool :: {Purge result, (Def=true)}
* [Name=DownScale] REAL :: {DownScale of Final result, Def depends on mode}
* [Name=ZoomF] INT :: {Zoom final, Def depends on mode}
* [Name=UseGpu] bool :: {Use cuda (Def=false)}
* [Name=DefCor] REAL :: {Def correlation, context depend}
* [Name=ZReg] REAL :: {Regularisation, context depend}
* [Name=ExpTxt] bool :: {Use txt tie points for determining image pairs}
* [Name=FilePair] string :: {Explicit pairs of images (as in Tapioca)}
* [Name=DebugMMByP] bool :: {Debug MMByPair ...}
* [Name=Bin] bool :: {Generate Binary or Ascii (Def=true, Binary)}
* [Name=ExpImSec] bool :: {Export Images Secondair, def=true}

If <code>ZoomF</code> is specifed, indicates the Zoom Final (1 is full resolution, 2 is half...). Default value for each type of matching is:
* <code>BigMac</code> = 2
* <code>MicMac</code> = 4
* <code>QuickMac</code> = 8
* <code>Statue</code> = 2 (epipolair matching)
* <code>Forest</code> = 4 (epipolair matching)

==Workflow==

[[Image:Picto-previous.png|20px]] Previous Command : [[Campari]],[[AperiCloud]],[[SaisieMasqQT]] 
[[Image:Picto-next.png|20px]] Next Command : [[PIMs2Ply]],[[PIMs2MNT]]. 


==Example==
For example in the Grand Leez dataset, you can launch :
<pre>mm3d PIMs2Mnt Forest DoOrtho=1</pre>

Or in the Viabon dataset, you can launch :

<pre>mm3d PIMs QuickMac "image_002_00*.*tif" Ori-Compense-AF15P7-DPhase-La/ Masq3D=AperiCloud_Compense-AF15P7-DPhase-La_polyg3d.xml Out=NuageGps.ply FilePair=CpleImgs.xml</pre>

PIMs

2018-08-14T16:06:03Z

Mgaudin : /* Unmandatory named args */ Ajout informations sur ZoomF

[[Image:picto-liste.png|25px]] [[Command|List of commands]]

==Description==
PIMs (Per Image Matchings tool) performs the dense matching in image geometry : it computes depth map for each image.

==Syntax==

The global syntax for PIMs is :
<pre>mm3d PIMs Type Immage_Pattern Orientation</pre>

===Mandatory unnamed args===
* string :: {Type in (Ground, Statue, Forest, TestIGN, QuickMac, MicMac, BigMac, MTDTmp)}
* string :: {Full Name (Dir+Pattern)}
* string :: {Orientation}

===Unmandatory named args===
* [Name=Masq3D] string :: {3D masq for point selection}
* [Name=Out] string :: {final result (Def=C3DC.ply)}
* [Name=SzNorm] INT :: {Sz of param for normal evaluation (<=0 if none, Def=2 means 5x5) }
* [Name=PlyCoul] bool :: {Colour in ply ? (Def = true)}
* [Name=Tuning] bool :: {Will disappear one day ...}
* [Name=Purge] bool :: {Purge result, (Def=true)}
* [Name=DownScale] REAL :: {DownScale of Final result, Def depends on mode}
* [Name=ZoomF] INT :: {Zoom final, Def depends on mode}
* [Name=UseGpu] bool :: {Use cuda (Def=false)}
* [Name=DefCor] REAL :: {Def correlation, context depend}
* [Name=ZReg] REAL :: {Regularisation, context depend}
* [Name=ExpTxt] bool :: {Use txt tie points for determining image pairs}
* [Name=FilePair] string :: {Explicit pairs of images (as in Tapioca)}
* [Name=DebugMMByP] bool :: {Debug MMByPair ...}
* [Name=Bin] bool :: {Generate Binary or Ascii (Def=true, Binary)}
* [Name=ExpImSec] bool :: {Export Images Secondair, def=true}

If <code>ZoomF</code> is specifed, indicates the Zoom Final (1 is full resolution, 2 is half...). Default value for each type of matching is:
- <code>BigMac</code> = 2
- <code>MicMac</code> = 4
- <code>QuickMac</code> = 8
- <code>Statue</code> = 2 (epipolair matching)
- <code>Forest</code> = 4 (epipolair matching)

==Workflow==

[[Image:Picto-previous.png|20px]] Previous Command : [[Campari]],[[AperiCloud]],[[SaisieMasqQT]] 
[[Image:Picto-next.png|20px]] Next Command : [[PIMs2Ply]],[[PIMs2MNT]]. 


==Example==
For example in the Grand Leez dataset, you can launch :
<pre>mm3d PIMs2Mnt Forest DoOrtho=1</pre>

Or in the Viabon dataset, you can launch :

<pre>mm3d PIMs QuickMac "image_002_00*.*tif" Ori-Compense-AF15P7-DPhase-La/ Masq3D=AperiCloud_Compense-AF15P7-DPhase-La_polyg3d.xml Out=NuageGps.ply FilePair=CpleImgs.xml</pre>

Tapas

2018-08-14T15:33:28Z

Mgaudin : Ajout source

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
Tapas is a tool offering most of the posssibilities of [[Apero]] for computing purely relative orientations

===Syntax===
The global syntax for Tapas is
<pre>mm3d Tapas ModeCalib NamedArgs</pre>

=== Allowed commands ===
This allowed commands, correspond to the distorsion model you want to use :
*RadialBasic : for Classic Lens
*RadialStd : for Classic Lens
*RadialExtended : Classic Lens with extra distorsion parameters.
*FraserBasic
*Fraser
*FishEyeEqui : for FishEye Lens
*FE_EquiSolBasic
* FishEyeBasic
* FishEyeStereo
*Four
*AddFour
*AddPolyDeg
* Ebner
* Brown
* AutoCal
* Figee
* HemiEqui

==== Description ====

{| class="wikitable"
|+ Description of the basic distortion models easily accessible in MicMac
!scope=col|Command
!scope=col|PPA/PPS
!scope=col|Polynomial correction
!scope=col|Decentric/Affine correction
!scope=col|Number of parameters to estimate
|-
| <center><code>RadialBasic</code></center> || <center>Equals</center> || <center>r³, r⁵, r⁷</center> || <center>No</center> || <center>5</center>
|-
| <center><code>RadialStd</code></center> || <center>Different</center> || <center>r³, r⁵, r⁷</center> || <center>No</center> || <center>8</center>
|-
| <center><code>RadialExtended</code></center> || <center>Different</center> || <center>r³, r⁵, r⁷, r⁹, r¹¹</center> || <center>No</center> || <center>10</center>
|-
| <center><code>FraserBasic</code></center> || <center>Equals</center> || <center>r³, r⁵, r⁷</center> || <center>Yes</center> || <center>10</center>
|-
| <center><code>Fraser</code></center> || <center>Different</center> || <center>r³, r⁵, r⁷</center> || <center>Yes</center> || <center>12</center>
|}
Source : https://www.int-arch-photogramm-remote-sens-spatial-inf-sci.net/XL-3-W3/327/2015/isprsarchives-XL-3-W3-327-2015.pdf

===Results===
Tapas produce a directory named "Ori-Out_name" which contain :
*Camera calibration file : AutoCal[...].xml with camera parameters : focal length, PPP, distorsion parameters.
<pre>
<?xml version="1.0" ?>
<ExportAPERO>
<CalibrationInternConique>
<KnownConv>eConvApero_DistM2C</KnownConv>
<PP>3036.5765679584747 1998.71167135734891</PP> %Position of PPS in image
<F>4037.08453810194351</F> %Focal length
<SzIm>6000 4000</SzIm> %Image size
<CalibDistortion>
<ModRad> %Coefficient of distorsion
<CDist>3052.42394103968081 2001.86999748472294</CDist>
<CoeffDist>-4.50469053927919027e-09</CoeffDist>
<CoeffDist>3.40541430467215144e-16</CoeffDist>
<CoeffDist>6.26870361086794563e-25</CoeffDist>
<CoeffDistInv>4.51807038353698039e-09</CoeffDistInv>
<CoeffDistInv>-2.83621415930942252e-16</CoeffDistInv>
<CoeffDistInv>-1.28602811626265918e-23</CoeffDistInv>
<CoeffDistInv>5.99729269914569738e-31</CoeffDistInv>
</ModRad>
</CalibDistortion>
</CalibrationInternConique>
</ExportAPERO>
</pre>
*Orientation file for each picture : Orientation-image_name.xml with :camera orientation (3D similarity), tie points used for orientation etc...
<pre>
<?xml version="1.0" ?>
<ExportAPERO>
<OrientationConique>
<OrIntImaM2C>
<I00>0 0</I00>
<V10>1 0</V10>
<V01>0 1</V01>
</OrIntImaM2C>
<TypeProj>eProjStenope</TypeProj>
<ZoneUtileInPixel>true</ZoneUtileInPixel>
<FileInterne>Ori-Arbitrary/AutoCal_Foc-16000_Cam-ILCE6000.xml</FileInterne> %Camera model
<RelativeNameFI>true</RelativeNameFI>
<Externe>
<AltiSol>-8.50917595677101524</AltiSol>
<Profondeur>9.9233022137615734</Profondeur>
<Time>-1.00000000000000002e+30</Time>
<KnownConv>eConvApero_DistM2C</KnownConv>
<Centre>0.33581992261091842 -26.3001714173638206 0.000147586637632812767</Centre> %Position of the PPS in arbitrary system
<IncCentre>1 1 1</IncCentre>
<ParamRotation>
<CodageMatr> %Boresight matrix (arbitrary system)
<L1>-0.981263794354502505 -0.155204851492389134 0.11416137684098876</L1>
<L2>-0.192442661386862057 0.818245676864819083 -0.541700871672157969</L2>
<L3>-0.00933744972389951265 -0.553520971929031491 -0.832782892275888531</L3>
</CodageMatr>
</ParamRotation>
</Externe>
...
</pre>
When you use Tapas, a important part of informations are displaying directly in the terminal window, like image resiual or number of tie points used per images. Don't forget to look at this residuals when you use Tapas, for a good orientation you can decrease under 0.5px. All this informations are stocked in a file named "Residual.xml"

===Workflow===
Tapas process internal and relative orientation, you it's placed just after Tapas. The way to visualize relative orientation is to use AperiCloud. 
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]] 
[[Image:Picto-next.png|20px]] Next Command : [[AperiCloud]].

==RadialBasic==
a subset of previous model: radial distortion with limited degrees of freedom ; adapted when there is a risk of divergence of RadialExtended; in this model there are 5 degrees of freedom : 1 for focal length , 2 for principal point and distortion center 3 , 2 for coefficients of radial distortion (r3 and r5 ).

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}''
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}''
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}''
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}''
*[Name=ImInit] string :: {Force first image}''
*[Name=MOI] bool :: {MOI}''

==RadialExtended==
A model with radial distortion.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation} ''
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true)
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}

===Example===
For example with the Mur Saint Martin dataset, you can launch :
<pre>Tapas RadialExtended "IMGP41((6[7-9])|([7-8][0-9])).JPG"</pre>

==Fraser==
a radial model, with decentric and affine parameters there are 12 degrees of freedom: 1 for focal length , 2 for principal point, 2 for distortion center , 3 for coefficients of radial distorsion (r3 , r5 r7 ), 2 for decentric parameters, 2 for affine parameters; the optional parameters LibAff and LibDec (def value true) can be set to false if decentric of affine parameters must stay frozen.

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

Mandatory unnamed args :
*{Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==FraserBasic==
same as previous with for principal point and distortion center constrained to have the same value (so 10 degree of freedom)

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==FishEyeEqui==
a model adapted for diagonal fisheyes equilinear ( with atan physicall model com- pleted with polynomial parameters there are 14 degrees of freedom: 1 for focal length , 2 for principal point, 2 for distorsion center , 5 for coefficients of radial distortion (r3 , r5 r7 ), 2 for decentric parameters, 2 for affine parameters; by default the ray defining the useful mask is 95% of the diagonal.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==HemiEqui==
same model as previous, but by default the ray defining the useful mask s 52% of the diagonal; adapted to hemispheric equilinear fisheye.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky

Tapas

2018-08-14T15:26:31Z

Mgaudin : /* Description */ Ajout informations dans le tableau

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
Tapas is a tool offering most of the posssibilities of [[Apero]] for computing purely relative orientations

===Syntax===
The global syntax for Tapas is
<pre>mm3d Tapas ModeCalib NamedArgs</pre>

=== Allowed commands ===
This allowed commands, correspond to the distorsion model you want to use :
*RadialBasic : for Classic Lens
*RadialStd : for Classic Lens
*RadialExtended : Classic Lens with extra distorsion parameters.
*FraserBasic
*Fraser
*FishEyeEqui : for FishEye Lens
*FE_EquiSolBasic
* FishEyeBasic
* FishEyeStereo
*Four
*AddFour
*AddPolyDeg
* Ebner
* Brown
* AutoCal
* Figee
* HemiEqui

==== Description ====

{| class="wikitable"
|+ Description of the basic distortion models easily accessible in MicMac
!scope=col|Command
!scope=col|PPA/PPS
!scope=col|Polynomial correction
!scope=col|Decentric/Affine correction
!scope=col|Number of parameters to estimate
|-
| <center><code>RadialBasic</code></center> || <center>Equals</center> || <center>r³, r⁵, r⁷</center> || <center>No</center> || <center>5</center>
|-
| <center><code>RadialStd</code></center> || <center>Different</center> || <center>r³, r⁵, r⁷</center> || <center>No</center> || <center>8</center>
|-
| <center><code>RadialExtended</code></center> || <center>Different</center> || <center>r³, r⁵, r⁷, r⁹, r¹¹</center> || <center>No</center> || <center>10</center>
|-
| <center><code>FraserBasic</code></center> || <center>Equals</center> || <center>r³, r⁵, r⁷</center> || <center>Yes</center> || <center>10</center>
|-
| <center><code>Fraser</code></center> || <center>Different</center> || <center>r³, r⁵, r⁷</center> || <center>Yes</center> || <center>12</center>
|}

===Results===
Tapas produce a directory named "Ori-Out_name" which contain :
*Camera calibration file : AutoCal[...].xml with camera parameters : focal length, PPP, distorsion parameters.
<pre>
<?xml version="1.0" ?>
<ExportAPERO>
<CalibrationInternConique>
<KnownConv>eConvApero_DistM2C</KnownConv>
<PP>3036.5765679584747 1998.71167135734891</PP> %Position of PPS in image
<F>4037.08453810194351</F> %Focal length
<SzIm>6000 4000</SzIm> %Image size
<CalibDistortion>
<ModRad> %Coefficient of distorsion
<CDist>3052.42394103968081 2001.86999748472294</CDist>
<CoeffDist>-4.50469053927919027e-09</CoeffDist>
<CoeffDist>3.40541430467215144e-16</CoeffDist>
<CoeffDist>6.26870361086794563e-25</CoeffDist>
<CoeffDistInv>4.51807038353698039e-09</CoeffDistInv>
<CoeffDistInv>-2.83621415930942252e-16</CoeffDistInv>
<CoeffDistInv>-1.28602811626265918e-23</CoeffDistInv>
<CoeffDistInv>5.99729269914569738e-31</CoeffDistInv>
</ModRad>
</CalibDistortion>
</CalibrationInternConique>
</ExportAPERO>
</pre>
*Orientation file for each picture : Orientation-image_name.xml with :camera orientation (3D similarity), tie points used for orientation etc...
<pre>
<?xml version="1.0" ?>
<ExportAPERO>
<OrientationConique>
<OrIntImaM2C>
<I00>0 0</I00>
<V10>1 0</V10>
<V01>0 1</V01>
</OrIntImaM2C>
<TypeProj>eProjStenope</TypeProj>
<ZoneUtileInPixel>true</ZoneUtileInPixel>
<FileInterne>Ori-Arbitrary/AutoCal_Foc-16000_Cam-ILCE6000.xml</FileInterne> %Camera model
<RelativeNameFI>true</RelativeNameFI>
<Externe>
<AltiSol>-8.50917595677101524</AltiSol>
<Profondeur>9.9233022137615734</Profondeur>
<Time>-1.00000000000000002e+30</Time>
<KnownConv>eConvApero_DistM2C</KnownConv>
<Centre>0.33581992261091842 -26.3001714173638206 0.000147586637632812767</Centre> %Position of the PPS in arbitrary system
<IncCentre>1 1 1</IncCentre>
<ParamRotation>
<CodageMatr> %Boresight matrix (arbitrary system)
<L1>-0.981263794354502505 -0.155204851492389134 0.11416137684098876</L1>
<L2>-0.192442661386862057 0.818245676864819083 -0.541700871672157969</L2>
<L3>-0.00933744972389951265 -0.553520971929031491 -0.832782892275888531</L3>
</CodageMatr>
</ParamRotation>
</Externe>
...
</pre>
When you use Tapas, a important part of informations are displaying directly in the terminal window, like image resiual or number of tie points used per images. Don't forget to look at this residuals when you use Tapas, for a good orientation you can decrease under 0.5px. All this informations are stocked in a file named "Residual.xml"

===Workflow===
Tapas process internal and relative orientation, you it's placed just after Tapas. The way to visualize relative orientation is to use AperiCloud. 
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]] 
[[Image:Picto-next.png|20px]] Next Command : [[AperiCloud]].

==RadialBasic==
a subset of previous model: radial distortion with limited degrees of freedom ; adapted when there is a risk of divergence of RadialExtended; in this model there are 5 degrees of freedom : 1 for focal length , 2 for principal point and distortion center 3 , 2 for coefficients of radial distortion (r3 and r5 ).

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}''
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}''
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}''
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}''
*[Name=ImInit] string :: {Force first image}''
*[Name=MOI] bool :: {MOI}''

==RadialExtended==
A model with radial distortion.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation} ''
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true)
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}

===Example===
For example with the Mur Saint Martin dataset, you can launch :
<pre>Tapas RadialExtended "IMGP41((6[7-9])|([7-8][0-9])).JPG"</pre>

==Fraser==
a radial model, with decentric and affine parameters there are 12 degrees of freedom: 1 for focal length , 2 for principal point, 2 for distortion center , 3 for coefficients of radial distorsion (r3 , r5 r7 ), 2 for decentric parameters, 2 for affine parameters; the optional parameters LibAff and LibDec (def value true) can be set to false if decentric of affine parameters must stay frozen.

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

Mandatory unnamed args :
*{Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==FraserBasic==
same as previous with for principal point and distortion center constrained to have the same value (so 10 degree of freedom)

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==FishEyeEqui==
a model adapted for diagonal fisheyes equilinear ( with atan physicall model com- pleted with polynomial parameters there are 14 degrees of freedom: 1 for focal length , 2 for principal point, 2 for distorsion center , 5 for coefficients of radial distortion (r3 , r5 r7 ), 2 for decentric parameters, 2 for affine parameters; by default the ray defining the useful mask is 95% of the diagonal.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==HemiEqui==
same model as previous, but by default the ray defining the useful mask s 52% of the diagonal; adapted to hemispheric equilinear fisheye.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky

Tips & Tricks

2018-08-03T12:41:18Z

Mgaudin : Début page, à compléter

* Vous pouvez accéder à des interfaces de saisie graphique en ajoutant un "v" devant le nom de la commande MicMac (''vTapioca'', ''vTapas'', etc.)

* Si un jour vous lancez '''SaisieMasqQT''' et que votre nuage ne s'affiche pas, c'est peut-être qu'il est loin car dans un repère absolu. Si ça vous arrive, faites un double clic au centre de l'écran et ça devrait ramener votre nuage au centre !

Bascule

2018-08-02T12:44:51Z

Mgaudin : Ajout info de la documentation : Bascule est obsolète

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
Bascule generate orientations coherent with some physical information on the scene.

Bascule used to do, more a less, all of the functionalities done by [[SBGlobBascule]], [[GCPBascule]], [[RepLocBascule]] and [[CenterBascule]]; it is obsolete, still maintained for compatibility, but no longer documented.

===Syntax===
The global syntax for Bascule is: <pre>mm3d Bascule FullName Orientation Out_xml Named args</pre>

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

<pre>
Mandatory unnamed args :
*string :: {Full name (Dir+Pat)}
*string :: {Orientation in}
*string :: {Out: orientation or local repair (if postfixed by "xml")}

Named args :
*[Name=ImPl] vector<std::string>
*[Name=ExpTxt] INT
*[Name=PostPlan] string
*[Name=AllPl] bool
*[Name=UserKeyPlan] bool
*[Name=P1Rep] Pt2dr :: {P1Rep}
*[Name=P2Rep] Pt2dr :: {P2Rep}
*[Name=AxeRep] Pt2dr
*[Name=ImRep] string
*[Name=Teta] REAL :: {Angle (degree)}
*[Name=MesureIm] string :: {Image measure file}
*[Name=OrthoCyl] bool :: {Generate a local repair of orthocyl mode}
*[Name=DistFS] REAL :: {Distance between to fix scale, if not given no scaling}
*[Name=Norm] Pt3dr :: {Target normal for the plane}
*[Name=SNorm] Pt3dr :: {"Symbolic Normal" (must be X, Y or Z)}
*[Name=LimBsH] REAL :: {Limit ratio base to high (Def=1e-2)}
</pre>

Tapas

2018-07-31T15:38:05Z

Mgaudin : Ajout information sur les modèles de distorsion : un début...

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
Tapas is a tool offering most of the posssibilities of [[Apero]] for computing purely relative orientations

===Syntax===
The global syntax for Tapas is
<pre>mm3d Tapas ModeCalib NamedArgs</pre>

=== Allowed commands ===
This allowed commands, correspond to the distorsion model you want to use :
*RadialBasic : for Classic Lens
*RadialStd : for Classic Lens
*RadialExtended : Classic Lens with extra distorsion parameters.
*FraserBasic
*Fraser
*FishEyeEqui : for FishEye Lens
*FE_EquiSolBasic
* FishEyeBasic
* FishEyeStereo
*Four
*AddFour
*AddPolyDeg
* Ebner
* Brown
* AutoCal
* Figee
* HemiEqui

==== Description ====

{| class="wikitable"
|+Description of distorsion model
!scope=col|Command
!scope=col|Number of parameters to estimate
|-
| <center><code>RadialBasic</code></center> || <center>5</center>
|-
| <center><code>RadialStd</code></center> || <center>8</center>
|-
| <center><code>RadialExtended</code></center> || <center>10</center>
|-
| <center><code>FraserBasic</code></center> || <center>10</center>
|-
| <center><code>Fraser</code></center> || <center>12</center>
|}

===Results===
Tapas produce a directory named "Ori-Out_name" which contain :
*Camera calibration file : AutoCal[...].xml with camera parameters : focal length, PPP, distorsion parameters.
<pre>
<?xml version="1.0" ?>
<ExportAPERO>
<CalibrationInternConique>
<KnownConv>eConvApero_DistM2C</KnownConv>
<PP>3036.5765679584747 1998.71167135734891</PP> %Position of PPS in image
<F>4037.08453810194351</F> %Focal length
<SzIm>6000 4000</SzIm> %Image size
<CalibDistortion>
<ModRad> %Coefficient of distorsion
<CDist>3052.42394103968081 2001.86999748472294</CDist>
<CoeffDist>-4.50469053927919027e-09</CoeffDist>
<CoeffDist>3.40541430467215144e-16</CoeffDist>
<CoeffDist>6.26870361086794563e-25</CoeffDist>
<CoeffDistInv>4.51807038353698039e-09</CoeffDistInv>
<CoeffDistInv>-2.83621415930942252e-16</CoeffDistInv>
<CoeffDistInv>-1.28602811626265918e-23</CoeffDistInv>
<CoeffDistInv>5.99729269914569738e-31</CoeffDistInv>
</ModRad>
</CalibDistortion>
</CalibrationInternConique>
</ExportAPERO>
</pre>
*Orientation file for each picture : Orientation-image_name.xml with :camera orientation (3D similarity), tie points used for orientation etc...
<pre>
<?xml version="1.0" ?>
<ExportAPERO>
<OrientationConique>
<OrIntImaM2C>
<I00>0 0</I00>
<V10>1 0</V10>
<V01>0 1</V01>
</OrIntImaM2C>
<TypeProj>eProjStenope</TypeProj>
<ZoneUtileInPixel>true</ZoneUtileInPixel>
<FileInterne>Ori-Arbitrary/AutoCal_Foc-16000_Cam-ILCE6000.xml</FileInterne> %Camera model
<RelativeNameFI>true</RelativeNameFI>
<Externe>
<AltiSol>-8.50917595677101524</AltiSol>
<Profondeur>9.9233022137615734</Profondeur>
<Time>-1.00000000000000002e+30</Time>
<KnownConv>eConvApero_DistM2C</KnownConv>
<Centre>0.33581992261091842 -26.3001714173638206 0.000147586637632812767</Centre> %Position of the PPS in arbitrary system
<IncCentre>1 1 1</IncCentre>
<ParamRotation>
<CodageMatr> %Boresight matrix (arbitrary system)
<L1>-0.981263794354502505 -0.155204851492389134 0.11416137684098876</L1>
<L2>-0.192442661386862057 0.818245676864819083 -0.541700871672157969</L2>
<L3>-0.00933744972389951265 -0.553520971929031491 -0.832782892275888531</L3>
</CodageMatr>
</ParamRotation>
</Externe>
...
</pre>
When you use Tapas, a important part of informations are displaying directly in the terminal window, like image resiual or number of tie points used per images. Don't forget to look at this residuals when you use Tapas, for a good orientation you can decrease under 0.5px. All this informations are stocked in a file named "Residual.xml"

===Workflow===
Tapas process internal and relative orientation, you it's placed just after Tapas. The way to visualize relative orientation is to use AperiCloud. 
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]] 
[[Image:Picto-next.png|20px]] Next Command : [[AperiCloud]].

==RadialBasic==
a subset of previous model: radial distortion with limited degrees of freedom ; adapted when there is a risk of divergence of RadialExtended; in this model there are 5 degrees of freedom : 1 for focal length , 2 for principal point and distortion center 3 , 2 for coefficients of radial distortion (r3 and r5 ).

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}''
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}''
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}''
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}''
*[Name=ImInit] string :: {Force first image}''
*[Name=MOI] bool :: {MOI}''

==RadialExtended==
A model with radial distortion.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation} ''
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true)
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}

===Example===
For example with the Mur Saint Martin dataset, you can launch :
<pre>Tapas RadialExtended "IMGP41((6[7-9])|([7-8][0-9])).JPG"</pre>

==Fraser==
a radial model, with decentric and affine parameters there are 12 degrees of freedom: 1 for focal length , 2 for principal point, 2 for distortion center , 3 for coefficients of radial distorsion (r3 , r5 r7 ), 2 for decentric parameters, 2 for affine parameters; the optional parameters LibAff and LibDec (def value true) can be set to false if decentric of affine parameters must stay frozen.

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

Mandatory unnamed args :
*{Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==FraserBasic==
same as previous with for principal point and distortion center constrained to have the same value (so 10 degree of freedom)

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==FishEyeEqui==
a model adapted for diagonal fisheyes equilinear ( with atan physicall model com- pleted with polynomial parameters there are 14 degrees of freedom: 1 for focal length , 2 for principal point, 2 for distorsion center , 5 for coefficients of radial distortion (r3 , r5 r7 ), 2 for decentric parameters, 2 for affine parameters; by default the ray defining the useful mask is 95% of the diagonal.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky pattern ...)}
*[Name=EcMax] REAL :: {Final threshold for residual, def = 5.0 }

==HemiEqui==
same model as previous, but by default the ray defining the useful mask s 52% of the diagonal; adapted to hemispheric equilinear fisheye.

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

Mandatory unnamed args :
*string :: {Calibration model}
*string :: {Full Directory (Dir+Pattern)}

Named args :
*[Name=ExpTxt] INT :: {Export in text format (Def=false)}
*[Name=Out] string :: {Directory of Output Orientation}
*[Name=InCal] string :: {Directory of Input Internal Orientation (Calibration)}
*[Name=InOri] string :: {Directory of Input External Orientation}
*[Name=DoC] INT :: {Do Compensation}
*[Name=ForCalib] INT :: {Is for calibration (Change def value of LMV and prop diag)?}
*[Name=Focs] Pt2dr :: {Keep images with focal length inside range [A,B] (A,B in mm) (Def=keep all)}
*[Name=VitesseInit] INT
*[Name=PPRel] Pt2dr :: {Principal point shift}
*[Name=Decentre] INT :: {Principal point is shifted (Def=false)}
*[Name=PropDiag] REAL :: {Hemi-spherik fisheye diameter to diagonal ratio}
*[Name=SauvAutom] string :: {Save intermediary results to, Set NONE if dont want any}
*[Name=ImInit] string :: {Force first image}
*[Name=MOI] bool :: {MOI}
*[Name=DBF] INT :: {Debug (internal use : DebugPbCondFaisceau=true) }
*[Name=Debug] bool :: {Partial file for debug}
*[Name=DegRadMax] INT :: {Max degree of radial, default model dependent}
*[Name=DegGen] INT :: {Max degree of general polynome, default model dependent (generally 0 or 1)}
*[Name=LibAff] bool :: {Free affine parameter, Def=true}
*[Name=LibDec] bool :: {Free decentric parameter, Def=true}
*[Name=LibPP] bool :: {Free principal point, Def=true}
*[Name=LibCP] bool :: {Free distorsion center, Def=true}
*[Name=LibFoc] bool :: {Free focal, Def=true}
*[Name=RapTxt] string :: {RapTxt}
*[Name=LinkPPaPPs] REAL :: {Link PPa and PPs (double)}
*[Name=FrozenPoses] string :: {List of frozen poses (pattern)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}
*[Name=RefineAll] bool :: {More refinement at all step, safer and more accurate, but slower, def=true}
*[Name=ImMinMax] vector :: {Image min and max (may avoid tricky

SBGlobBascule

2018-07-31T14:21:19Z

Mgaudin : Modifications syntaxe d'appel + Ajout paragraphe : "Scaling a model with only a scale information"

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
SBGlobBascule is a tool for ”scene based global” bascule, it is used when no absolute information is available but the user still wishes to give some physical meaning to the orientation.
*SBGlobBascule use a selected number of images, on which the user has created mask, these mask must define part of the image belonging to the plane.
*SBGlobBascule select the tie points belonging to the mask, and compute by least square fitting an estimation of this plane.
*finally bascule SBGlobBascule compute the rotation that transform current coordinates in a new system where the fitted plane correspond to the plane Z = 0.
*SBGlobBascule fix also the orientation inside the plane.
*optionally SBGlobBascule can fix the the global scale.

===Syntax===
The syntax is
<pre>mm3d SBGlobBascule FullName OrientationIn Images_measures_xml_file OrientationOut NamedArgs </pre>

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

<pre>
Mandatory unnamed args :
* string :: {Full name (Dir+Pat)}
* string :: {Orientation in}
* string :: {Images measures xml file}
* string :: {Out : orientation }
Named args :
* [Name=ExpTxt] bool
* [Name=PostPlan] string :: {Set NONE if no plane}
* [Name=DistFS] REAL :: {Distance between Ech1 and Ech2 to fix scale (if not given no scaling)}
* [Name=Rep] string :: {Target coordinate system (Def = ki, ie normal is vertical)}
* [Name=CPI] bool :: {Calibration Per Image (Def=false)}
</pre>

===Study case: scaling a model with only a scale information===
In the case where you would like to scale a model having only a scale information (like a scale bar for example), you can use <code>SBGlobBascule</code> to generate a new orientation folder with a scale factor applied to the input orientation.

First, you have to generate a xml file containing the position of the points Ech1 and Ech2 (using <code>[[SaisieBasc]]</code> for instance), and then call <code>SBGlobBascule</code> by setting optional arguments <code>PostPlan=NONE</code> and <code>DistFS</code> to the distance between Ech1 and Ech2.

The use of <code>PostPlan=NONE</code> will prevent you from entering a mask defining a plan.

===Example===
With the dataset of street Saint Martin, an example of use is :
<pre>mm3d SBGlobBascule "IMGP41((6[7-9])|([7-8][0-9])).JPG" Mur MesureBasc.xml LocBasc PostPlan=_MasqPlan DistFS=1.2</pre>

The meaning of the arguments are:
* First arg is the pattern defining the image we want to use;
* Second arg (Mur) defines the input orientation;
* Third arg (MesureBasc.xml) is a file that contains image measurement for defining orientation;
* Fourth arg (Basc) defines the output orientation;
* Optional arg PostPlan= MasqPlan means that if image is IMGP4171.JPG (or IMGP4171.CR2 or...), then the associated mask IMGP4171 MasqPlan.tif
* If there are several masks it will use all them for fitting the plane (which can be useful with wide dataset when high accuracy is required); of course if there are no existing mask an error will occur;
* Optional arg DistFS=0.6 is used to fix the scale;

Open the file MesureBasc.xml, you will see that it contains measurement of points in image. Although the syntax should be quite obvious, it is described in section 6.4.4.1. To create a file like MesureBasc.xml user can of course do it with a text editor, alternatively he can, on Linux, use the interactive tool [[SaisieBasc]] described in 8.4.4. Once created, the following information will be looked for by SBGlobBascule in this file :
* Measurement of points named Line1 and Line2; they will fix orientation in the plane by imposing that line Line1-Line2 is parallel to Ox;
* These points need only to be measured in one image, as they are assumed to be in the plane computed on the mask; is they have been measured several time, a warning will occur;
* Optional a point Origine to fix the origin of the repair;
* Optionally two point Ech1 and Ech2 to fix the scale, each point must be entered in at least two images, so that a 3d position can be computed; when DistFS is entered, new coordinate system is computed with the constraint that the distant between the 3d position of Ech1 and Ech2 is equal to DistFS; if DistFS is entered and Ech1 and Ech2 do not exist in at least two images, an error occurs;

C3DC

2018-07-31T13:21:50Z

Mgaudin : Ajout info mode Statue

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
C3DC is used for Automatic Matching from Culture 3D Cloud project. The C3DC command is the command that compute automatically a point cloud from a set of oriented images.

===Syntax===
The global syntax for C3DC is :
<pre>mm3d C3DC EnumeratedValues FullName Orientation NamedArgs</pre>

===Allowed commands===

*<code>Ground</code> : not supported for now
*<code>Statue</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=2, ie. high preset 1pt/4px (with less noise) [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>Forest</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=4, ie. medium preset 1pt/16px
*<code>TestIGN</code> : not supported for now
*<code>QuickMac</code> : multistereoscopic with ZoomF=8, ie. low preset 1pt/64px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MicMac</code> : multistereoscopic with ZoomF=4, ie. medium preset 1pt/16px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>BigMac</code> : multistereoscopic with ZoomF=2 ie. high preset 1pt/4px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MTDTmp</code> : not supported for now

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

<pre>Mandatory unnamed args :
*string :: {Type in enumerated values}
*string :: {Full Name (Dir+Pattern)}
*string :: {Orientation}

Named args :
*[Name=Masq3D] string :: {3D masq for point selection}
*[Name=Out] string :: {final result (Def=C3DC.ply)}
*[Name=SzNorm] INT :: {Sz of param for normal evaluation (<=0 if none, Def=2means 5x5) }
*[Name=PlyCoul] bool :: {Colour in ply ? (Def = true)}
*[Name=Tuning] bool :: {Will disappear one day ...}
*[Name=Purge] bool :: {Purge result, (Def=true)}
*[Name=DownScale] REAL :: {DownScale of Final result, Def depends on mode}
*[Name=ZoomF] INT :: {Zoom final, Def depends on mode}
*[Name=UseGpu] bool :: {Use cuda (Def=false)}
*[Name=DefCor] REAL :: {Def correlation, context depend}
*[Name=ZReg] REAL :: {Regularisation, context depend}
*[Name=ExpTxt] bool :: {Use txt tie points for determining image pairs}
*[Name=FilePair] string :: {Explicit pairs of images (as in Tapioca)}
*[Name=DebugMMByP] bool :: {Debug MMByPair ...}
*[Name=Bin] bool :: {Generate Binary or Ascii (Def=true, Binary)}
*[Name=ExpImSec] bool :: {Export Images Secondair, def=true}
*[Name=OffsetPly] Pt3dr :: {Ply offset to overcome 32 bits problem}</pre>

==QuickMac==
The QuickMac uses the MMInitialModel as matcher, which is quite fast on CPU.

===Example===
For example, in the Mur Saint Martin dataset, you can launch :
<pre>mm3d C3DC MicMac "IMGP.*JPG" MEP-Terrain Masq3D=AperiCloud_MEP-Terrain.ply Out=C3DC_MicMac_MurSaintMartin.ply</pre>

C3DC

2018-07-30T18:03:53Z

Mgaudin : Added information on Ground, TestIGN and MTDTmp

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
C3DC is used for Automatic Matching from Culture 3D Cloud project. The C3DC command is the command that compute automatically a point cloud from a set of oriented images.

===Syntax===
The global syntax for C3DC is :
<pre>mm3d C3DC EnumeratedValues FullName Orientation NamedArgs</pre>

===Allowed commands===

*<code>Ground</code> : not supported for now
*<code>Statue</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=2, ie. high preset with less noise, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>Forest</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=4, ie. medium preset 1pt/16px
*<code>TestIGN</code> : not supported for now
*<code>QuickMac</code> : multistereoscopic with ZoomF=8, ie. low preset 1pt/64px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MicMac</code> : multistereoscopic with ZoomF=4, ie. medium preset 1pt/16px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>BigMac</code> : multistereoscopic with ZoomF=2 ie. high preset 1pt/4px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MTDTmp</code> : not supported for now

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

<pre>Mandatory unnamed args :
*string :: {Type in enumerated values}
*string :: {Full Name (Dir+Pattern)}
*string :: {Orientation}

Named args :
*[Name=Masq3D] string :: {3D masq for point selection}
*[Name=Out] string :: {final result (Def=C3DC.ply)}
*[Name=SzNorm] INT :: {Sz of param for normal evaluation (<=0 if none, Def=2means 5x5) }
*[Name=PlyCoul] bool :: {Colour in ply ? (Def = true)}
*[Name=Tuning] bool :: {Will disappear one day ...}
*[Name=Purge] bool :: {Purge result, (Def=true)}
*[Name=DownScale] REAL :: {DownScale of Final result, Def depends on mode}
*[Name=ZoomF] INT :: {Zoom final, Def depends on mode}
*[Name=UseGpu] bool :: {Use cuda (Def=false)}
*[Name=DefCor] REAL :: {Def correlation, context depend}
*[Name=ZReg] REAL :: {Regularisation, context depend}
*[Name=ExpTxt] bool :: {Use txt tie points for determining image pairs}
*[Name=FilePair] string :: {Explicit pairs of images (as in Tapioca)}
*[Name=DebugMMByP] bool :: {Debug MMByPair ...}
*[Name=Bin] bool :: {Generate Binary or Ascii (Def=true, Binary)}
*[Name=ExpImSec] bool :: {Export Images Secondair, def=true}
*[Name=OffsetPly] Pt3dr :: {Ply offset to overcome 32 bits problem}</pre>

==QuickMac==
The QuickMac uses the MMInitialModel as matcher, which is quite fast on CPU.

===Example===
For example, in the Mur Saint Martin dataset, you can launch :
<pre>mm3d C3DC MicMac "IMGP.*JPG" MEP-Terrain Masq3D=AperiCloud_MEP-Terrain.ply Out=C3DC_MicMac_MurSaintMartin.ply</pre>

C3DC

2018-07-30T17:43:50Z

Mgaudin : Ajout informations sur Forest

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
C3DC is used for Automatic Matching from Culture 3D Cloud project. The C3DC command is the command that compute automatically a point cloud from a set of oriented images.

===Syntax===
The global syntax for C3DC is :
<pre>mm3d C3DC EnumeratedValues FullName Orientation NamedArgs</pre>

===Allowed commands===

*<code>Ground</code>
*<code>Statue</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=2, ie. high preset with less noise, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>Forest</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=4, ie. medium preset 1pt/16px
*<code>TestIGN</code>
*<code>QuickMac</code> : multistereoscopic with ZoomF=8, ie. low preset 1pt/64px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MicMac</code> : multistereoscopic with ZoomF=4, ie. medium preset 1pt/16px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>BigMac</code> : multistereoscopic with ZoomF=2 ie. high preset 1pt/4px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MTDTmp</code>

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

<pre>Mandatory unnamed args :
*string :: {Type in enumerated values}
*string :: {Full Name (Dir+Pattern)}
*string :: {Orientation}

Named args :
*[Name=Masq3D] string :: {3D masq for point selection}
*[Name=Out] string :: {final result (Def=C3DC.ply)}
*[Name=SzNorm] INT :: {Sz of param for normal evaluation (<=0 if none, Def=2means 5x5) }
*[Name=PlyCoul] bool :: {Colour in ply ? (Def = true)}
*[Name=Tuning] bool :: {Will disappear one day ...}
*[Name=Purge] bool :: {Purge result, (Def=true)}
*[Name=DownScale] REAL :: {DownScale of Final result, Def depends on mode}
*[Name=ZoomF] INT :: {Zoom final, Def depends on mode}
*[Name=UseGpu] bool :: {Use cuda (Def=false)}
*[Name=DefCor] REAL :: {Def correlation, context depend}
*[Name=ZReg] REAL :: {Regularisation, context depend}
*[Name=ExpTxt] bool :: {Use txt tie points for determining image pairs}
*[Name=FilePair] string :: {Explicit pairs of images (as in Tapioca)}
*[Name=DebugMMByP] bool :: {Debug MMByPair ...}
*[Name=Bin] bool :: {Generate Binary or Ascii (Def=true, Binary)}
*[Name=ExpImSec] bool :: {Export Images Secondair, def=true}
*[Name=OffsetPly] Pt3dr :: {Ply offset to overcome 32 bits problem}</pre>

==QuickMac==
The QuickMac uses the MMInitialModel as matcher, which is quite fast on CPU.

===Example===
For example, in the Mur Saint Martin dataset, you can launch :
<pre>mm3d C3DC MicMac "IMGP.*JPG" MEP-Terrain Masq3D=AperiCloud_MEP-Terrain.ply Out=C3DC_MicMac_MurSaintMartin.ply</pre>

C3DC

2018-07-30T15:46:44Z

Mgaudin : Modification mise en formes, ajout ZoomF=4 pour Forest + quelques infos (stereoscopic/multistereoscopic) pour Statue et Quick/Mic/BigMac

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
C3DC is used for Automatic Matching from Culture 3D Cloud project. The C3DC command is the command that compute automatically a point cloud from a set of oriented images.

===Syntax===
The global syntax for C3DC is :
<pre>mm3d C3DC EnumeratedValues FullName Orientation NamedArgs</pre>

===Allowed commands===

*<code>Ground</code>
*<code>Statue</code> : stereoscopic (strictly epipolar mode (ie. best stereographic pairs)) with ZoomF=2, ie. high preset with less noise, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>Forest</code> : ZoomF=4, ie. medium preset 1pt/16px
*<code>TestIGN</code>
*<code>QuickMac</code> : multistereoscopic with ZoomF=8, ie. low preset 1pt/64px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MicMac</code> : multistereoscopic with ZoomF=4, ie. medium preset 1pt/16px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>BigMac</code> : multistereoscopic with ZoomF=2 ie. high preset 1pt/4px, [[http://cosch.info/documents/10179/155305/COSCH_TS_APO_MiMac_StepByStep.pdf/d3576e6e-8c1e-4803-85f9-5d4de088e513]]
*<code>MTDTmp</code>

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

<pre>Mandatory unnamed args :
*string :: {Type in enumerated values}
*string :: {Full Name (Dir+Pattern)}
*string :: {Orientation}

Named args :
*[Name=Masq3D] string :: {3D masq for point selection}
*[Name=Out] string :: {final result (Def=C3DC.ply)}
*[Name=SzNorm] INT :: {Sz of param for normal evaluation (<=0 if none, Def=2means 5x5) }
*[Name=PlyCoul] bool :: {Colour in ply ? (Def = true)}
*[Name=Tuning] bool :: {Will disappear one day ...}
*[Name=Purge] bool :: {Purge result, (Def=true)}
*[Name=DownScale] REAL :: {DownScale of Final result, Def depends on mode}
*[Name=ZoomF] INT :: {Zoom final, Def depends on mode}
*[Name=UseGpu] bool :: {Use cuda (Def=false)}
*[Name=DefCor] REAL :: {Def correlation, context depend}
*[Name=ZReg] REAL :: {Regularisation, context depend}
*[Name=ExpTxt] bool :: {Use txt tie points for determining image pairs}
*[Name=FilePair] string :: {Explicit pairs of images (as in Tapioca)}
*[Name=DebugMMByP] bool :: {Debug MMByPair ...}
*[Name=Bin] bool :: {Generate Binary or Ascii (Def=true, Binary)}
*[Name=ExpImSec] bool :: {Export Images Secondair, def=true}
*[Name=OffsetPly] Pt3dr :: {Ply offset to overcome 32 bits problem}</pre>

==QuickMac==
The QuickMac uses the MMInitialModel as matcher, which is quite fast on CPU.

===Example===
For example, in the Mur Saint Martin dataset, you can launch :
<pre>mm3d C3DC MicMac "IMGP.*JPG" MEP-Terrain Masq3D=AperiCloud_MEP-Terrain.ply Out=C3DC_MicMac_MurSaintMartin.ply</pre>

TestRegEx

2018-07-27T14:59:08Z

Mgaudin : Ajout tableau exemple RegEx

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
TestRegEx is a tool that allows you to test a regular expression.

===Regular Expressions===
Regular expressions (RegEx) are a sequence of characters that define a search pattern.

{| class="wikitable"
|+Pattern for regular expressions
!scope=col|RegEx
!scope=col|Description
|-
| <pre>[abc]</pre> || A single character of a, b or c
|-
| <pre>[^abc]</pre> || A character, except a, b or c
|-
| <pre>[a-z]</pre> || A character in the range: a-z
|-
| <pre>[^a-z]</pre> || A character not in the range: a-z
|-
| <pre>[a-zA-Z]</pre> || A character in the range: a-z or A-Z
|-
| <pre>.</pre> || Any single character
|-
| <pre>\s</pre> || Any whitespace character
|-
| <pre>\S</pre> || Any non-whitespace character
|-
| <pre>\d</pre> || Any digit
|-
| <pre>\D</pre> || Any non-digit
|-
| <pre>\w</pre> || Any word character
|-
| <pre>\W</pre> || Any non-word character
|-
| <pre>(...)</pre> || Capture everything enclosed
|-
| <pre>(a|b)</pre> || Match either a or b
|-
| <pre>a?</pre> || Zero or one of a
|-
| <pre>a*</pre> || Zero or more of a
|-
| <pre>a+</pre> || One or more of a
|-
| <pre>a{3}</pre> || Exactly 3 of a
|-
| <pre>a{3,}</pre> || 3 or more of a
|-
| <pre>a{3,6}</pre> || Between 3 and 6 of a
|-
| <pre>^</pre> || Start of string
|-
| <pre>$</pre> || End of string
|-
| <pre>\b</pre> || A word boundary
|-
| <pre>\B</pre> || Non-word boundary
|}

===Syntax===
The global syntax for TestRegEx is:
<pre>mm3d TestRegEx Pattern NamedArgs</pre>

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

<pre>
*****************************
* Help for Elise Arg main *
*****************************
Mandatory unnamed args :
* string :: {Pattern of files}
Named args :
* [Name=DispPat] bool :: {Display Pattern to use in cmd line ; Def=false}
* [Name=ExpList] string :: {Export list image in text file ; Def=false}
</pre>

===Example===
Let the following set of images :
<pre>IMG_4167.JPG
IMG_4168.JPG
IMG_4169.JPG
IMG_4170.JPG
IMG_4171.JPG
IMG_4172.JPG
IMG_4173.JPG
IMG_4174.JPG
IMG_4175.JPG
IMG_4176.JPG
IMG_4177.JPG
IMG_4178.JPG
IMG_4179.JPG
IMG_4180.JPG
</pre>

If you want to select only images IMG_4170.JPG, IMG_4171.JPG and IMG_4172.JPG, you can type: <pre>"IMG_417[0-2].JPG"</pre>

If you want to select all the images, you can type: <pre>".*JPG"</pre>

TestRegEx

2018-07-27T14:24:11Z

Mgaudin : Création de la page : un début...

PIMs2Mnt

2018-07-25T07:43:49Z

Mgaudin : Redirect PIMs2Mnt to PIMs2MNT

#REDIRECT [[PIMs2MNT]]

PIMs2MNT

2018-07-25T07:41:52Z

Mgaudin : Text transfer from PIMs2Mnt

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==

In a prior step, [[PIMs]] computes depth map for each image. PIMs2Mnt merges these individual depth maps in a global digital surface (or elevation) model.
 
Name of this tool comes from "Per Image Matching" (PIM) and the French "Modèle Numérique de Terrain" (MNT) which is generally translated by "Digital Elevation Model" (DEM).

==Syntax==
The basic syntax for PIMs2MNT is:
<pre>mm3d PIMs2Mnt PIMsType NamedArgs</pre>

===Mandatory unnamed arguments===
* string :: {Dir or PIM-Type (QuickMac ...)}

Authorized values are the same the types used with [[PIMs]] (Type in (Ground, Statue, Forest, TestIGN, QuickMac, MicMac, BigMac, MTDTmp). 
The chosen type must have been computed at the prior step with the [[PIMs|this tool]].

===Unmandatory named arguments===
* [Name=DS] REAL :: {Downscale, Def=1.0}
* [Name=ZReg] REAL :: {Regularisation, context depend}
* [Name=Repere] string :: {Repair (Euclid or Cyl)}
* [Name=Pat] string :: {Pattern, def = all existing clouds}
* [Name=DoMnt] bool :: { Compute DTM , def=true (use false to return only ortho)}
* [Name=DoOrtho] bool :: {Generate ortho photo, def=false}
* [Name=MasqImGlob] string :: {Global Masq for ortho: if used, give full name of masq (e.g. MasqGlob.tif) }
* [Name=Debug] bool :: {Debug !!!}
* [Name=UseTA] bool :: {Use TA as filter when exist (Def=false)}
* [Name=RI] REAL :: {Resol Im, def=1 }

===Help===
A basic help can be asked with
<pre> mm3d PIMs2Mnt -help </pre> 

==Workflow==
PIms2MNT is part of the new pipeline of simplified tools for dense patching and orthorectification. 

[[Image:Picto-previous.png|20px]] Previous Command : [[PIMs]] 
[[Image:Picto-next.png|20px]] Next Command : [[Tawny]].

==Example==
* In the Cuxa Auto dataset, you can launch :
<pre>mm3d PIMs2Mnt BigMac DoMnt=1 DoOrtho=1</pre>

* An example included in the [[GrandLeez|GrandLeez tutorial]] :
<pre> mm3d Pims2MNT MicMac DoOrtho=1 </pre>

==GUI==
As for other tools, arguments can be chosen through a GUI using the command:
vPIMs2MNT

==Notes about DEM==

PIMs generates DEMs which can be retrieved in the file :
<pre> ...\PIMs-TmpBasc\PIMs-Merged_Prof.tif </pre>

Generated DEM '''is not recorded''' in the coordinates system, even if it is georeferenced (with a TFW file). Difference stands in a translation and scale factor : by this way, it accommodates better the limitations of floating point precision on very high precision data.

They are stored in a local system which can be transform in the initial one using parameters specified in the file :
<pre>...\PIMs-TmpBasc\PIMs-ZNUM-Merged.xml </pre>

Example of this file:
<pre><?xml version="1.0" ?>
<FileOriMnt>
<NameFileMnt>PIMs-Merged_Prof.tif</NameFileMnt>
<NameFileMasque>PIMs-Merged_Masq.tif</NameFileMasque>
<NombrePixels>6324 8584</NombrePixels>
<OriginePlani>300.94499999999999 939.577</OriginePlani>
<ResolutionPlani>0.00050000000000000001 -0.00050000000000000001</ResolutionPlani>
<OrigineAlti>144.411</OrigineAlti>
<ResolutionAlti>0.00050000000000000001</ResolutionAlti>
<Geometrie>eGeomMNTEuclid</Geometrie>
</FileOriMnt>
</pre>

'' '''FIXME''' which parameters has to be applied? 
''- ResolutionPlani as Z scale factor? ''
''- ResolutionAlti as Z scale factor? ''
''- +OriginePlani for the XY translation? ''
''- +OrigineAlti for the Z translation?'' ''