Image geolocation and orientation import format

Follow

The import of image geolocation and orientation is useful when the values are not available in the EXIF/Xmp tags or when using PPK workflows.

The image geolocation file format is a .csv or .txt file. It contains seven or nine columns per line and uses commas "," as column separators.

 
Access: The import of image geolocation and orientation is available after the images are successfully imported by using: File - Import image geolocations and orientations....

The formats are described in the table below:

 
Note*: The order of coordinates in the input file needs to follow the order of axes in the coordinate system definition chosen in the import dialog.
For example, if the coordinate system definition specifies that the first axes is X and the second is Y then the order of the coordinates in the GCP input file needs to be the same.
Geographic coordinates, Yaw, Pitch, Roll

imagename, coordinate1* [decimal degrees], coordinate2* [decimal degrees], z [meter], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees]

IMG_3165.JPG,46.2345612,6.5611445,539.931,38.6,3.5,8.3
IMG_3166.JPG,46.2323423,6.5623423,529.823,44.1,3.4,5.4

The latitude value is between -90° and 90°.
The longitude value is between -180° and 180°.

Geographic coordinates, Yaw, Pitch, Roll, and accuracy values

imagename, coordinate1* [decimal degrees], coordinate2* [decimal degrees], z [meter], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees], Accuracy Horz [meter], Accuracy Vert [meter]

IMG_3165.JPG,46.2345612,6.5611445,539.931,38.6,3.5,8.3,0.02,0.04
IMG_3166.JPG,46.2323423,6.5623423,529.823,44.1,3.4,5.4,0.02,0.04

The latitude value is between -90° and 90°.
The longitude value is between -180° and 180°.

Projected coordinates, Yaw, Pitch, Roll

imagename, coordinate1* [units], coordinate2* [units], z [units], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees]

IMG_3165.JPG,474191.175,5091809.612,539.931,38.6,3.5,8.3
IMG_3166.JPG,474188.324,5091798.618,529.823,44.1,3.4,5.4
Projected coordinates, Yaw, Pitch, Roll, and accuracy values

imagename, coordinate1* [units], coordinate2* [units], z [units], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees], Accuracy Horz [units], Accuracy Vert [units]

IMG_3165.JPG,474191.175,5091809.612,539.931,38.6,3.5,8.3,0.02,0.04
IMG_3166.JPG,474188.324,5091798.618,529.823,44.1,3.4,5.4,0.02,0.04

How to check the order of the axes in the coordinate system definition

To check the order of axes in the coordinate system definition: 

  • Open the EPSG Geodetic Parameter Registry website.
  • Write the name or the EPSG code in the EPSG Dataset - Text search.
  • Click GO and select the correct name in the results.
  • Expand the COORDINATE SYSTEM section and check the order in the AXES subsection.

After checking the order of Axes in the coordinate system definition, modify the input file to follow the same order of coordinates.

 
Example: For the WGS 84 / UTM zone 32N (EPSG code 32632) the order of axes in the coordinate system definition is first Easting and second Northing. The GCPs file should be formatted as:
label, Easting [meter], Northing [meter], z [meter]

EPSG_registry_Axes_order.jpg

Check the order of AXES on the EPSG website.

Was this article helpful?
3 out of 3 found this helpful

Article feedback (for troubleshooting, post here)

2 comments

  • Gyula Sólyom

    These roll-pitch-yaw angles are according to 321 Euler rotation sequence and the respective Earth-Body XYZ coordinates are defined in NED?

    Edited by Gyula Sólyom
  • Marco Paccagnella

    You can find the description of the conventions we use on this page: Yaw, Pitch, Roll and Omega, Phi, Kappa angles
    That page includes a PDF with more information too.

    If 321 means a Z(Yaw)-Y(Pitch)-X(Roll) rotation that corresponds to what is described in the article and the PDF file confirms that the navigation system's axes follow the NED convention.

Article is closed for comments.