====== Prepare Trimble MX Generic Resources ======

This page describes Trimble MX files exported by Trident for Orbit. \\
Using the according [[195:desktop_ext:mapping:manage_import:templates|Orbit Import Templates]] the described resources can be [[195:desktop_ext:mapping:manage_import:index|imported into Orbit]].

It is **strongly recommend** to read first [[195:technology:3d_mapping:about_resources|]].

===== Trimble Export =====

This document describes how to use Trident to export the files as documented on this page. \\
{{:170:desktop_ext:mobile_mapping:manage_import:trimble_mx2_data_into_trimble_mx_software_0302147.pdf|}}

===== Trajectory =====

=== Trajectory positions file ===

  * File format : One ascii *.csv file.
  * File structure Rows : Each timestamp is one record.
  * File structure Columns : Tab separated (char9), no headers, with exact order as the example below.
  * Value of Coordinates : any [[195:technology:core:crs|supported coordinate system]] can be used, Long/Lat order for geographical coordinates, decimal notation, without thousands separator.
  * Value of Timestamp : GPS Absolute time or GPS Week time, decimal notation, without thousand separator. 

<code>
413271.000	30.340897080	-97.694703378	188.8011	0.017	0.019	0.035	0.019045	0.018966	0.060342
413272.000	30.340814635	-97.694561605	187.8982	0.013	0.014	0.029	0.018057	0.017994	0.059934
413273.000	30.340751275	-97.694413931	186.9808	0.012	0.011	0.024	0.017443	0.017416	0.059664
...
</code>

===== 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 : ladybug_panoramic_000000.jpg, ladybug_panoramic_000001.jpg, ladybug_panoramic_000002.jpg, ...
  * Folder structure : All files in one folder.

=== Image positions file ===

  * File format : One ascii *.csv file.
  * File structure Rows : One record for each image. 
  * File structure Columns : Comma separated (char44), headers, exact order as the example below.
  * Value of "ImageName" : xxx_00000.jpg xxx_00001.jpg, xxx_00002.jpg, ...
  * Value of Coordinates : any [[195:technology:core:crs|supported coordinate system]] can be used, Long/Lat order for geographical coordinates, decimal notation, without thousands separator.

<code>
T3DFrameNo,AVIFrameNo,GpsSeconds,ImageName,X-Ori,Y-Ori,Z-Ori,H-Veh,R-Veh,P-Veh,X-Sensor,Y-Sensor,Z-Sensor,H-Sensor,R-Sensor,P-Sensor,Dist,ltx,lty,ltz,rtx,rty,rtz,lbx,lby,lbz,rbx,rby,rbz
0,0,19437.08685,Record(0)_panorama_000000,25063.032,10676.833,23.727,353.307,-0.119,0.530,25062.817,10677.713,24.384,353.779,0.184,0.963,0.000,25060.679,10679.441,26.030,25064.491,10679.903,26.017,25060.662,10679.494,22.819,25064.474,10679.956,22.806
1,1,19440.20685,Record(0)_panorama_000001,25062.767,10678.847,23.724,353.027,-0.154,0.844,25062.548,10679.723,24.386,353.497,0.156,1.277,2.032,25060.401,10681.432,26.042,25064.211,10681.913,26.031,25060.384,10681.502,22.831,25064.193,10681.982,22.820
2,2,19442.86184,Record(0)_panorama_000002,25062.513,10680.880,23.738,352.990,0.418,0.108,25062.299,10681.765,24.390,353.464,0.713,0.530,4.080,25060.165,10683.496,26.038,25063.974,10683.979,25.990,25060.121,10683.520,22.827,25063.930,10684.003,22.779
...
</code>

===== LiDAR =====

=== Point cloud files ===

  * File format : One or more *.las files for each scanner. 
  * File structure : Las version 1.2.
  * Value of Coordinates : Same CRS as Image Positions.
  * Value of Timestamp : Same reference as Trajectory.