====== Faro iQscene (quaternions) ======

This page describes the original Faro terrestrial mapping resources for Orbit import.\\
Image orientation is provided as the rotation around the axis, [[https://en.wikipedia.org/wiki/Rotation_matrix|]]. 

Use the corresponding [[234:desktop_ext:mapping:manage_import:templates|Orbit Import Template]] to import the described original data. \\
It is recommend to read first [[234:technology:3d_mapping:about_resources|]].

===== Panoramas =====

=== Image files===

  * Image type : equirectangular panoramas.
  * Image resolution : Ratio 2x1
  * File format : Each image is one *.png file.
  * File name : Exactly as "Filename" value of image position file.
  * Folder structure : All files in one folder.

=== Image positions file ===

  * File format : one ascii *.txt file
  * File structure Rows: each image is one record
  * File structure Columns : Space separated (char32), headers, with exact order as the example below.
  * Value "Filename" : File name as on disk, without file extension.
  * Value of Coordinates : any [[234:technology:core:crs|supported coordinate system]] can be used, Long/Lat order for geographical coordinates, decimal notation, without thousands separator.
  * Value "Time" : GPS Absolute time or GPS Week time.


<code>
"# iQscene Model Extract"
"iQLib" 8.0.5.5516
Scans { 
"zal_007" 0 0 0 0.65151719 0.75863387 -7.2613953e-06 1.3796965 26.7.2017 12:59:33
"zal_008" 3.411437 -7.298415 0.005411 0.012549713 0.053644617 0.99848123 25.946698 26.7.2017 13:8:38
"zal_009" 6.022115 -13.035632 -0.008891 0.0074378729 0.019053047 0.99979081 60.655177 26.7.2017 13:13:42
...
}
</code>

=== Point cloud files ===

  * File format : One or more *.las or *.laz files.
  * File structure : Las version 1.2.
  * Value of Latitude, Longitude, Elevation : Same reference as Image Position File.
  * Value of Timestamp : Same reference as Image Position File.