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.
#imagename,coordinate1,coordinate2,z,yaw,pitch,roll 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 formats are described in the table below:
- Geographic coordinates, Yaw, Pitch, Roll
- Geographic coordinates, Yaw, Pitch, Roll, and accuracy values
- Projected coordinates, Yaw, Pitch, Roll
- Projected coordinates, Yaw, Pitch, Roll, and accuracy values
| 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°. |
| 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°. |
| 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.
label, Easting [meter], Northing [meter], z [meter]
Check the order of AXES on the EPSG website.
These roll-pitch-yaw angles are according to 321 Euler rotation sequence and the respective Earth-Body XYZ coordinates are defined in NED?
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.