OriConvert

De MicMac
Aller à : navigation, rechercher

Picto-liste.png List of commands

Description

The tool OriConvert is a versatile command used to:

  • Transform embedded GPS data from text format to MicMac's Xml orientation format.
  • Transform the GPS coordinate system, potentially into an euclidean coordinate system.
  • Generate image pattern for selecting a sample of the image block.
  • Compute relative speed of each camera in order to determine and correct GPS systematic error (delay).
  • Importing external orientation from others software: to come.

Syntax

The global syntax for OriConvert is :

mm3d OriConvert Format_Specification Orientation_File Targeted_Orientation

Allowed commands

  • OriTxtAgiSoft
  • OriBluh
  • OriTxtInFile

Results

OriConvert produce an MicMac orientation based on georeferencing data. You cannot use directly this orientation for processing tools like AperiCloud or C3DC, launch before a CenterBascule.

Workflow

You can launch the OriConvert whenever you want, but of course before orientation tools.
Picto-previous.png Previous Command : ~
Picto-next.png Next Command : CenterBascule,Campari etc...

Help

Help is the same for all arguments, You can access by typing :

mm3d OriConvert -help

Mandatory unnamed args :

  • string :: {Format specification}
  • string :: {Orientation file}
  • string :: {Targeted orientation}

Named args :

  • [Name=ChSys] string :: {Change coordinate file}
  • [Name=Calib] string :: {External XML calibration file}
  • [Name=AddCalib] bool :: {Try to add calibration, def=true}
  • [Name=ConvOri] string :: {Orientation convention (like eConvAngPhotoMGrade ...)}
  • [Name=PrePost] vector<std::string> :: {[Prefix,Postfix] to generate name of image from id}
  • [Name=KN2I] string :: {Key 2 compute Name Image from Id in file}
  • [Name=DN] REAL :: {Neighbooring distance for Image Graph}
  • [Name=ImC] string :: {Image "Center" for computing AltiSol}
  • [Name=NbImC] INT :: {Number of neighboors around Image "Center" (Def=50)}
  • [Name=RedSizeSC] INT :: {Reduced Size of image to use for Tapioca for AltiSol (Def=1000)}
  • [Name=Reexp] string :: {Reexport as Matrix (internal set up)}
  • [Name=Regul] REAL :: {Regularisation cost (Cost of hole), Def=5.0}
  • [Name=RegNewBr] REAL :: {cost of creating a new branch (Def=0.4, prop to Regul)}
  • [Name=Reliab] REAL :: {Threshold for reliable speed, Def=0.75 (prop to Regul)}
  • [Name=CalcV] bool :: {Compute speed (def = false)}
  • [Name=Delay] REAL :: {Delay to take into account after speed estimate}
  • [Name=TFC] bool :: {Teta from cap : compute orientation from speed)}
  • [Name=RefOri] string :: {Ref Orientation (internal purpose)}
  • [Name=SiftR] INT :: {Resolution of sift point for Tapioca ,when ImC, (Def No Sift)}
  • [Name=SiftLR] INT :: {Low Resolution of sift point for MultisCale ,when ImC (Def no multicale)}
  • [Name=NameCple] string :: {Name of XML file to save couples}
  • [Name=Delaunay] bool :: {Add delaunay arc when save couple (Def=true)}
  • [Name=DelaunayCross] bool :: {Complete delaunay with some crossing trick arc when save couple (Def=true)}
  • [Name=Cpt] vector<int> :: {============ [CptMin,CptMax] for tuning purpose =======}
  • [Name=UOC] bool :: {Use Only Center (tuning)}
  • [Name=MTD1] bool :: {Compute Metadata only for first image (tuning)}
  • [Name=Line] INT :: {Nb neighbour in the same line}
  • [Name=CBF] bool :: {Export calib as a link to existing file}
  • [Name=AltiSol] REAL :: {Average altitude of ground}
  • [Name=Prof] REAL :: {Average Prof of images}
  • [Name=OffsetXY] Pt2dr :: {Offset to substract from X,Y (To avoid possible round off error)}
  • [Name=CalOFC] string :: {When specified compute initial orientation from centers (in Ori-GenFromC) Ori-${CalOFC}, must contains internal calibrations}
  • [Name=OkNoIm] bool :: {Do not create error if image does not exist (def = false)}
  • [Name=SzW] REAL :: {Size for visualisation}

OriTxtAgiSoft

This tools is designed to convert orientation from Agisoft PhotoScan into MicMac orientation format.

Example

OriBluh

Example

OriTxtInFile

GPS and attitude extracted from telemetry logs are generally structured as followed :

image latitude longitude altitude yaw pitch roll
R0040438.JPG 50.5860992029 4.7957755452 375.046 319.9 8.2 -2.1
R0040439.JPG 50.5864719060 4.7953921650 376.604 319.4 10.1 3.6

In this example (from the UAS GrandLeez dataset, file GPS WPK Grand-Leez.csv), column titles are specified on the first line. Nevertheless, MicMac has its own convention regarding column title. We have to add columns specs but with the symbols K, W, P standing for kappa, omega and phi.

#F=N Y X Z K W P
#
#image latitude longitude altitude yaw pitch roll
R0040438.JPG 50.5860992029 4.7957755452 375.046 319.9 8.2 -2.1
R0040439.JPG 50.5864719060 4.7953921650 376.604 319.4 10.1 3.6

Example

Once the file has been modified, the following command can be used:

mm3d OriConvert OriTxtInFile GPS_WPK_Grand-Leez.csv Nav-Brut NameCple=FileImagesNeighbour.xml