====== Prepare MM data Generic Import ======

This page describes how to prepare mobile mapping resources for a generic import. \\
Using the generic [[112:mobile_mapping:desktop:core:manage_import:templates|Orbit import templates]] prepared mobile mapping resources can be [[112:mobile_mapping:desktop:core:manage_import:index|imported into Orbit]].

It is **strongly recommend** to read first [[112:mobile_mapping:about_mm_resources|]].

===== Trajectory =====

Currently not supported on generic import.

===== Imagery =====

==== Panoramas ====

=== Image files ===

  * Image type : equirectangular panoramas
  * Image resolution : ratio 2x1
  * Files : *.jpg files, each image is one jpg file
  * File name : exactly as "Filename" value of photo position file, see below
  * Folder structure : all files in one folder

=== Image positions and orientations file (projected, pan-tilt-roll) ===

  * Files : one asccii *.txt or *.csv file
  * Rows : each image is one record
  * Columns : tab separated (char9), headers, with exact order as the example below
  * Value "Filename" : file name as on disk, without file extension
  * Value "X", "Y" : any [[112:technologies:crs:crs_orbit|supported coordinate system]] can be used, but all mobile mapping resources should have the same crs

<code>
Filename	X	Y	Z	Pan	Tilt	Roll Timestamp
Brussel_1000000	4.404878286326054	50.85106227753124	128.33142823723782	88.132974310915699	0.095102381910084	-359.06942401248796	0
Brussel_1000001	4.404918241374241	50.85107702770032	128.37570893339338	39.507857332631851	-1.084923642050256	-359.32845731111627	1
...
</code>

==== Planars ====

=== Image files ===

  * Image type : rectified images
  * Image resolution : camera calibration setting
  * Files : *.jpg files, each image is one jpg file
  * File name :  exactly as “Filename” value of the photo position file, see below
  * Folder structure : all files in one folder

=== Image positions and orientations file ===

See above, image positions and orientations file for panoramas. 

=== Camera specifications ===

  * SensorPixelSize : physical size of pixels on the sensor CCD, expressed in mm
  * SensorPixelCountX : number of pixels in widht of the camera sensor and image
  * SensorPixelCountY : number of pixels in height of the camera sensor and image
  * SensorPixelPPX : principal point value along the sensor width
  * SensorPixelPPY : principal point value along the sensor height
  * FocalLength : focal length of the lens, expressed in mm

For every camera it is required to review and adjust the default Orbit template camera calibrations, prior to the import. \\
<Orbit installation directory>/program/ext/mobile_mapping/project/template/<template name>/planar<1,...>/import/import_locations.ord

===== LiDAR =====

=== Point cloud files ===

  * Files : one or more [[112:technologies:resources:index|supported LiDAR resources]]
  * File name : free of choice
  * Latitude, Longitude : any supported coordinate system can be used, but all mobile mapping resources should have the same crs

  * File structure if point cloud file is imported as *.txt or *.csv file
  * Flat ascii text file, comma or tab separated, column headers, with exact columns : X, Y, Z, R, G, B, I 
      * R, G, B, I value ranges 0-255, values may be empty
      * All lines are terminated by a carriage return char(13) / newline char(10) sequence
      * Name of headers are not free of choice  \\ \\ <code>
Longitude	Latitude	Z	R	G	B	I
4.40487692010655	50.8510926423286	125.763312461527	16	17	19	46
4.40487698750245	50.8510916370433	125.761583937394	16	17	19	46
...
</code>