De MicMac
Aller à : navigation, rechercher

Picto-liste.png List of commands


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.


The global syntax for SaisieAppuisInitQT is :

mm3d SaisieAppuisInitQT FullName Orientation PointName FileForImageMeasurements NamedArgs 


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}


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


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.