This is documentation of a bèta release.
For documentation on the current version, please check Knowledge Base.

This is an old revision of the document!


Orbit Mapping Resources - Structure and Configs

This page describes basic technical configurations of Orbit Mapping Runs and Oblique Projects.
It is strongly recommended to read first about_resources.

Concepts

Import Templates

All advanced technical configurations related to the used resources and mobile mapping system are managed via the import template and applied on import, so called “Import configurations”.
Some additional configurations can be added or updated after import, so called “Optional configurations”.

Backwards compatibility and New Features

Orbit is constantly improving tools and software which may result in an update of the files and structure of an.
Backwards compatibility is guaranteed. A newer Orbit release supports mobile mapping runs imported in a previous Orbit version. However to take advantage of new feature updates it may be required to use the latest Orbit run version.

An Orbit Run version 3 uses the “orbit_mm_run.omr” file as reference resource file.
This updated structured has been developed to optimize performance and to use new tools of the Orbit 3DM Content Manager and 3D Mapping Cloud.

For previous version or to convert existing runs into the updated structure, see Orbit Run Versions.

Mapping Run Version 3

The current structure is in place since Orbit version 11.0.
Structure updates compared to run version 2 :

  • Point Cloud : ../pointcloud/point_cloud.opc
  • Trajectory : ../trajectory/trajectory.ovf
  • Simplified Trajectory : ../trajectory_simplified
  • Trajectory Adjustments : ../trajectory_adjustment

Configurations for Mapping Runs and Oblique Projects

Image redirect file directory

To avoid file copy into the appropriated Orbit run folder a single line ascii text file can be used to specify the image file path prefix. The file path prefix combined with the OrbitFileName attribute value will be used as file pointer.

  • Files :
    ./panorama<x>/original/link.ini
    ./panorama<x>/processed/link.ini
    ./planar<x>/original/link.ini
    ./planar<x>/processed/link.ini
  • Parameter : not applicable
  • Value : directory path
  • Example
    \\192.168.0.1\images\

Original image file extension

  • Parameter : photo.file.extension === Camera Parameters === ===== Configurations for Mapping Runs Only ===== Add/edit and save the listed files using a standard text editor (e.g. Notepad). === orbit_mm_run.omr === The Orbit run identifier file (required).
    <Orbit Run directory>/orbit_mm_run.omr
    Camera height photo.camera.height Height of camera above the road surface expressed in meters, use dot as decimal separator. This height is used to display 2D vector data in the 3D mobile mapping views and for the point drop measure function. Image file extension photo.file.extension File extension of original images, default “jpg”. However any supported image resource can be used, see supported_formats. Simplified trajectory simplified.trajectory.maximum.distance
    simplified.trajectory.part.separation
    photo.sequence.key At import photo positions or trajectory the trajectory simplified (coverage) will be created automatically if not yet exists. The above settings can be used to adjust the defaults, as used in the example below. * maximum.distance : coordinate will be added if its perpendicular drop distance to the segment between previous and next coordinate is larger than maximum.distance (meter). * part.separation : two consecutive original coordinates won't be connected if segment length is larger than part.separation (meter). * photo.sequence.key : Initial sort of coordinates before connecting to lines is based on the string value of the photo.sequence.key attribute(s). Add prefix zero characters to obtain expected sort when using integer value as sort reference. A combination of attribute values can be used as well, e.g. OrbitTimeStamp+ObjectId.
    Example <code> version 3 project.type generic project.file orbit_mm_run.omr photo.camera.height 2.20 simplified.trajectory.maximum.distance 1 simplified.trajectory.part.separation 10 photo.sequence.key OrbithPhotoId fixed.local.crs {PARAM_CRS} template.parameters=PARAM_CRS </code> ===== Configurations for Oblique Projects Only ===== === orbit_oblique.oop === Edit the Orbit Oblique Project file using a standard text editor (e.g. Notepad), do respect file formatting and structure. reference.z reference.pan
    Photo orientation offset (heading) between the reference north direction and the actual north flying axis. * Unit : degrees * default value : 0° * Positive rotation : clockwise
    near.margin
    Photo orientation maximal deviation (heading) from the corrected reference directions (see above reference.pan) and the according flying axes (north, east, south, west). * Unit : degrees * Default value : 10° * Positive rotation : not applicable as this is an absolute value
    data2d.overlay.min.offset data2d.overlay.max.offset scale.focus.to**
 
Last modified:: 2018/06/21 08:13