Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
dev:desktop_ext:mapping:manage:runs_version [2016/06/17 10:38] 127.0.0.1 external edit |
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 |
- | This page describes | + | This page describes |
- | Orbit is constantly improving tools and software which may result in an update of the files and structure of an Orbit mobile mapping Run. \\ | + | It is strongly recommended to read first |
- | 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. | + | * [[dev: |
+ | * [[dev: | ||
- | It is strongly recommended to read first [[technology: | + | ===== Concepts ===== |
- | ===== Run version 3 from Orbit 11.0 ===== | + | === Import Templates |
- | An Orbit run version 3 uses the “orbit_mm_run.omr” file as central | + | All advanced technical configurations related to the used resources and mobile mapping |
- | Run version 3 has been developed to optimize performance and to use new tools of the [[160: | + | Some additional configurations can be added or updated after import, so-called " |
- | Structure updates compared to run version 2 : | + | === Backwards compatibility and New Features === |
- | * Point Cloud : ../ | + | |
- | * Simplified Trajectory : ../ | + | |
- | * Trajectory Adjustments : ../ | + | |
- | ==== Configuration | + | Orbit is constantly improving tools and software which may result in an update of the files and structure of a Mapping Run. \\ |
+ | 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. | ||
- | 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 | + | An Orbit Run version 3 uses the "orbit_mm_run.omr" |
- | Some additional configurations can be added or updated after import, so called | + | An Orbit Oblique Project version 3 uses the "orbit_oblique.oop" |
+ | This updated structure has been developed to optimize performance and to use new tools of the [[dev: | ||
- | === Import configurations === | + | For previous version or to convert existing runs\projects into the updated structure, see [[110: |
- | An Orbit training is required to create and update your proper import configuration files. Contact sales at orbitgt dot com. | + | ===== Mapping Run Configurations ===== |
- | === Optional configurations === | + | 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. | ||
- | Add/edit and save the listed files using a standard text editor (e.g. Notepad). | + | ==== Parameters editable at Create Run ==== |
- | == orbit_mm_run.omr == | + | To allow the user to enter any parameter through the user interface following structures are used in *.omr and *.oop: |
+ | * **template.parameters**: | ||
+ | * **template.parameters.name_of_the_resource**: | ||
- | The Orbit run identifier file (required). \\ | + | < |
- | <Orbit Run directory> | + | Example: |
+ | template.parameters.planar1=SensorSizePIXX; | ||
+ | template.parameters.planar2=SensorSizePIXX; | ||
+ | </code> | ||
+ | Parameters will be read into corresponding {name_of_the_parameter} variable. | ||
- | ** Camera height ** \\ | + | ==== Source and Target CRS ==== |
- | '' | + | |
- | Height | + | To allow re-projecting |
+ | * Source projection system - **PARAM_CRS**: | ||
+ | * Target projection system - **PARAM_CRS2**: final CRS of the Run | ||
+ | <note important> | ||
- | ** Simplified trajectory ** \\ | + | ==== Images file extension ==== |
- | '' | + | |
- | '' | + | |
- | '' | + | |
- | At import photo positions | + | The used image storage format of original images (panorama |
- | * maximum.distance | + | |
- | * part.separation | + | * File : <Orbit Run>/ |
- | * photo.sequence.key | + | * Parameter |
+ | * Values | ||
+ | * Default Value : .jpg | ||
+ | |||
+ | === Example === | ||
- | ** Example ** | ||
< | < | ||
version 3 | version 3 | ||
Line 57: | Line 66: | ||
project.file orbit_mm_run.omr | project.file orbit_mm_run.omr | ||
photo.camera.height 2.20 | photo.camera.height 2.20 | ||
- | simplified.trajectory.maximum.distance 1 | ||
- | simplified.trajectory.part.separation 10 | ||
photo.sequence.key OrbithPhotoId | photo.sequence.key OrbithPhotoId | ||
- | fixed.local.crs {PARAM_CRS} | + | photo.file.extension .tif |
template.parameters=PARAM_CRS | template.parameters=PARAM_CRS | ||
</ | </ | ||
- | == link.ini | + | ==== Redirect image file directory ==== |
- | The image redirect | + | 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. |
- | <Orbit Run directory>/< | + | |
- | <Orbit Run directory>/< | + | |
- | **Redirect images** \\ | + | |
- | To avoid file copy into the appropriated | + | |
+ | | ||
+ | | ||
+ | * Example < | ||
+ | \\192.168.0.1\images\ | ||
+ | </ | ||
+ | |||
+ | ==== Camera Height ==== | ||
+ | |||
+ | Height of the camera above ground expressed in meters, use dot as decimal separator. This height is used to [[dev: | ||
+ | |||
+ | * File : <Orbit Run>/ | ||
+ | * Parameter : '' | ||
+ | * Default Value : 2.2 | ||
+ | * Unit : meters | ||
+ | |||
+ | ==== 2D Vector Visualization Parameters ==== | ||
+ | |||
+ | 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). | ||
+ | |||
+ | * File : <Orbit Run>/ | ||
+ | * Parameters : \\ '' | ||
+ | * Default value : 5 | ||
+ | * Unit : meters | ||
+ | |||
+ | 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 | ||
+ | |||
+ | 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>/ | ||
+ | * Parameter : '' | ||
+ | * 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>/ | ||
+ | * Parameter : '' | ||
+ | * 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 | ||
+ | * File : <Orbit Run>/ | ||
+ | * Parameter : '' | ||
+ | * 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>/ | ||
+ | * Parameter : '' | ||
+ | * Values : Integer value | ||
+ | * Units: meter | ||
+ | * Default Value : 10 | ||
+ | |||
+ | === Example === | ||
- | **Example** | ||
< | < | ||
- | \\192.168.0.1\images\ | + | version 3 |
+ | project.type generic | ||
+ | project.file orbit_mm_run.omr | ||
+ | photo.camera.height 2.20 | ||
+ | simplified.trajectory.maximum.distance | ||
+ | simplified.trajectory.part.separation 10 | ||
+ | photo.sequence.key OrbithPhotoId | ||
+ | template.parameters=PARAM_CRS | ||
</ | </ | ||
- | ===== 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. \\ | + | 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:\\ |
- | Run version 2 has been developed to optimize performance and to use new tools like [[160: | + | - Delete trajectory_simplified.ovt\\ |
+ | - Open the Run --> Edit Run --> Re-Import Panorama. When you import panorama' | ||
- | Structure : | + | ==== Reference Height ==== |
- | * Photo positions : ../ | + | |
- | * Images : ../ | + | |
- | * Point Cloud : ../ | + | |
- | * Point Cloud Orthophotos : ../ | + | |
- | * Trajectory : ../ | + | |
- | ===== Run version 1 from Orbit 10.0 to 10.5 ===== | + | Mean terrain height. The value is used as a fall back value for the areas with missing DEM |
+ | * File : <Orbit Run>/ | ||
+ | * Parameter : '' | ||
+ | * Unit : meter | ||
+ | * Default value : 0 | ||
- | An Orbit run version 1 uses the “panorama_positions.ovf” file as central mobile mapping run resource file. | + | ==== Reference Direction ==== |
- | Structure | + | '' |
- | * Photo positions | + | Photo orientation offset (heading) between the reference north direction and the actual north flying axis. |
- | * Images | + | * File : <Orbit Run>/ |
- | * Point Cloud : point_cloud.ovt | + | * Parameter |
+ | * Unit : degrees | ||
+ | * default value : 0° | ||
+ | * Positive rotation : clockwise | ||
+ | |||
+ | 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). | ||
+ | * File : <Orbit Run>/orbit_oblique.oop | ||
+ | * Parameter : '' | ||
+ | * Unit : degrees | ||
+ | * Default value : 10° | ||
+ | * Positive rotation : not applicable as this is an absolute value | ||
+ | |||
+ | ==== OrbitPhotoId Unique Image ID==== | ||
+ | |||
+ | The OrbitPhotoId must be a unique image id for the entire Mapping Run. \\ | ||
+ | Attention required if one run has multiple planar cameras having | ||
+ | If needed use the " | ||
+ | |||
+ | ==== Timestamp Offset==== | ||
+ | |||
+ | Convert timestamp values from GPS Week Seconds to Absolute GPS Time and vice versa for Trajectory, Photo Positions and Point Cloud data. \\ | ||
+ | The offset between GPS Week Seconds to Absolute GPS Time. The value can be negative or positive. \\ | ||
+ | At " | ||
+ | |||
+ | === Trigger user to enter time offset at Create Run === | ||
+ | |||
+ | * File: <Orbit Run>/orbit_mapping_run.omr (or orbit_mm_run.omr) \\ < | ||
+ | |||
+ | === Template Tag to be replaced by user-entered offset value === | ||
+ | |||
+ | Photo Positions | ||
+ | * File: <Orbit Run>/< | ||
+ | AttributeName=OrbitTimestamp | ||
+ | AttributeType=FLOAT8 | ||
+ | AttributeExpression=Add({PARAM_TIMESTAMP_OFFSET}, | ||
+ | |||
+ | Trajectory | ||
+ | * File: <Orbit Run>/ | ||
+ | AttributeName=OrbitTimestamp | ||
+ | AttributeType=FLOAT8 | ||
+ | AttributeExpression=Add({PARAM_TIMESTAMP_OFFSET}, | ||
+ | |||
+ | Point Cloud | ||
+ | * File: <Orbit Run>/ | ||
+ | |||
+ | ==== 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>/ | ||
+ | * Parameter : '' | ||
+ | * Values : image folder | ||
+ | |||
+ | === Example === | ||
+ | |||
+ | < | ||
+ | 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 | ||
+ | </ | ||
+ | ====== 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" | ||
- | 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 ../ | + | ^ What ^ Description ^ Data type ^ Units ^ Necessity |
+ | | Video Filename | ||
+ | | Video Time | The time offset from the start of the video. | ||
+ |
Last modified:: 2018/06/21 08:13