Voir la source de Zhenjue tutorial

[[Image:picto-liste.png|25px|link=Tutorials]] [[Tutorials|Tutorials index]]

==Description==
This dataset contain images with different focal length (24 and 100 mm).
The purpose of this tutorial is to reconstruct each statue independently (warrior and musician).
We will show two methods to reconstruct object in 3D by image geometry (Malt and PIMs).

==Download==
You can find this dataset at <code>http://micmac.ensg.eu/data/zhenjue_dataset.zip</code> <br>
Once you have downloaded it, you have to unzip the ".zip" archive.

==Tutorial==
===1. Relative orientation===
As all MicMac process, the pipeline begin by calling the tool [[Tapioca]] to detect tie points :
<pre>mm3d Tapioca All  ".*JPG" 1500</pre>
For this dataset, image have different focal length, so we have to compute first a orientation for the 24mm focal length images.
<pre>mm3d Tapas RadialStd ".*JPG" Focs=[20,30] Out=F24</pre>
Check residual and number of points used per images.<br>
We use the 24mm orientation as an entry for our command in order to indicate to MicMac there is different focal length :
<pre>mm3d Tapas RadialStd ".*JPG" InOri=F24 Out=All</pre>
We will now generate a sparse cloud to visualize the relative orientation.
<pre>mm3d AperiCloud ".*JPG" All</pre>

===2. Dense correlation in image geometry (old method)===
For this part and the rest of this tutorial, we will focus only on the warrior.
Define a mask for dense correlation can be done with the command [[SaisieMasqQT]]. Here we define a image mask :
<pre>mm3d SaisieMasqQT "DSC_3128.JPG"</pre>
The previous tool for dense correlation was [[Malt]]. Here we are working in image geometry.
<pre>mm3d Malt GeomImage "DSC_313[2-9].JPG" All Master=DSC_3135.JPG ZoomF=4 AffineLast=0</pre>
We can compute a dense cloud with the command [[Nuage2Ply]] :
<pre>mm3d Nuage2Ply NuageImProf_STD-MALT_Etape_6.xml Attr=../DSC_3135.JPG RatioAttrCarte=4 Out=../Warrior.ply</pre>

===3. Dense correlation in image geometry (new method)===
Define a mask for dense correlation can be done with the command [[SaisieMasqQT]]. Here we define a 3D mask :
<pre>mm3d SaisieMasqQT "DSC_3128.JPG"</pre>
The new tool [[C3DC]] doesn't need a image master for 3D reconstruction :
<pre>mm3d C3DC BigMac "DSC_313[2-9].JPG" All ZoomF=4</pre>

===4. Comparison===
[[Image:ply_warrior.png|thumb|180px|Sparse cloud]]
So let's compare the files "Warrior_Malt.ply" and "C3DC-BigMac.ply".

===5. Compute a depth map===
[[Image:GrShade_warrior.png|thumb|180px|GrShade]]
To visualize the depth map, we have to use the tool [[GrShade]] to the most elevate resolution map (Z_Num6... here) :
<pre>
cd MM-Malt-Img-DSC_3135
mm3d GrShade Z_Num6_DeZoom4_STD-MALT.tif ModeOmbre=IgnE Mask=AutoMask_STD-MALT_Num_5.tif FZ=2 Out=../ShadeWarrior.tif
</pre>

<div class="toccolours mw-collapsible mw-collapsed" style="background-color: Lavender">
<h6 style="font-family: Helvetica:font-size: 40px">Go further</h6>
<div class="mw-collapsible-content">If you want to perform the musician then use :
<pre>
mm3d SaisieMasqQT DSC_3128.JPG
mm3d Malt GeomImage "DSC_31((2[5-9])|(3[0-1])).JPG" Toutes Master=DSC_3128.JPG ZoomF=4
cd MM-Malt-Img-DSC_3128
mm3d GrShade Z_Num6_DeZoom4_STD-MALT.tif ModeOmbre=IgnE Mask=AutoMask_STD-MALT_Num_5.tif FZ=2 Out=../ShadeMusician.tif
mm3d Nuage2Ply NuageImProf_STD-MALT_Etape_6.xml Attr=../DSC_3128.JPG RatioAttrCarte=4 Out=../Musician.ply
</pre>
</div>
</div>

==Conclusion==
Unfortunately, the tools [[C3DC]] and PIMs don't have a radiometric egalisation module. So for instance, if you want to use it in orthophotos or dense cloud, you can still use the old pipeline ([[Malt]],[[Nuage2Ply]],[[Tawny]] etc...)