XifGps2Xml : Différence entre versions

De MicMac
Aller à : navigation, rechercher
(Page créée avec « 25px List of commands ==Description== The tool OriExport can convert MicMac external oriention to the de facto standard codification... »)
 
m (Fix typo)
 
(17 révisions intermédiaires par un autre utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
[[Image:picto-liste.png|25px]] [[Command|List of commands]]
 
[[Image:picto-liste.png|25px]] [[Command|List of commands]]
 
==Description==
 
==Description==
The tool OriExport can convert MicMac external oriention to the de facto standard codification using
+
Often the GPS information is not in separate files but directly embedded in the EXIF metadata. The tools
omega-phi-kappa. For now it's quite basic and all the options are not implemented. However, it should solve the majority
+
[[XifGps2Xml]] and [[XifGps2Txt]] allow to do extract this information and convert it to text or XML file.
of problem relative to exporting resuls in classical photogrammetric softwares.
+
  
 
===Syntax===
 
===Syntax===
The global syntax for OriExport is :
+
The global syntax for XifGps2Xmlt is :
<pre>mm3d OriExport FullName Results NamedArgs</pre>
+
<pre>mm3d XifGps2Xml FullName Orientation NamedArgs</pre>
  
 
===Help===  
 
===Help===  
 
You can access to the help by typing :
 
You can access to the help by typing :
<pre>mm3d AperiCLoud -help</pre>
+
<pre>mm3d XifGps2Xml -help</pre>
  
Mandatory unnamed args :
+
====Mandatory unnamed args :====
* string :: {Full Directory (Dir+Pattern)}
+
* string :: {Full Name}
* string :: {Results}
+
* string :: {Orientation}
Named args :
+
====Named args :====
* [Name=AddF] bool :: {Add format as first line of header, def= false}
+
* [Name=DoRTL] bool :: {Do Local Tangent RTL (def=true)}
* [Name=ModeExp] string :: {Mode export, def=WPK (Omega Phi Kapa)}
+
* [Name=RTL] string :: {Name RTL}
 +
* [Name=SysCo] string :: {System of coordinates, by default RTL created (RTLFromExif.xml)}
 +
* [Name=DefZ] REAL
  
==Example==
+
====Options :====
An example with Cuxha data set :
+
* <b>DoRTL</b> : Transform the coordinate in RTL.
<pre>mm3d OriExport Ori-All-Rel/Orientation-Abbey-IMG_034.*.jpg.xml res.txt</pre>
+
* <b>RTL</b> : Name of the file which define the RTL.
 +
* <b>DefZ</b> : Will allow to specify the altitude value, not implemanted for now.
 +
* <b>SysCo</b> : Allow to change the coordinate system.
  
=Formalism=
+
===Example===
==Output==
+
For example, with :
OriExport will generate the file res.txt containinig :
+
<pre>mm3d XifGps2Xml .*jpg Test</pre>
<pre>
+
* For each image, containing GPS data in EXIF, a file is created containing the GPS information in XML MicMac format.
Abbey-IMG_0340.jpg -4.304443 11.785803 136.229854 -5.491274 2.702560 -0.004106
+
* For example for <b>Image100.jpg</b>, <b>Ori-Test/Orientation-Image100.jpg.xml</b> is created, in XML MicMac format.
Abbey-IMG_0341.jpg -3.775959 11.249636 137.040260 -6.109496 2.042527 0.097497
+
* The coordinate system is a local tangent sytem, with origin at center of images.
Abbey-IMG_0342.jpg -3.849398 11.231276 137.533559 -6.707432 1.351133 0.224315
+
* The file RTLFromExif.xml contains the definition of this system in MicMac format.
Abbey-IMG_0343.jpg -3.921196 11.302498 137.899618 -7.334180 0.668316 0.362218
+
</pre>
+
Which correspond to :
+
<pre>ImageName X Y Z omega phi kappa</pre>
+
NB : The image coordinates are exported in the system you have choosen (often a local euclidian frame).
+
 
+
==Rotation matrix==
+
Matrix R gives rotation terms to compute parameters in matrix encoding with respect to omega-phi-kappa
+
angles given by the tool OriExport.
+
 
+
\begin{equation}
+
R=
+
\begin{pmatrix}
+
\cos(\phi)\cos(\kappa) & \cos(\phi)\sin(\kappa) & -\sin(\phi)\\
+
\cos(\omega)\sin(\kappa) + \sin(\omega)\sin(\phi)\cos(\kappa) & -\cos(\omega)\cos(\kappa) + \sin(\omega)\sin(\phi)\sin(\kappa) & \sin(\omega)\cos(\phi)\\
+
\sin(\omega)\sin(\kappa)-\cos(\omega)\sin(\phi)\cos(\kappa) & -\sin(\omega)\cos(\kappa)-\cos(\omega)\sin(\phi)\sin(\kappa) & -\cos(\omega)\cos(\phi)
+
\end{pmatrix}
+
\end{equation}
+
 
+
For example OriExport will give in degree:\\
+
\begin{equation}
+
\omega = 5.819826\\
+
\phi = 7.058795\\
+
\kappa = 12.262634
+
\end{equation}
+
 
+
The corresponding matrix encoding using R is:
+
<pre>
+
<ParamRotation>
+
<CodageMatr>
+
<L1>0.969777798578237427 -0.210783330505758815 0.122887790140630643</L1>
+
<L2>-0.199121821850641506 -0.974794184828703614 -0.100631989382226852</L2>
+
<L3>0.141001849092942777 0.0731210284736428379 -0.987305319416100224</L3>
+
</CodageMatr>
+
</ParamRotation>
+
</pre>
+

Version actuelle en date du 24 novembre 2016 à 10:12

Picto-liste.png List of commands

Description

Often the GPS information is not in separate files but directly embedded in the EXIF metadata. The tools XifGps2Xml and XifGps2Txt allow to do extract this information and convert it to text or XML file.

Syntax

The global syntax for XifGps2Xmlt is :

mm3d XifGps2Xml FullName Orientation NamedArgs

Help

You can access to the help by typing :

mm3d XifGps2Xml -help

Mandatory unnamed args :

  • string :: {Full Name}
  • string :: {Orientation}

Named args :

  • [Name=DoRTL] bool :: {Do Local Tangent RTL (def=true)}
  • [Name=RTL] string :: {Name RTL}
  • [Name=SysCo] string :: {System of coordinates, by default RTL created (RTLFromExif.xml)}
  • [Name=DefZ] REAL

Options :

  • DoRTL : Transform the coordinate in RTL.
  • RTL : Name of the file which define the RTL.
  • DefZ : Will allow to specify the altitude value, not implemanted for now.
  • SysCo : Allow to change the coordinate system.

Example

For example, with :

mm3d XifGps2Xml .*jpg Test
  • For each image, containing GPS data in EXIF, a file is created containing the GPS information in XML MicMac format.
  • For example for Image100.jpg, Ori-Test/Orientation-Image100.jpg.xml is created, in XML MicMac format.
  • The coordinate system is a local tangent sytem, with origin at center of images.
  • The file RTLFromExif.xml contains the definition of this system in MicMac format.