Tapioca - Historique des versions

Harlock : Correction commande mm3d SEL

2021-12-13T03:22:51Z

Correction commande mm3d SEL

Harlock : Correction of Tapioca Line example : the arguments' order has been inverted.

2020-02-17T05:07:52Z

Correction of Tapioca Line example : the arguments' order has been inverted.

APerret : /* Allowed commands */

2018-10-03T12:15:43Z

‎Allowed commands

XavierR : /* Workflow */

2016-11-15T09:25:14Z

‎Workflow

XavierR : /* Workflow */

2016-11-15T09:22:13Z

‎Workflow

XavierR : Réorganisation

2016-11-14T14:02:16Z

Réorganisation

BorisLeroux le 13 novembre 2016 à 18:20

2016-11-13T18:20:06Z

BorisLeroux : /* Tie points on low contrast Images */

2016-11-13T18:19:24Z

‎Tie points on low contrast Images

BorisLeroux le 13 novembre 2016 à 18:18

2016-11-13T18:18:32Z

BorisLeroux : /* Help */

2016-06-02T10:26:52Z

‎Help

@@ Ligne 27 : / Ligne 27 : @@
 NB : This tool works only for Linux OS.<br>
 If you want to visualize tie points matched by Tapioca, you can run the command [[SEL]]:
-<pre>mm3d SEL image_1 image_2 KH=NB</pre>
+<pre>mm3d SEL ./ image_1 image_2 KH=NB</pre>
 [[Image:tapioca_exemple_sift.png|x200px]]

@@ Ligne 121 : / Ligne 121 : @@
 ====Example====
 For example with the Ramses dataset, you can launch :
-<pre> mm3d Tapioca Line "IMG.*CR2" 3 1000</pre>
+<pre> mm3d Tapioca Line "IMG.*CR2" 1000 3</pre>
 ===Graph===

@@ Ligne 11 : / Ligne 11 : @@
 *<b>All</b> : Compute tie points for all images in a given resolution.
 *<b>Line</b> : Compute tie points for linear image canvas.
-*<b>File</b> :
+*<b>File</b> : Compute tie points for images in a xml file
-*<b>Graph</b> :
+*<b>Graph</b> : in development
 ===Results===

@@ Ligne 22 : / Ligne 22 : @@
 Tapioca, is generally the first command to launch in a MicMac process.<br>
 [[Image:Picto-previous.png|20px]] Previous Command : ~<br>
-[[Image:Picto-next.png|20px]] Next Command : [[HomolFilterMasq]], [[Tapas]].
+[[Image:Picto-next.png|20px]] Next Command : ([[HomolFilterMasq]],[[Schnaps]],) [[Tapas]].
 ===Visualize tie points===

@@ Ligne 22 : / Ligne 22 : @@
 Tapioca, is generally the first command to launch in a MicMac process.<br>
 [[Image:Picto-previous.png|20px]] Previous Command : ~<br>
-[[Image:Picto-next.png|20px]] Next Command : [[Tapas]].
+[[Image:Picto-next.png|20px]] Next Command : [[HomolFilterMasq]], [[Tapas]].
 ===Visualize tie points===

@@ Ligne 30 : / Ligne 30 : @@
 [[Image:tapioca_exemple_sift.png|x200px]]
-==MulScale==
+==Tie points computation mode==
-The mode MulScale can save significant computation time on large sets of images. Even if it is not optimal for all canvas, it has the benefit of being general and usable with any data set. In this mode, a first computation of tie points is made for all the pairs of images at a low resolution (so it is quite fast), chosen by the user through the ''Size of Low Resolution Images'' option. Then the computation is done at the ''Size of High Resolution Images'' only for the pairs having, at low resolution, a number of tie points exceeding a given threshold (''NbMinPt'').
+===All===
-===Help===
+====Help====
 You can access to the help by typing :
-<pre>mm3d Tapioca MulScale -help</pre>
+<pre>mm3d Tapioca All -help</pre>
 Mandatory unnamed args :
 *string :: {Full Name (Dir+Pat)}
-*INT :: {Size of Low Resolution Images}
+*INT :: {Size of image, in pixels}
-*INT :: {Size of High Resolution Images}
 Named args :
 *[Name=ExpTxt] INT :: {Export files in text format (Def=false means binary)}
 *[Name=PostFix] string :: {Add postfix in directory}
-*[Name=NbMinPt] INT :: {Minimum number of points}
+*[Name=ByP] INT :: {By process}
-*[Name=DLR] INT :: {Do Low Resolution}
 *[Name=Pat2] string :: {Second pattern}
 *[Name=Detect] string
@@ Ligne 55 : / Ligne 53 : @@
 *[Name=NoUnknown] bool
-===Example===
+Using '''-1''' as Image's size is equivalent to use full resolution image. But it's recommended to use rather a resolution to a scaling between 0.3 and 0.5.
-For example with the Buddha dataset, you can launch :
-<pre>mm3d Tapioca MulScale "IMG_[0-9]{4}.tif" 300 -1</pre>
-For example with the Cuxa dataset, you can launch :
-<pre>mm3d Tapioca MulScale "Abbey-IMG_.*.jpg" 200 800</pre>
-==All==
+====Example====
-Tie points are looked for in all possible pair of images at the reduced resolution chosen by the user in the ''Size of image'' option.
+For example with the Ramses dataset, you can launch : <br>
-===Help===
+For example with the Zhenjue dataset, you can launch : <br>
 You can access to the help by typing :
-<pre>mm3d Tapioca All -help</pre>
+<pre>mm3d Tapioca MulScale -help</pre>
 Mandatory unnamed args :
 *string :: {Full Name (Dir+Pat)}
-*INT :: {Size of image}
+*INT :: {Size of Low Resolution Images}
 Named args :
 *[Name=ExpTxt] INT :: {Export files in text format (Def=false means binary)}
 *[Name=ByP] INT :: {By process}
 *[Name=Pat2] string :: {Second pattern}
 *[Name=Detect] string
@@ Ligne 83 : / Ligne 87 : @@
 *[Name=NoUnknown] bool
-===Example===
+====Example====
-For example with the Ramses dataset, you can launch : <br>
+For example with the Buddha dataset, you can launch :
-<pre>mm3d Tapioca All "IMG.*CR2" 1000</pre>
+<pre>mm3d Tapioca MulScale "IMG_[0-9]{4}.tif" 300 -1</pre>
-==Line==
+===Line===
 It often occurs that the photos canvas has a linear structure, for example, when you acquire photos of a facade walking along the street. In this case, you know that the <math>Kth</math> image can only have tie points with images in the interval [K - δ, K + δ] giving this information to Tapioca can save a lot of time. The argument ''Number of adjacent images to look for'' sets δ. The ''Circ'' option is used if the acquisition is circular (the first and last image see each other). All the other arguments have the same meaning as in the ''All'' mode.
-===Help===
+====Help====
 You can access to the help by typing :
 <pre>mm3d Tapioca Line -help</pre>
@@ Ligne 115 : / Ligne 119 : @@
 *[Name=NoUnknown] bool
-===Example===
+====Example====
 For example with the Ramses dataset, you can launch :
 <pre> mm3d Tapioca Line "IMG.*CR2" 3 1000</pre>
-==Graph==
+===Graph===
-===Help===
+====Help====
 You can access to the help by typing :<br>
 <pre>mm3d Tapioca Graph -help</pre>
@@ Ligne 139 : / Ligne 143 : @@
 *[Name=PrintGraph] bool :: {print result graph in standard output}
-==File==
+===File===
 A file specifying a set of images to be matched is needed here. Such a file can either be generated manually or be produced with [[OriConvert]] when the images come with GPS information, the images to be matched together being within a given distance threshold of each others.
-===Help===
+====Help====
 You can access to the help by typing :<br>
 <pre>mm3d Tapioca File -help</pre>
@@ Ligne 160 : / Ligne 164 : @@
 *[Name=NoUnknown] bool
-===Example===
+====Example====
 In the tutorial [[GrandLeez]], we use the option File for [[Tapioca]].
 The file <i>FileImagesNeighbour.xml</i> contain for each images, his differents neighboors. If you open the file, you can see :
@@ Ligne 181 : / Ligne 185 : @@
 =What Tie Points is?=
-=Tie points on low contrast Images=
+==Tie points on low contrast Images==
-The current implementation of SIFT++ used in MicMac is not fully invariant to scaling/translation in radiom-
+The current implementation of SIFT++ used in MicMac is not fully invariant to scaling/translation in radiometry. This may be a problem in case of acquisitions having a good SNR but with low contrast in the scene; in this case, thanks to good SNR there is potential information to get tie points, but as this information is assimilated to noise, it cannnot be extracted. To overcome this problem, it is possible to require that MicMac computes some contrast enhancement on images before computing SIFT points.
-etry. This may be a problem in case of acquisitions having a good SNR but with low contrast in the scene; in this
 case, thanks to good SNR there is potential information to get tie points, but as this information is assimilated
 to noise, it cannnot be extracted. To overcome this problem, it is possible to require that MicMac computes some contrast enhancement on
 images before computing SIFT points.

@@ Ligne 178 : / Ligne 178 : @@
 It means, image <i>R0040439.JPG</i> is connected with all the images detailed in <Cple> tag. So you can run the tie point generation with [[Tapioca]] using this file :
 <pre>mm3d Tapioca File FileImagesNeighbour.xml -1</pre>
 =Tie points on low contrast Images=

← Version précédente		Version du 13 novembre 2016 à 18:19
Ligne 180 :		Ligne 180 :

	=Tie points on low contrast Images=		=Tie points on low contrast Images=
		+	The current implementation of SIFT++ used in MicMac is not fully invariant to scaling/translation in radiom-
		+	etry. This may be a problem in case of acquisitions having a good SNR but with low contrast in the scene; in this
		+	case, thanks to good SNR there is potential information to get tie points, but as this information is assimilated
		+	to noise, it cannnot be extracted. To overcome this problem, it is possible to require that MicMac computes some contrast enhancement on
		+	images before computing SIFT points.

← Version précédente		Version du 13 novembre 2016 à 18:18
Ligne 178 :		Ligne 178 :
	It means, image <i>R0040439.JPG</i> is connected with all the images detailed in <Cple> tag. So you can run the tie point generation with [[Tapioca]] using this file :		It means, image <i>R0040439.JPG</i> is connected with all the images detailed in <Cple> tag. So you can run the tie point generation with [[Tapioca]] using this file :
	<pre>mm3d Tapioca File FileImagesNeighbour.xml -1</pre>		<pre>mm3d Tapioca File FileImagesNeighbour.xml -1</pre>
		+
		+	=Tie points on low contrast Images=