====== TerraSolid ======

This page describes the original TerraSolid TerraPhoto mobile mapping resources for Orbit import.

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

===== Panoramas =====

=== Image files ===

  * Image type : Ladybug 5, equirectangular panoramas.
  * Image resolution : Ratio 2x1, advised 8000x4000 pixels.
  * File format : Each image is one *.jpg file.
  * File name : Exactly as "Image" value of image positions file, see below.
  * Folder structure : All files in one folder.

=== Image positions file ===

  * File format : One ascii *.csv file.
  * File structure Rows : Each image is one record.
  * File structure Columns : Comma separated (char44), headers, with exact order as the example below.
  * Value of Image : Filename as on disk with file extension, see below. 
  * Value of Coordinates : any [[201:technology:core:crs|supported coordinate system]] can be used, Long/Lat order for geographical coordinates, decimal notation, without thousands separator. 
  * Value of Timestamps : GPS Absolute time or GPS Week time, decimal notation.

** TerraPhoto IML file**

<code>
[TerraPhoto image list v5]
Image=Panoramic_0000.jpg
Time=288523.650347
Xyz=1843073.403 5168034.546 169.359
Hrp=-38.74556 1.75857 -1.57497
Camera=0
Quality=1
Line=0
Color=C0;0;0;0;0;0
AccuracyXyz=0.019
Image=Panoramic_0006.jpg
Time=288524.650352
Xyz=1843061.892 5168049.454 168.809
Hrp=-36.12105 1.53555 -1.75278
Camera=0
Quality=1
Line=0
Color=C0;0;0;0;0;0
AccuracyXyz=0.021
Image=Panoramic_0012.jpg
Time=288525.650356
Xyz=1843051.264 5168064.405 168.252
Hrp=-34.21051 1.32283 -1.78562
Camera=0
Quality=1
Line=0
Color=C0;0;0;0;0;0
AccuracyXyz=0.021
</code>

**TerraPhoto IML file converted into CSV file**

<code>
Id,Image,Time,X/Long,Y/Lat,Z,Heading,Roll,Pitch,Camera,Quality,Line,Color,AccuracyXyz
0,Panoramic_0000.jpg,288523.650347,1843073.403,5168034.546,169.359,-38.74556,1.75857,-1.57497,0,1,0,C0;0;0;0;0;0,0.019
1,Panoramic_0006.jpg,288524.650352,1843061.892,5168049.454,168.809,-36.12105,1.53555,-1.75278,0,1,0,C0;0;0;0;0;0,0.021
2,Panoramic_0012.jpg,288525.650356,1843051.264,5168064.405,168.252,-34.21051,1.32283,-1.78562,0,1,0,C0;0;0;0;0;0,0.021
...
</code>

** Convert IML into CSV ** 

Convert a TerraPhoto IML file into a CSV file for Orbit Import. \\
Following Excel Workbook can be used to do so : \\
{{:171:desktop_ext:mobile_mapping:manage_import:convert_terraphoto_iml_into_csv_for_orbit_import.xlsx|}}

=== Camera calibration ===

TerraPhoto camera calibration *.cal file. \\

<code>
[TerraPhoto calibration]
Version=20050513
Description= LB5_mat-long
TimeOffset= 0.0000
Exposure= 0.00000
LeverArm= 0.0110 -0.0160 0.9720
AntennaToCameraOffset= 0.0000 0.0000 0.0000
AttitudeCorrections(HRP)= 36.3000 0.4000 0.0000
ImageSize= 8000 4000
Margin= 0
Orientation= SIDE
PositionFromGround= 3.890
RectifyCenter= 30.0
Panoramic=-1
PrincipalPoint(XoYoZo)= 0.00000000 0.00000000 -1273.23954474
LensModel=ZeroRadius
LensA3=0.0000000000000000000000
LensA5=0.0000000000000000000000
LensR0=0.0000
LensP1=0.0000000000000000000000
LensP2=0.0000000000000000000000
</code>

===== LiDAR =====

=== Point cloud files ===

  * File format : One or more *.las files.
  * File structure : Las version 1.2.
  * Value of Coordinates : Same CRS as Photo Positions, see above.
  * Value of Timestamps : Same Time Reference as Photo Positions, see above.