This page describes the supported Mobile Mapping, UAS and Oblique resources, any combination of the listed resources can be used.
Orbit imports 3D mapping data using intelligent templates. An import template is configured according to a well known set of configurations, given carrier (vehicle, UAV, aircraft, etc..) setup and available data.
The use of templates simplifies and standardizes the import procedure for a well known set of data.
Download Templates
system and custom import templates can be downloaded here : 3D Mapping Data Preparation and Import Templates.
Customize Import
In addition to the available templates the Orbit engine offers all configuration possibilities to customize and optimize the import for using any kind or combination of 3D mapping data. Once the configuration is known, it can be added as a new import template to simplify all future imports.
Please contact the Orbit support team (support at orbitgt dot com) for more information or to create your customized template.
Orbit supports any combination of 3D mapping data and any coordinate system (CRS) on import. But be wise :
Optionally time-stamps can be imported. Time value can be a text string, integer or decimal value.
String values will be displayed as is and cannot be used for Content Manager post processing and point cloud view restrictions.
For post processing and point cloud view restrictions use of single time reference and “seconds” as time unit is required.
Use of Absolute (Standard) GPS Time is advised.
If Absolute GPS time values (600,000,000 < Timestamp < 3,000,000,000) are detected, Orbit will display these as “yyyy-mm-dd hh:mm:ss”1).
If GPS Week Time Seconds values (0 ⇐ Timestamp =< 604,800) are detected, Orbit will be displayed these as “d hh:mm:ss”.
Notes on Absolute GPS Time :
A trajectory of the mobile mapping vehicle is optional and can be used to display the accuracy or to adjust, clip or extract a segment of the entire mobile mapping run.
Prepare the trajectory file in the same way as the image position and orientation file : see above.
Field | Description | Data type | Units | Necessity |
---|---|---|---|---|
Timestamp | Time at recording, see “General Notes” above. | integer decimal string | optional | |
X | X, Longitude or Easting of reference point | decimal | degrees meters | required |
Y | Y, Latitude or Northing of reference point | |||
Z | Z or Height of reference point | |||
Accuracy | The Trajectory GPS Accuracy indicator is indeed interpreted as a data manager only resource. Based on the GPS Accuracy indication the data manager can do an estimated guess regarding the absolute accuracy of the data at time of recording. This indication can assist to decided if and where to measure ground control point and apply trajectory adjustments. | decimal | optional |
Orbit supports spherical and planar images.
There are no limitations on the number of cameras, the type of camera or the resolution of images.
One camera import requires one set of images and one positions and orientations file.
The absolute position and orientations at time of recording of all images must be available unambiguously.
Two possibilities :
Supported formats
Preferably .txt or .csv files.
But any supported point vector resource can be used.
Specifications
Attributes
Field | Description | Data type | Units | Necessity |
---|---|---|---|---|
Filename | Image file name as is on disk or any reference to the image file. | string | required | |
Timestamp | Time at recording, see “General Notes” above. | string integer decimal | optional | |
X | X, Longitude or Easting of reference point | decimal | degrees meters | required |
Y | Y, Latitude or Northing of reference point | |||
Z | Z or Height of reference point |
Pan / Heading | Horizontal angle between reference frame and north. Positive for clockwise rotation of reference frame. Value 0 looking north, value 90 looking east. | decimal | degrees radians grad | required |
Tilt / Pitch | Vertical angle or inclination about the lateral axes between reference frame and horizontal plane. Positive when reference frame goes up / looking up. Value 0 looking horizontally, value 90 looking vertically at the sky, value -90 looking down. |
|||
Roll | Vertical angle or inclination about the longitudinal axes between reference frame and the horizontal plane. Positive when reference frame rolls to the left, right hand turn. |
Omega | Rotation of the reference frame about X. | decimal | degrees radians grad | |
Phi | Rotation of the reference frame about Y | |||
Kappa | Rotation of the reference frame about Z |
Direction_Easting | Unit vector defining heading and pitch. By definition value range between 0-1. | decimal | undefined | |
Direction_Northing | ||||
Direction_elevation | ||||
Up_Easting | Unit vector defining roll. By definition value range between 0-1. |
|||
Up_Northing | ||||
Up_elevation |
Only when using an absolute position and orientation of a reference frame at time of recording, the fixed relative position and orientation for each camera to the used reference frame must be known. Relative position and orientation can be ignored when using the absolute position and orientation of images at time of recording.
Field | Description | Data type | Units | Necessity |
---|---|---|---|---|
CameraName | Unique name to identify the camera and to link these camera specification with the position and orientation file. | string | optional | |
CameraDeltaX | Fix distance in X expressed in meters from the origin of the camera reference frame to the IMU/GPS reference frame. | decimal | meters | required |
CameraDeltaY | Fix distance in Y expressed in meters from the origin of the camera reference frame to the IMU/GPS reference frame. |
|||
CameraDeltaZ | Fix distance in Z expressed in meters from the origin of the camera reference frame to the IMU/GPS reference frame. |
CameraDeltaPan | Fix Pan of camera reference frame to IMU/GPS reference frame. Positive for clockwise rotation of camera frame. | decimal | degrees radians grad | required |
CameraDeltaTilt | Fix tilt of camera reference frame to IMU/GPS reference frame. Positive when camera frame goes up / looking up. |
|||
CameraDeltaRoll | Fix roll of camera reference frame to IMU/GPS reference frame. Positive when camera reference frame rolls to the left. |
CameraDeltaOmega | Fix Omega of camera reference frame to IMU/GPS reference frame. | decimal | degrees radians grad | |
CameraDeltaPhi | Fix Phi of camera reference frame to IMU/GPS reference frame. | |||
CameraDeltaKappa | Fix Kappa of camera reference frame to IMU/GPS reference frame. |
Origin (rotation = 0°) or rotation offset and positive sense of rotation of orientation angles can be customized.
Metadata is optional, there is no limitation on the number of added image meta-attributes on import.
Panoramas (spherical or 360° images) are optional for Orbit MM Desktop products. The Orbit MM Publisher requires the availability of spherical images (panoramas) to operate.
Supported formats
Preferably .jpg files.
But any supported image resource can be used.
Supported types
Orbit supports any Spherical and Cubic Panorama, independently of file size or pixel resolution.
For example, Ladybug 3 and 5 are supported.
When working with Spherical panoramic images Orbit is using the stitched 360 x 180 degree panoramic image.
Since Orbit AIM version 10.5.1 Cubic Panoramas are supported.
When working with Cubic panoramic images Orbit is using the 6 original equirectangular images.
There are no limitations on the number of cameras, the type of camera or the resolution of images. One camera import requires one set of images and one positions and orientations file.
Supported formats
Preferably .jpg files.
But any supported image resource can be used.
Supported types
Orbit supports any distorted Planar picture, independently of file size or pixel resolution.
For each camera following camera and sensor specifications will be used to optimize the integration and accuracy in Orbit.
Field | Description | Data type | Units | Necessity |
---|---|---|---|---|
CameraName | Unique name to identify the camera and to link these camera specification with the position and orientation file. | string | optional | |
SensorName | Reference of sensor to have the possibility to review the sensor specifications. | string | optional | |
SensorPixelSize | Physical size of pixels on the sensor CCD, expressed in mm. | decimal | mm | required |
SensorPixelCountX | Number of pixels in width of the camera sensor and image. | integer | pixels | required |
SensorPixelCountY | Number of pixels in height of the camera sensor and image. | |||
SensorPixelPPX | The principal point value along the sensor width, expressed in number of pixels from left lower corner. Wikipedia Focal Point | decimal | pixels | required |
SensorPixelPPY | The principal point value along the sensor height. | |||
FocalLength | The focal length of the lens, expressed in mm. Wikipedia Focal Length | decimal | mm | required |
k1, k2, k3, p1, p2 | Radial distortion parameters, regarding the formulas of D.C. Brown. Wikipedia Distortion | decimal | optional |
LiDAR point cloud or point cloud derived from dense matching.
There are no limitations on the number of points, files or the total size.
Required for
Supported formats
Notes
Additional Notes for ASCII text files
When using an Ascii text file as point cloud import it is possible to configure the data-structure :
A Digital Terrain Model or Digital Surface Model covering the same area as the Mapping Resources.
Both a DTM or DSM can be used, but we recommend DTM for measurements and navigation.
Wikipedia, Digital Elevation Model.
Required for
Supported formats
Notes
Any supported reference data can be added into Orbit. Reference data is not part of a Run or a Project.