MicMacRoom Tutorial: 01 Gravillons - Historique des versions

Hubrice : Hubrice a déplacé la page MicMacRoom Tutorial: 01 Gravillions vers MicMacRoom Tutorial: 01 Gravillons

2024-05-03T08:04:28Z

Hubrice a déplacé la page MicMacRoom Tutorial: 01 Gravillions vers MicMacRoom Tutorial: 01 Gravillons

Hubrice le 29 avril 2024 à 14:11

2024-04-29T14:11:08Z

Hubrice le 29 avril 2024 à 14:09

2024-04-29T14:09:45Z

Hubrice le 29 avril 2024 à 14:09

2024-04-29T14:09:22Z

Hubrice le 29 avril 2024 à 07:50

2024-04-29T07:50:33Z

Hubrice le 24 avril 2024 à 14:41

2024-04-24T14:41:26Z

Hubrice le 24 avril 2024 à 14:40

2024-04-24T14:40:21Z

Hubrice : Page créée avec « ==Description== In this tutorial, we will approach general concepts, basics tools, and how to process an image dataset with overlaps with MicMacRoom. This dataset is light... »

2024-04-24T14:17:13Z

Page créée avec « ==Description== In this tutorial, we will approach general concepts, basics tools, and how to process an image dataset with overlaps with MicMacRoom. This dataset is light... »

Nouvelle page

==Description==
In this tutorial, we will approach general concepts, basics tools, and how to process an image dataset with overlaps with MicMacRoom. This dataset is light by design (4 images), in order to focus on the MicMacRoom tools.
This tutorial is designed especially for MicMacRoom beginners with a light photogrammetry background.

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

==Presentation==
This dataset was created by L.Girod at the University of Oslo, Norway. This dataset was acquired to model a volcano model created by O.Galland.
Files present in the directory are:
*4 images : 1.JPG, 2.JPG, 3.JPG, 4.JPG.
[[Image:01_gravillons_caroussel.png]]
*GCP coordinates: Dico-Appuis.xml.
*Measures of GCPs in images: Mesure-Appuis.xml.
*1 Mask: 1_Masq.tif/1_Masq.xml
*2 command scripts: gravillons.sh (Linux) and gravillons.bat (Windows)

==Tutorial==

===0 Project Creation===
The usage of MicMacRoom requires a few steps to create your project. First, select all nodes (in the Graph Editor) and delete them. Then, save your project.
The first real step is to set up two nodes (to create a node, right click on the Graph Editor space and search for the node):
#The CameraInit node
#The MicMacProject node

You don't need to change any parameter on these, you just need to link the SfMData Output of CameraInit to the SfMData Input of MicMacProject.
This step allows Meshroom and MicMac to work together properly, they are needed in all project where you wish to use the MicMac commands in Meshroom.
You can then import all your images.

===1 Tie-Points search===
The second step is to look for tie points (points that are seen in more than one image), this step is called image matching and performed by the command [[Tapioca]], however, you will see that there are multiple Tapiocas available in MicMacRoom, this is to differentiate beetween certain important options that changes the inputs and outputs of the command.
In this case, we will use TapiocaAll (The All option is used here because we know that all the images are going to have tie points with each other (they all depict the same area)).
In this node, set the ImageSize to 1500 (ot to -1 if you want to process the tie-points at full resolution).
Then, connect ProjectDirectory from MicMacProject to the TapiocaAll node. This is something that you will need to do a lot, as all ProjectDirectory will be linked between all nodes. This is important as it tells MicMacRoom the position of the input and ouput files.

===2 Internal Orientation+Relative Orientation===
Photogrammetry is composed of three steps :
*Internal Orientation : to determine camera parameters (focal length, PPA, PPS, distortion center, or distortion parameters).
*Relative Orientation : to determine the relative position of each camera in an arbitrary coordinate system.
*Absolute Orientation : to map the relative orientations to a scaled and oriented coordinate system (typically WGS84)
In digital photogrammetry, the two first steps are generally processed at the same time. In MicMac, the tools which perform internal and relative orientation is called [[Tapas]], in MicMacRoom, the node is also called Tapas, you can add it after the TapiocaAll node and link ProjectDirectory, ImagePattern, and HomolDirectory

Then in the Tapas node, put the Calibration Model to FraserBasic
This tool uses a compensation by least squares to determine camera parameters and relative orientations. The option "FraserBasic", correspond to a model of distortion for our camera.

===3 Visualize Relative Orientation===
MicMacRoom include a tools which create a sparse point clouds (TPs) for visualization. This tool is based on the MicMac command [[AperiCloud]] and is also named AperiCloud.
To use it, add an ApriCloud node and link ProjectDirectory, Image Pattern, Homol Directory, and OrientationDirectory with the Tapas node.
At this point, you can start the process if you wish to see the Point Cloud. To find this file, go to the place where you saved your project then Meshroom Cache -> MicMacProject -> Then only folder that should be here is one with a long string as a name -> project and in there you should find all the inputs, intermediary, and output files, including the AperiCloud.ply file which can be viewed in Softwares such as CloudCompare or Meshlab (see [[Install|Useful softwares for MicMac]]).

===4 Absolute Orientation===
For this datasets, Ground Control Points, are already measured in images (file "Mesure-Appuis.xml"). With 3 points (X,Y,Z) we can determine the 3D transformation between the arbitrary system (Relative Orientation) and the georeferenced system, this operation is call "Bascule" and can be performed with the [[GCPBascule]] MicMac commmand, and with the GCPBascule node as well.
To do this: add a GCPBascule node after the AperiCloud

@@ Ligne 80 : / Ligne 80 : @@
 Now you just need to press start!
-This is the expected Pipeline after following this tutorial:
+This is the expected Pipeline after following this tutorial (Whithout the green lines under the names of the nodes as this indicates that the pipeline has been executed):
 [[Image:Gravillions.png|center|thumb|1000px]]

@@ Ligne 81 : / Ligne 81 : @@
 This is the expected Pipeline after following this tutorial:
-[[Image:Gravillions.PNG|center|thumb|1000px]]
+[[Image:Gravillions.png|center|thumb|1000px]]
 ===Result===

@@ Ligne 79 : / Ligne 79 : @@
 Add a C3DC node. Link Project Directory, Image Pattern, Homol Directory, and Orientation Directory from AperiCloud2.
 Now you just need to press start!
 ===Result===

← Version précédente		Version du 29 avril 2024 à 07:50
Ligne 1 :		Ligne 1 :
		+	[[Image:picto-liste.png\|25px\|link=Tutorials]] [[MicMacRoom Tutorials\|Tutorials index]]
	==Description==		==Description==
	In this tutorial, we will approach general concepts, basics tools, and how to process an image dataset with overlaps with MicMacRoom. This dataset is light by design (4 images), in order to focus on the MicMacRoom tools.		In this tutorial, we will approach general concepts, basics tools, and how to process an image dataset with overlaps with MicMacRoom. This dataset is light by design (4 images), in order to focus on the MicMacRoom tools.

@@ Ligne 19 : / Ligne 19 : @@
 ==Tutorial==
-===0 Project Creation===
+===Project Creation===
 The usage of MicMacRoom requires a few steps to create your project. First, select all nodes (in the Graph Editor) and delete them. Then, save your project.
 The first real step is to set up two nodes (to create a node, right click on the Graph Editor space and search for the node):
@@ Ligne 29 : / Ligne 29 : @@
 You can then import all your images.
-===1 Tie-Points search===
+===Tie-Points search===
 The second step is to look for tie points (points that are seen in more than one image), this step is called image matching and performed by the command [[Tapioca]], however, you will see that there are  multiple Tapiocas available in MicMacRoom, this is to differentiate beetween certain important options that changes the inputs and outputs of the command.
 In this case, we will use TapiocaAll (The All option is used here because we know that all the images are going to have tie points with each other (they all depict the same area)).
@@ Ligne 35 : / Ligne 35 : @@
 Then, connect ProjectDirectory from MicMacProject to the TapiocaAll node. This is something that you will need to do a lot, as all ProjectDirectory will be linked between all nodes. This is important as it tells MicMacRoom the position of the input and ouput files.
-===2 Internal Orientation+Relative Orientation===
+===Internal Orientation+Relative Orientation===
 Photogrammetry is composed of three steps :
 *Internal Orientation : to determine camera parameters (focal length, PPA, PPS, distortion center, or distortion parameters).
@@ Ligne 45 : / Ligne 45 : @@
 This tool uses a compensation by least squares to determine camera parameters and relative orientations. The option "FraserBasic", correspond to a model of distortion for our camera.
-===3 Visualize Relative Orientation===
+===Visualize Relative Orientation===
 MicMacRoom include a tools which create a sparse point clouds (TPs) for visualization. This tool is based on the MicMac command [[AperiCloud]] and is also named AperiCloud.
 To use it, add an ApriCloud node and link ProjectDirectory, Image Pattern, Homol Directory, and OrientationDirectory with the Tapas node.
 At this point, you can start the process if you wish to see the Point Cloud. To find this file, go to the place where you saved your project then Meshroom Cache -> MicMacProject -> Then only folder that should be here is one with a long string as a name -> project and in there you should find all the inputs, intermediary, and output files, including the AperiCloud.ply file which can be viewed in Softwares such as CloudCompare or Meshlab (see [[Install|Useful softwares for MicMac]]).
-===4 Absolute Orientation===
+===Absolute Orientation===
-==== 4.1 GCPBascule ====
+====GCPBascule ====
 For this datasets, Ground Control Points, are already measured in images (file "Mesure-Appuis.xml"). With 3 points (X,Y,Z) we can determine the 3D transformation between the arbitrary system (Relative Orientation) and the georeferenced system, this operation is call "Bascule" and can be performed with the [[GCPBascule]] MicMac commmand, and with the GCPBascule node as well.
 To do this: add a GCPBascule node after the AperiCloud. Link the Project Directory and Image Pattern from AperiCloud. Also, link the Orientation Directory from AperiCloud to the Input Orientation of GCPBascule.
@@ Ligne 61 : / Ligne 61 : @@
 Then, in the GCPBascule node, put Dico-Appuis.xml in GCP 3D Coordinate File and Mesure-Appuis.xml in GCP Image coordinates File.
-====4.2 Campari====
+====Campari====
 This tool process a first Bascule only with the GCPs (Directory Ori-Ground_Init), we will now calculate a second Bascule with GCPs and TPs. To do that, we use the equivalent of the MicMac command [[Campari]], which is the Campari node.
 Add a Campari node, link Project Directory and Image Pattern from GCPBascule. Also, link Output Orientation from GCPBascule to Orientation Directory. The last step is to link Homol Directory from """AperiCloud""" to Homol Directory.
-====4.3 AperiCloud2====
+====AperiCloud2====
 We can visualize the new orientation calculated with Campari with AperiCloud.
@@ Ligne 73 : / Ligne 73 : @@
 On this AperiCloud node, go to the bottom of the settings and change the name of PointCloud to something like AperiCloud2.ply, this will make it so the result of the two AperiCloud do not Override each other.
-===5 Dense Point Cloud===
+===Dense Point Cloud===
 The last step is to densify the PointCloud, to do that, we will use the C3DC node that is the equivalent of the [[C3DC]] MicMac command.

← Version précédente	Version du 3 mai 2024 à 08:04
(Aucune différence)