MicMac - Contributions de l’utilisateur [fr]

AperiCloud

2018-05-22T09:21:11Z

Bbvanderhorst : /* AperiCloud doesn't support 64 bits ply */

[[Image:picto-liste.png|25px]] [[Command|List of commands]]
==Description==
AperiCloud is used for generating a visualization of and sparse 3D model and cameras position, computed by [[Tapas]] for example.

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

===Results===
AperiCloud, generate a sparse 3D cloud (".ply") with the position and orientation of each camera. If you don't use "Out" option, the file will be stored in your working directory at the name : <i>AperiCloud-Ori_Name.ply</i>. You can use MeshLab to visualize the file.<br>
[[Image:01_Gravillonn_AO.jpg|x200px]]
[[Image:Pierrerue2.png|x200px]]
[[Image:Exercice_Fontaine1.png|x200px]]

===Workflow===
AperiCloud is a tool dedicated to visualization of orientations. So you can use it every times you process a orientation. When you have processed the final orientation, you can define a 3D mask with the ".ply" file generated by AperiCloud (SaisieMasqQT).<br>
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapas]],[[GCPBascule]],[[Campari]]<br>
[[Image:Picto-next.png|20px]] Next Command : [[SaisieMasqQT]].<br>


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

Mandatory unnamed args :
*string :: {Full name (Dir+Pattern)}
*string :: {Orientation directory}
Named args :
*[Name=ExpTxt] INT :: {Point in txt format ? (Def=false)}
*[Name=Out] string :: {Result (Def=AperiCloud.ply)}
*[Name=Bin] INT :: {Ply in binary mode (Def=true)}
*[Name=RGB] INT :: {Use RGB image to texturate points (Def=true)}
*[Name=SeuilEc] REAL :: {Max residual (Def=10)}
*[Name=LimBsH] REAL :: {Limit ratio base to height (Def=1e-2)}
*[Name=WithPoints] bool :: {Do we add point cloud? (Def=true) }
*[Name=CalPerIm] bool :: {If a calibration per image was used (Def=false)}
*[Name=Focs] Pt2dr :: {Interval of Focal}
*[Name=WithCam] bool :: {With Camera (Def=true)}
*[Name=ColCadre] Pt3di :: {Col of camera rect Def= 255 0 0 (Red)}
*[Name=ColRay] Pt3di :: {Col of camera rect Def= 0 255 0 (Green)}
*[Name=SH] string :: {Set of Hom, Def="", give MasqFiltered for result of HomolFilterMasq}

===Example===

In example, you can launch this command in the Mur Saint Martin dataset :
<pre>mm3d AperiCloud «.*JPG » Out=MEP </pre>

== Known limitations ==
=== AperiCloud doesn't support 64 bits ply ===
Use of AperiCloud with coordinates with many digits generates models which seeems sliced, or very sparse, because this tool doesn't support 64 bits ply models.

Due to this limitations, it is recommended to use local or truncated coordinate. Or not to use AperiCloud after georeferencement in a projected coordinates system.
Look to [http://forum-micmac.forumprod.com/point-cloud-seems-sliced-and-very-sparse-after-coord-chgt-t1270.html this thread] for an example and further information.

For precision and accuracy reasons, it is anyways always recommended to work in a local system at least until just before the correlation step (after Campari), and use [[ChgSysCo]] to then get to the projected coordinate system.

Schnaps

2018-05-17T07:32:12Z

Bbvanderhorst : /* Help */

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

Schnaps is a global order-agnostic tie point reduction tool.

This command is used to clean and reduce tie points before any orientation, and without needing any order in the pictures. Its limitation is the user memory: it can't be used if computer RAM is lower than Homol directory size.

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

===Workflow===
AperiCloud is a tool dedicated to tie point reduction. So you have to use it after tie points computation by Tapioca and before orientation computation by Tapas (or Martini). It could also be used after a first tiepoint reduction using mask(s) with HomolFilterMasq<br>
[[Image:Picto-previous.png|20px]] Previous Command : [[Tapioca]],[[HomolFilterMasq]]<br>
[[Image:Picto-next.png|20px]] Next Command : [[Tapas]],[[Martini]].<br>


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

Mandatory unnamed args :
* string :: {Pattern of images}
Named args :
* [Name=HomolIn] string :: {Input Homol directory suffix (without "Homol")}
* [Name=NbWin] INT :: {Minimal homol points in each picture (default: 1000)}
* [Name=ExeWrite] bool :: {Execute write output homol dir, def=true}
* [Name=HomolOut] string :: {Output Homol directory suffix (default: _mini)}
* [Name=ExpTxt] bool :: {Ascii format for in and out, def=false}
* [Name=VeryStrict] bool :: {Be very strict with homols (remove any suspect), def=false}
* [Name=ShowStats] bool :: {Show Homol points stats before and after filtering, def=false}
* [Name=DoNotFilter] bool :: {Write homol after recomposition, without filterning, def=false}
* [Name=PoubelleName] string :: {Where to write suspicious pictures names, def="Schnaps_poubelle.txt"}
* [Name=minPercentCoverage] REAL :: {Minimum % of coverage to avoid adding to poubelle, def=30}
* [Name=MoveBadImgs] bool :: {Move bad images to a trash folder called Poubelle, Def=false}
* [Name=OutTrash] string :: {Output name of trash folder if moving bad images, Def=Poubelle}
* [Name=MiniMulti] INT :: {Minimal Multiplicity of selected points, Def=1}
* [Name=NetworkExport] bool :: {Export Network (in js), Def=false}

==Examples==

===Basic Example===
You can launch this command on most dataset with :
<pre>mm3d Schnaps «.*JPG »</pre>

By default Schnaps uses the \Homol" directory and creates a "\Homol_mini" directory for output, which will have to be specified in following commands, generally with SH argument. For example, with Tapas:
<pre>mm3d Tapas RadialExtended ".*JPG" SH=_mini</pre>

===After HomolFilterMasq===
Here, you have to specify the good homol directory. If you used default settings, it should be:
<pre>mm3d Schnaps ".*JPG" HomolIn=MasqFiltered</pre>

==Known limitations==
===ShowStats=True===
This option get the computation process <u>very very </u> slow. Don't use if you don't need it.

C3DC

2018-04-19T11:13:01Z

Bbvanderhorst : /* Allowed commands */

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

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

===Help===
You can access to the help by typing :
<pre>mm3d C3DC -help</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 ...}

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