SaisieAppuisInitQT : Différence entre versions

De MicMac
Aller à : navigation, rechercher
(XML file for image measurements)
 
(28 révisions intermédiaires par 4 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 +
[[Image:picto-liste.png|25px]] [[Command|List of commands]]
 
==Description==
 
==Description==
It runs with the same arguments as SaisieAppuisInit.
+
It runs with the same arguments as [[SaisieAppuisInit]].
 +
SaisieAppuisInitQT displays two lists on the right side: the points list, and the images list. Points list can be clicked to choose which point to measure. You can also remove a point by clicking it in the list and press Suppr. You can also right-click and choose between following actions:
 +
*Change images for selected point
 +
*Delete selected points (multiple selection allowed)
 +
*Validate selected points (idem)
  
SaisieAppuisInitQT displays two lists on the right side: the points list, and the images list. Points
+
The image lists show all available images. When a point has been measured in at least two images, the image list is displayed. Images currently displayed in the windows are highlighted in blue. The image where the cursor is moving is displayed in light orange. You can right-click and select View images to load corresponding images. A 3D window shows the images location, and the point measured. By default point are displayed in red ; when a point is selected, it is displayed in blue. You can drag-and-drop a ply file in this window (such as [[AperiCloud]].ply) to check if GCP are good.
list can be clicked to choose which point to measure. You can also remove a point by clicking it in the
+
list and press Suppr. You can also right-click and choose between following actions:
+
— Change images for selected point
+
— Delete selected points (multiple selection allowed)
+
— Validate selected points (idem)
+
The image lists show all available images. When a point has been measured in at least two images, the
+
image list is displayed. Images currently displayed in the windows are highlighted in blue. The image
+
where the cursor is moving is displayed in light orange. You can right-click and select View images to
+
load corresponding images. A 3D window shows the images location, and the point measured. By default
+
point are displayed in red ; when a point is selected, it is displayed in blue. You can drag-and-drop a ply
+
file in this window (such as AperiCloud.ply) to check if GCP are good.
+
<br>
+
  
 
===Syntax===
 
===Syntax===
The global syntax for SaisieAppuisInitQT is <br>
+
The global syntax for SaisieAppuisInitQT is :
<code>mm3d SaisieAppuisInitQT + arguments</code>
+
<pre>mm3d SaisieAppuisInitQT FullName Orientation PointName FileForImageMeasurements NamedArgs </pre>
  
 
===Help===  
 
===Help===  
You can access to the help by typing :<br>
+
You can access to the help by typing :
<br>
+
<pre>mm3d SaisieAppuisInitQT -help</pre>
<code>mm3d SaisieAppuisInitQT -help</code> <br>
+
<br>
+
 
Mandatory unnamed args :
 
Mandatory unnamed args :
*<span style="font-family:times roman;"> ''string :: {Full name (Dir+Pattern)}''</span style>''</span style>
+
*string :: {Full name (Dir+Pattern)}
*<span style="font-family:times roman;"> ''string :: {Orientation ; NONE if not used}''</span style>''</span style>
+
*string :: {Orientation ; NONE if not used}
*<span style="font-family:times roman;"> ''string :: {Point name, or point file name}''</span style>''</span style>
+
*string :: {Point name, or point file name}
*<span style="font-family:times roman;"> ''string :: {Output}''</span style>''</span style>
+
*string :: {File for image measurement}
  
 
Named args :
 
Named args :
*<span style="font-family:times roman;"> ''[Name=SzW] Pt2di :: {Sz of window}''</span style>''</span style>
+
*[Name=SzW] Pt2di :: {Sz of window}
*<span style="font-family:times roman;"> ''[Name=NbF] Pt2di :: {Nb of sub window}''</span style>''</span style>
+
*[Name=NbF] Pt2di :: {Nb of sub window}
*<span style="font-family:times roman;"> ''[Name=NameAuto] string :: {Prefix for automatic point creation}''</span style>''</span style>
+
*[Name=NameAuto] string :: {Prefix for automatic point creation}
*<span style="font-family:times roman;"> ''[Name=ForceGray] bool :: {Force gray image, def=false}''</span style>''</span style>
+
*[Name=ForceGray] bool :: {Force gray image, def=false}
*<span style="font-family:times roman;"> ''[Name=OriMode] string :: {Orientation type (GRID) (Def=Std)}''</span style>''</span style>
+
*[Name=OriMode] string :: {Orientation type (GRID) (Def=Std)}
*<span style="font-family:times roman;"> ''[Name=ZMoy] REAL :: {Average Z, Mandatory in PB}''</span style>''</span style>
+
*[Name=ZMoy] REAL :: {Average Z, Mandatory in PB}
*<span style="font-family:times roman;"> ''[Name=ZInc] REAL :: {Incertitude on Z, Mandatory in PB}''</span style>''</span style>
+
*[Name=ZInc] REAL :: {Incertitude on Z, Mandatory in PB}
  
 
Example:
 
Example:
*<span style="font-family:times roman;"> ''mm3d SaisieAppuisInitQT IMG_558{0-9}[1].tif RadialBasic 100 measures.xml''</span style>
+
* <pre> mm3d SaisieAppuisInitQT IMG_558{0-9}[1].tif RadialBasic 100 measures.xml </pre>
 +
*'NB: visual interface for argument edition available with command:
 +
<pre> mm3d vSaisieAppuisInitQT </pre>
  
*<span style="font-family:times roman;"> ''NB: visual interface for argument edition available with command:''</span style>
+
===Example===
 +
For example with the Saint-Michel de Cuxa data set :
  
*<span style="font-family:times roman;"> ''mm3d vSaisieAppuisInitQT''</span style>
+
*<pre>SaisieAppuisInitQT "Abbey-IMG_(021[12]|023[3456]).jpg" All-Rel NamePointInit.txt MesureInit.xml </pre>
  
===Example===
 
For example:
 
*<span style="font-family:times roman;"> ''mm3d SaisieAppuisInitQT "IMG_(023[3456]).jpg" All NamePoint.txt''</span style>
 
Same equivalent tools exist for SaisieAppuisPredic and SaisieBasc (ie. mm3d SaisieAppuisPredicQT and mm3d SaisieBascQT <br>
 
 
A visual interface for argument edition is also available with command:
 
A visual interface for argument edition is also available with command:
*<span style="font-family:times roman;"> ''mm3d vSaisieAppuisInitQT} or mm3d vSaisieAppuisPredicQT''</span style>
+
*<pre>mm3d vSaisieAppuisInitQT} or mm3d vSaisieAppuisPredicQT</pre>
 +
 
 +
== Video tutorial and notes ==
 +
 
 +
=== How to use SaisieAppuisInitQT explained in this tutorial ===
 +
{{#ev:youtube|https://www.youtube.com/watch?v=fz7NXFg9770}}
 +
 
 +
 
 +
=== XML file for image measurements  ===
 +
The last mandatory named argument is the name of an XML file where the image coordinates (X and Y in pixels) of the points are stored. Note : if you specify "MesureInit.xml" for this argument, two files will be created with slightly different names (and no "MesureInit.xml") :
 +
* MesureInit-S2D.xml, which stores points in 2D coordinates for each image;
 +
* MesureInit-S3D.xml, which stores points in 3D coordinates, computed by spatial resection in the relative coordinate systems given by the input orientation.
 +
 
 +
=== Validation of targeted points ===
 +
In the SaisieAppuisInitQt window, when you point a target you have to validate it by right click and "Validate" in the contextual menu to get the coordinates stored.<br>
 +
Other values as "Dubious", "Refuted", "Not captured" change the color of the target and [http://forum-micmac.forumprod.com/saisieappuispredicqt-attributes-of-gcp-t1409.html| seems to have the same effect] as a reverse of the validation.

Version actuelle en date du 24 avril 2017 à 11:54

Picto-liste.png List of commands

Description

It runs with the same arguments as SaisieAppuisInit. SaisieAppuisInitQT displays two lists on the right side: the points list, and the images list. Points list can be clicked to choose which point to measure. You can also remove a point by clicking it in the list and press Suppr. You can also right-click and choose between following actions:

  • Change images for selected point
  • Delete selected points (multiple selection allowed)
  • Validate selected points (idem)

The image lists show all available images. When a point has been measured in at least two images, the image list is displayed. Images currently displayed in the windows are highlighted in blue. The image where the cursor is moving is displayed in light orange. You can right-click and select View images to load corresponding images. A 3D window shows the images location, and the point measured. By default point are displayed in red ; when a point is selected, it is displayed in blue. You can drag-and-drop a ply file in this window (such as AperiCloud.ply) to check if GCP are good.

Syntax

The global syntax for SaisieAppuisInitQT is :

mm3d SaisieAppuisInitQT FullName Orientation PointName FileForImageMeasurements NamedArgs 

Help

You can access to the help by typing :

mm3d SaisieAppuisInitQT -help

Mandatory unnamed args :

  • string :: {Full name (Dir+Pattern)}
  • string :: {Orientation ; NONE if not used}
  • string :: {Point name, or point file name}
  • string :: {File for image measurement}

Named args :

  • [Name=SzW] Pt2di :: {Sz of window}
  • [Name=NbF] Pt2di :: {Nb of sub window}
  • [Name=NameAuto] string :: {Prefix for automatic point creation}
  • [Name=ForceGray] bool :: {Force gray image, def=false}
  • [Name=OriMode] string :: {Orientation type (GRID) (Def=Std)}
  • [Name=ZMoy] REAL :: {Average Z, Mandatory in PB}
  • [Name=ZInc] REAL :: {Incertitude on Z, Mandatory in PB}

Example:

  •  mm3d SaisieAppuisInitQT IMG_558{0-9}[1].tif RadialBasic 100 measures.xml 
  • 'NB: visual interface for argument edition available with command:
 mm3d vSaisieAppuisInitQT 

Example

For example with the Saint-Michel de Cuxa data set :

  • SaisieAppuisInitQT "Abbey-IMG_(021[12]|023[3456]).jpg" All-Rel NamePointInit.txt MesureInit.xml 

A visual interface for argument edition is also available with command:

  • mm3d vSaisieAppuisInitQT} or mm3d vSaisieAppuisPredicQT

Video tutorial and notes

How to use SaisieAppuisInitQT explained in this tutorial


XML file for image measurements

The last mandatory named argument is the name of an XML file where the image coordinates (X and Y in pixels) of the points are stored. Note : if you specify "MesureInit.xml" for this argument, two files will be created with slightly different names (and no "MesureInit.xml") :

  • MesureInit-S2D.xml, which stores points in 2D coordinates for each image;
  • MesureInit-S3D.xml, which stores points in 3D coordinates, computed by spatial resection in the relative coordinate systems given by the input orientation.

Validation of targeted points

In the SaisieAppuisInitQt window, when you point a target you have to validate it by right click and "Validate" in the contextual menu to get the coordinates stored.
Other values as "Dubious", "Refuted", "Not captured" change the color of the target and seems to have the same effect as a reverse of the validation.