====== Orbit Mapping Resources - Structure and Configs ====== This page describes basic technical configurations of Orbit Mapping\UAS Runs and Oblique Projects. It is strongly recommended to read first * [[180:technology:3d_mapping:about_resources|]] * [[180:technology:3d_mapping:about_resources_oblique|]] ===== 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 Mapping Run\Project. \\ 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. \\ An Orbit Oblique Project version 3 uses the “orbit_oblique.oop” file as reference resource file. \\ This updated structure has been developed to optimize performance and to use new tools of the [[180:products:3dm_content_manager|]] and 3D Mapping Cloud. For previous version or to convert existing runs\projects into the updated structure, see [[110:mobile_mapping:desktop:mobile_mapping:manage:runs_version|]]. ===== Configurations for Mapping\UAS Runs and Oblique Projects ===== Add/edit and save the listed files using a standard text editor (e.g. Notepad), respect file formatting and structure. === Redirect image 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. * File : \\ ''./panorama/original/link.ini'' \\ ''./panorama/processed/link.ini'' \\ ''./planar/original/link.ini'' \\ ''./planar/processed/link.ini'' \\ * Parameter : not applicable * Values : directory path * Default Value : * Example \\192.168.0.1\images\ === Original image file extension === Used image storage format of original images (panorama or planar). * File : /orbit_mm_run.omr; /orbit_oblique.oop * Parameter : ''photo.file.extension'' * Values : Any supported image resource can be used, see [[180:technology:supported_formats:index|]].\\ * Default Value : *.jpg === Camera Parameters === Height of the camera above ground expressed in meters, use dot as decimal separator. This height is used to [[112:mobile_mapping:desktop:core:use:overlay_vector|display 2D vector data]] in the 3D mobile mapping views and for the [[112:mobile_mapping:desktop:core:use:measure|point drop measure function]]. * File : /orbit_mm_run.omr; /orbit_oblique.oop * Parameter : ''photo.camera.height'' * Default Value : 2.2 * Unit : meters === 2D Vector Visualization Parameters === Possible range of the offset of 2D vector data to the height of the photo position (presented as a slider in the vector overlay parameters pop-up of the photo viewer). * File : /orbit_mm_run.omr; /orbit_oblique.oop * Parameters : \\ ''data2d.overlay.min.offset'' \\ ''data2d.overlay.max.offset''\\ * Default value : 5 * Unit : meters Mostly need to be changed for UAS Runs depending on the flying height. ===== Configurations for Mapping Runs Only ===== === Simplified Trajectory === At import of photo positions or trajectory the trajectory simplified (coverage) will be created automatically if does not yet exist. The below settings can be used to adjust the defaults, as used in the example below. Coordinate will be added if its perpendicular drop distance to the segment between previous and next coordinate is larger than maximum.distance. * File : /orbit_mm_run.omr * Parameter : ''simplified.trajectory.maximum.distance'' * Values : Integer value * Units: meter * Default Value : 1 Two consecutive original coordinates won't be connected if segment length is larger than part.separation. * File : /orbit_mm_run.omr * Parameter : ''simplified.trajectory.part.separation'' * Values : Integer value * Units: meter * Default Value : 10 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. * File : /orbit_mm_run.omr * Parameter : ''photo.sequence.key'' * Values : Any photo position attribute, a combination of attributes can be used, e.g. OrbitTimeStamp+ObjectId. * Default Value : OrbitPhotoId Generalization of the trajectory visualization for different viewing scales. It is only recomended to change it in case if trajectory recorded with less than 1 point per meter. * File : /orbit_mm_run.omr * Parameter : ''simplified.overlay.size.pixels'' * Values : Integer value * Units: meter * Default Value : 10 === Example === 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 template.parameters=PARAM_CRS ===== Configurations for Oblique Projects Only ===== Mean terrain height. The value is used as a fall back value for the areas with missing DEM * File : /orbit_oblique.oop * Parameter : ''reference.z'' * Unit : meter * Default value : 0 ''reference.pan'' Photo orientation offset (heading) between the reference north direction and the actual north flying axis. * File : /orbit_oblique.oop * Parameter : ''reference.pan'' * Unit : degrees * default value : 0° * Positive rotation : clockwise Photo orientation maximal deviation (heading) from the corrected reference directions (see above reference.pan) and the according flying axes (north, east, south, west). * File : /orbit_oblique.oop * Parameter : ''near.margin'' * Unit : degrees * Default value : 10° * Positive rotation : not applicable as this is an absolute value