Recent Changes

Differences

This shows you the differences between two versions of the page.

--- dev:desktop_ext:mapping:manage:runs_version [2018/02/01 10:45]
jve@orbitgt.com [Concepts]
+++ dev:desktop_ext:mapping:manage:runs_version [2024/03/06 18:55] (current)
glen [Mapping Run Configurations]
@@ Line 1: / Line 1: @@
-====== Orbit Run Versions & Structure ======
+====== Orbit Mapping Resources - Structure and Configs ======
-This page describes basic technical configurations of Orbit Mapping Runs and Oblique Projects.
+This page describes basic technical configurations of Orbit Mapping\UAS Runs and Oblique Projects.
+It is strongly recommended to read first
+  * [[dev:technology:3d_mapping:about_resources|]]
+  * [[dev: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. \\
+Orbit is constantly improving tools and software which may result in an update of the files and structure of a Mapping Run. \\
-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.
+Backward compatibility is guaranteed. A newer Orbit release supports mobile mapping runs created by a previous Orbit version. However, to take advantage of new features it is required to use the latest file and run structures.
-It is strongly recommended to read first [[technology:mm_concepts:about_resources|]].
+An Orbit Run version 3 uses the "orbit_mm_run.omr" file as a reference resource file. \\
+An Orbit Oblique Project version 3 uses the "orbit_oblique.oop" file as a reference resource file. \\
+This updated structure has been developed to optimize performance and to use new tools of the  [[dev:products:3dm_manage_and_extract|]] 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|]].
-===== Mapping Run version 3 =====
-The current structure is in place since Orbit version 11.0.
+=====  Mapping Run Configurations =====
-==== Updated structures ====
+Configurations to be added into the .omr Mapping Resource root file. \\
+Edit and save the configuration files using a standard text editor (e.g. Notepad), respect file formatting and structure.
-An Orbit Run version 3 uses the “orbit_mm_run.omr” file as reference resource file. \\
+==== Parameters editable at Create Run ====
-This updated structured has been developed to optimize performance and to use new tools of the  [[180:products:3dm_content_manager|]] and 3D Mapping Cloud.
-Structure updates compared to run version 2 :
+To allow the user to enter any parameter through the user interface following structures are used in *.omr and *.oop:
-  * Point Cloud : ../pointcloud/point_cloud.opc
+  * **template.parameters**: general parameter applicable for the whole Run, currently only **PARAM_CRS** and **PARAM_CRS2** (see Source and Target CRS below) can be entered in general parameters
-  * Trajectory : ../trajectory/trajectory.ovf
+  * **template.parameters.name_of_the_resource**: parameters applicable only for a specific resource in the Run
-  * Simplified Trajectory : ../trajectory_simplified
-  * Trajectory Adjustments : ../trajectory_adjustment
-==== Configuration Files ====
+<code>
+Example:
+template.parameters.planar1=SensorSizePIXX;SensorSizePIXY;SensorSizeXMM;SensorSizeYMM;PrincipalPointX;PrincipalPointY;FocalLenghtMM;Dist_CV_K1;Dist_CV_K2;Dist_CV_K3;Dist_CV_K4;Dist_CV_K5;Dist_CV_K6;Dist_CV_P1;Dist_CV_P2;Dist_CV_CX;Dist_CV_CY;Dist_CV_FX
+template.parameters.planar2=SensorSizePIXX;SensorSizePIXY;SensorSizeXMM;SensorSizeYMM;PrincipalPointX;PrincipalPointY;FocalLenghtMM;Dist_CV_K1;Dist_CV_K2;Dist_CV_K3;Dist_CV_K4;Dist_CV_K5;Dist_CV_K6;Dist_CV_P1;Dist_CV_P2;Dist_CV_CX;Dist_CV_CY;Dist_CV_FX
+</code>
+Parameters will be read into corresponding {name_of_the_parameter} variable.
-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". \\
+==== Source and Target CRS ====
-Some additional configurations can be added or updated after import, so called "Optional configurations".
-=== Import configurations ===
+To allow re-projecting of the data from one projection system to another 2 parameters, entered through GUI, are available
+  * Source projection system -  **PARAM_CRS**: projection system (CRS) of the source files. We assume that all source files (trajectory, photo positions, point cloud, etc are provided in the same CRS)
+  * Target projection system -  **PARAM_CRS2**: final CRS of the Run
+<note important>There is only one case when Orbit requires re-projecting of the data: in case if the input files are provided in feet-based CRS, we strongly recommend re-project into the corresponding meter based CRS. In all other cases, we advise keeping data as is as any conversion introduces in-accuracy.</note>
-An Orbit training is required to create and update your proper import configuration files. Contact sales at orbitgt dot com.
+==== Images file extension ====
-=== Optional configurations ===
+The used image storage format of original images (panorama or planar).
-Add/edit and save the listed files using a standard text editor (e.g. Notepad).
+  * File : <Orbit Run>/orbit_mm_run.omr; <Orbit Run>/orbit_oblique.oop
+  * Parameter : ''photo.file.extension''
+  * Values : Any supported image resource can be used, see [[dev:technology:supported_formats:index|]].\\
+  * Default Value : .jpg
-== orbit_mm_run.omr ==
+=== Example ===
-The Orbit run identifier file (required). \\
+<code>
-<Orbit Run directory>/orbit_mm_run.omr
+version 3
+project.type generic
+project.file orbit_mm_run.omr
+photo.camera.height 2.20
+photo.sequence.key OrbithPhotoId
+photo.file.extension .tif
+template.parameters=PARAM_CRS
+</code>
-** Camera height **
+==== Redirect image file directory ====
-''photo.camera.height''
+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.
-Height of camera above the road surface 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 : \\ ''./panorama<x>/original/link.ini'' \\ ''./panorama<x>/processed/link.ini'' \\ ''./planar<x>/original/link.ini'' \\ ''./planar<x>/processed/link.ini'' \\
+  * Parameter : not applicable
+  * Values : directory path
+  * Default Value :
+  * Example <code>
+\\192.168.0.1\images\
+</code>
-** Image file extension **
+==== Camera Height ====
-''photo.file.extension''
+Height of the camera above ground expressed in meters, use dot as decimal separator. This height is used to [[dev:desktop_ext:mapping:use:overlay_vector|display 2D vector data]] in the 3D mobile mapping views and for the [[dev:technology:3d_mapping:measurements|point drop measure function]].
-File extension of original images, default "jpg". However any supported image resource can be used, see [[technology:supported_formats:index|]].
+  * File : <Orbit Run>/orbit_mm_run.omr; <Orbit Run>/orbit_oblique.oop
+  * Parameter : ''photo.camera.height''
+  * Default Value : 2.2
+  * Unit : meters
-** Simplified trajectory **
+==== 2D Vector Visualization Parameters ====
-''simplified.trajectory.maximum.distance'' \\
+The 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).
-''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.
+  * File : <Orbit Run>/orbit_mm_run.omr; <Orbit Run>/orbit_oblique.oop
-  * 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).
+  * Parameters : \\ ''data2d.overlay.min.offset'' \\ ''data2d.overlay.max.offset''\\
-  * part.separation : two consecutive original coordinates won't be connected if segment length is larger than part.separation (meter).
+  * Default value : 5
-  * 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.
+  * Unit : meters
-** Example **
+Mostly need to be changed for UAS Runs depending on the flying height.
+==== 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. The creation of the Simplified Trajectory required the OrbitPhotoID to be unique for every image.
+Coordinate will be added if its perpendicular drop distance to the segment between the previous and next coordinate is larger than maximum.distance.
+  * File : <Orbit Run>/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 Run>/orbit_mm_run.omr
+  * Parameter : ''simplified.trajectory.part.separation''
+  * Values : Integer value
+  * Units: meter
+  * Default Value : 10
+The 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 Run>/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 recommended to change it in case if trajectory recorded with less than 1 point per meter.
+  * File : <Orbit Run>/orbit_mm_run.omr
+  * Parameter : ''simplified.overlay.size.pixels''
+  * Values : Integer value
+  * Units: meter
+  * Default Value : 10
+=== Example ===
 <code>
@@ Line 79: / Line 144: @@
 simplified.trajectory.part.separation 10
 photo.sequence.key OrbithPhotoId
-fixed.local.crs {PARAM_CRS}
 template.parameters=PARAM_CRS
 </code>
-== link.ini ==
+If any of the parameters are changed after a Run was already imported the simplified trajectory needs to be recalculated. In order that to happen:\\
+ - Delete trajectory_simplified.ovt\\
+ - Open the Run --> Edit Run --> Re-Import Panorama. When you import panorama's photo positions the simplified trajectory will be recalculated
-The image redirect file (optional) ((link.ini image redirect file : available from Orbit 11.1.0)). \\
+==== Reference Height ====
-<Orbit Run directory>/<camera>/original/link.ini \\
-<Orbit Run directory>/<camera>/processed/link.ini
-**Redirect images** \\
+Mean terrain height. The value is used as a fall back value for the areas with missing DEM
-To avoid file copy into the appropriated Orbit run folder structure 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 : <Orbit Run>/orbit_oblique.oop
+  * Parameter : ''reference.z''
+  * Unit : meter
+  * Default value : 0
-**Example**
+==== Reference Direction ====
-<code>
-\\192.168.0.1\images\
-</code>
-===== Run version 2 from Orbit 10.5 to 11.0 =====
-An Orbit run version 2 uses the “orbit_mm_run.omr” file as central mobile mapping run resource file. \\
+''reference.pan''
-Run version 2 has been developed to optimize performance and to use new tools like [[180:desktop_ext:mobile_mapping:manage:imagery|]] and [[180:desktop_ext:mobile_mapping:manage:pointcloud_ortho|]].
+Photo orientation offset (heading) between the reference north direction and the actual north flying axis.
+  * File : <Orbit Run>/orbit_oblique.oop
+  * Parameter : ''reference.pan''
+  * Unit : degrees
+  * default value : 0°
+  * Positive rotation : clockwise
-Structure :
+Photo orientation maximal deviation (heading) from the reference directions. All oblique images are assigned to one of the four flying axes based on their heading. The total angle which defines one flying axe class is defined as the reference direction of that flying axe plus twice the near margin value (once on each side of the axe).
-  * Photo positions : ../panorama/locations.ovt
+  * File : <Orbit Run>/orbit_oblique.oop
-  * Images : ../panorama/original or processed if the images are processed
+  * Parameter : ''near.margin''
-  * Point Cloud : ../pointcloud/point_cloud.ocp
+  * Unit : degrees
-  * Point Cloud Orthophotos : ../pointcloud_ortho
+  * Default value : 10°
-  * Trajectory : ../trajectory
+  * Positive rotation : not applicable as this is an absolute value
-===== Run version 1 from Orbit 10.0 to 10.5 =====
+==== OrbitPhotoId Unique Image ID====
-An Orbit run version 1 uses the “panorama_positions.ovf” file as central mobile mapping run resource file.
+The OrbitPhotoId must be a unique image id for the entire Mapping Run. \\
+Attention required if one run has multiple planar cameras having images with the same filename. Ensure the OrbitPhotoId value to be unique for all images of the entire Mapping Run. \\
+If needed use the "concat" function to add a the camera name as prefix to create a unique image id.
-Structure :
+==== Timestamp Offset====
-  * Photo positions : panorama_positions.ovf
-  * Images : /images/
+Convert timestamp values from GPS Week Seconds to Absolute GPS Time and vice versa for Trajectory, Photo Positions and Point Cloud data. \\
-  * Point Cloud : point_cloud.ovt
+The offset between GPS Week Seconds to Absolute GPS Time. The value can be negative or positive. \\
+At "Create Run" the offset value can be entered by the user. The entered value will be used to replace the template place holder Tag  {PARAM_TIMESTAMP_OFFSET}.
+=== Trigger user to enter time offset at Create Run ===
+  * File: <Orbit Run>/orbit_mapping_run.omr (or orbit_mm_run.omr) \\ <code>template.parameters=PARAM_TIMESTAMP_OFFSET</code>
+=== Template Tag to be replaced by user-entered offset value ===
+Photo Positions
+  * File: <Orbit Run>/<camera>/import/import_locations.ord \\ <code>   AddAttribute=
+    AttributeName=OrbitTimestamp
+    AttributeType=FLOAT8
+    AttributeExpression=Add({PARAM_TIMESTAMP_OFFSET},[Imported Value])</code>
+Trajectory
+  * File: <Orbit Run>/trajectyory/import/import_trajectory.ord \\ <code>   AddAttribute=
+    AttributeName=OrbitTimestamp
+    AttributeType=FLOAT8
+    AttributeExpression=Add({PARAM_TIMESTAMP_OFFSET},[Imported Value])</code>
+Point Cloud
+  * File: <Orbit Run>/pointcloud/import/import.ini \\ <code>TimeOffset {PARAM_TIMESTAMP_OFFSET}</code>
+==== Heading and Tilt====
+When no orientation heading and tilt are available, it can be calculated based on previous and next photo positions.
+  * File : <Orbit Run>/orbit_mm_run.omr
+  * Parameter : ''template.pan_tilt.calculate''
+  * Values : image folder
+=== Example ===
+<code>
+version 3
+project.type generic
+project.file orbit_mm_run.omr
+photo.camera.height 2.20
+template.pan_tilt.calculate panorama1
+template.parameters=PARAM_CRS
+</code>
+====== Video ======
-\\
+===Supported formats===
-===== Update existing runs =====
-==== Update run vresion 2 to 3 ====
+Preferably .mp4 files. \\
+When using cloud blob storage, the storage needs to support "range requests" to open the video at a specific time offset from start.
-A new import using a run template version 3 is required. \\
-A version 2 point cloud can be selected as source file to import your new run.
-==== Update run version 1 to 2 ====
+===Attributes===
-A new import using a run template version 2 is required. \\
+|< 100% 10% 60% 10% 10% 10% >|
-A version 1 point cloud can be recovered, copy ../pointcloud/processed/*.opc and *.opcmr files to your new run.
+^ What ^ Description ^  Data type  ^  Units  ^  Necessity  ^
+| Video Filename  | - Relative location inside the run's video folder.\\ - Absolute URL pointing to the online storage location of the video.  |  string  | |  required  |
+| Video Time  | The time offset from the start of the video.  |  integer  |  milliseconds |  required

Last modified:: 2018/06/21 08:13