Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
dev:desktop_ext:mapping:manage:runs_version [2018/02/13 14:04] natalia.zheltukhina@orbitgt.com [Configurations for Mapping Runs Only] |
dev:desktop_ext:mapping:manage:runs_version [2024/03/06 18:55] (current) glen [Mapping Run Configurations] |
||
---|---|---|---|
Line 4: | Line 4: | ||
It is strongly recommended to read first | It is strongly recommended to read first | ||
- | * [[technology: | + | * [[dev:technology:3d_mapping: |
- | * [[technology: | + | * [[dev:technology:3d_mapping:about_resources_oblique|]] |
===== Concepts ===== | ===== Concepts ===== | ||
Line 11: | Line 11: | ||
=== Import Templates === | === 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 " | + | 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 " |
- | Some additional configurations can be added or updated after import, so called " | + | Some additional configurations can be added or updated after import, so-called " |
=== Backwards compatibility and New Features === | === 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. \\ | + | Orbit is constantly improving tools and software which may result in an update of the files and structure of a Mapping Run. \\ |
- | Backwards | + | Backward |
- | An Orbit Run version 3 uses the “orbit_mm_run.omr” file as reference resource file. \\ | + | An Orbit Run version 3 uses the "orbit_mm_run.omr" |
- | An Orbit Oblique Project version 3 uses the “orbit_oblique.oop” file as reference resource file. \\ | + | 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 [[180:products:3dm_content_manager|]] and 3D Mapping Cloud. | + | 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: | For previous version or to convert existing runs\projects into the updated structure, see [[110: | ||
- | === Mapping Run Version 3 === | + | ===== |
- | The current structure is in place since Orbit version 11.0. \\ | + | Configurations to be added into the .omr Mapping Resource root file. \\ |
- | Structure updates compared to run version 2 : | + | Edit and save the configuration files using a standard text editor (e.g. Notepad), respect file formatting and structure. |
- | * Point Cloud : ../ | + | |
- | * Trajectory : ../ | + | |
- | * Simplified Trajectory : ../ | + | |
- | * Trajectory Adjustments : ../ | + | |
- | ===== Configurations for Mapping\UAS Runs and Oblique Projects ===== | + | ==== Parameters editable at Create Run ==== |
- | Add/edit and save the listed files using a standard text editor (e.g. Notepad), respect file formatting | + | 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**: | ||
- | === Redirect image file directory === | + | < |
+ | Example: | ||
+ | template.parameters.planar1=SensorSizePIXX; | ||
+ | template.parameters.planar2=SensorSizePIXX; | ||
+ | </ | ||
+ | Parameters will be read into corresponding {name_of_the_parameter} variable. | ||
+ | |||
+ | ==== Source and Target CRS ==== | ||
+ | |||
+ | 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**: | ||
+ | * Target projection system - **PARAM_CRS2**: | ||
+ | <note important> | ||
+ | |||
+ | ==== Images file extension ==== | ||
+ | |||
+ | The used image storage format of original images (panorama or planar). | ||
+ | |||
+ | * File : <Orbit Run>/ | ||
+ | * Parameter : '' | ||
+ | * Values : Any supported image resource can be used, see [[dev: | ||
+ | * Default Value : .jpg | ||
+ | |||
+ | === Example === | ||
+ | |||
+ | < | ||
+ | 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 | ||
+ | </ | ||
+ | |||
+ | ==== 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. | 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. | ||
Line 50: | Line 83: | ||
</ | </ | ||
- | === Original image file extension | + | ==== Camera Height ==== |
- | Used image storage format | + | Height |
- | * File : <Orbit Run>/ | + | * File : <Orbit Run>/ |
- | * Parameter : '' | + | |
- | * Values : Any supported image resource can be used, see [[technology: | + | |
- | * 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: | + | |
- | + | ||
- | * File : <Orbit Run>/orbit_mm_run.omr (orbit_oblique.oop | + | |
* Parameter : '' | * Parameter : '' | ||
* Default Value : 2.2 | * Default Value : 2.2 | ||
* Unit : meters | * Unit : meters | ||
+ | ==== 2D Vector Visualization Parameters ==== | ||
- | === 2D Vector Visualization Parameters === | + | The possible |
- | + | ||
- | Possible | + | |
+ | * File : <Orbit Run>/ | ||
* Parameters : \\ '' | * Parameters : \\ '' | ||
* Default value : 5 | * Default value : 5 | ||
Line 78: | Line 102: | ||
Mostly need to be changed for UAS Runs depending on the flying height. | Mostly need to be changed for UAS Runs depending on the flying height. | ||
- | ===== Configurations for Mapping Runs Only ===== | ||
- | === Simplified Trajectory === | + | ==== 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. | + | 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 previous and next coordinate is larger than maximum.distance. | + | Coordinate will be added if its perpendicular drop distance to the segment between |
+ | * File : <Orbit Run>/ | ||
* Parameter : '' | * Parameter : '' | ||
* Values : Integer value | * Values : Integer value | ||
Line 91: | Line 115: | ||
Two consecutive original coordinates won't be connected if segment length is larger than part.separation. | Two consecutive original coordinates won't be connected if segment length is larger than part.separation. | ||
+ | * File : <Orbit Run>/ | ||
* Parameter : '' | * Parameter : '' | ||
* Values : Integer value | * Values : Integer value | ||
Line 96: | Line 121: | ||
* Default Value : 10 | * Default Value : 10 | ||
- | Initial | + | The initial |
+ | * File : <Orbit Run>/ | ||
* Parameter : '' | * Parameter : '' | ||
* Values : Any photo position attribute, a combination of attributes can be used, e.g. OrbitTimeStamp+ObjectId. | * Values : Any photo position attribute, a combination of attributes can be used, e.g. OrbitTimeStamp+ObjectId. | ||
* Default Value : OrbitPhotoId | * 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 === | ||
Line 114: | Line 147: | ||
</ | </ | ||
- | ===== Configurations for Oblique Projects Only ===== | + | 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' | ||
- | === orbit_oblique.oop | + | ==== Reference Height ==== |
- | '' | ||
Mean terrain height. The value is used as a fall back value for the areas with missing DEM | Mean terrain height. The value is used as a fall back value for the areas with missing DEM | ||
+ | * File : <Orbit Run>/ | ||
+ | * Parameter : '' | ||
* Unit : meter | * Unit : meter | ||
- | * Default value : na | + | * Default value : 0 |
- | '' | + | ==== Reference Direction ==== |
+ | |||
+ | '' | ||
Photo orientation offset (heading) between the reference north direction and the actual north flying axis. | Photo orientation offset (heading) between the reference north direction and the actual north flying axis. | ||
+ | * File : <Orbit Run>/ | ||
+ | * Parameter : '' | ||
* Unit : degrees | * Unit : degrees | ||
* default value : 0° | * default value : 0° | ||
* Positive rotation : clockwise | * Positive rotation : clockwise | ||
- | '' | + | Photo orientation maximal deviation (heading) from the reference directions. |
- | Photo orientation maximal deviation (heading) from the corrected | + | * File : <Orbit Run>/ |
+ | * Parameter : '' | ||
* Unit : degrees | * Unit : degrees | ||
* Default value : 10° | * Default value : 10° | ||
* Positive rotation : not applicable as this is an absolute value | * 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 images with the same filename. Ensure the OrbitPhotoId value to be unique for all images of the entire Mapping Run. \\ | ||
+ | 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>/ | ||
+ | |||
+ | === 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=== | ||
+ | |||
+ | Preferably .mp4 files. \\ | ||
+ | When using cloud blob storage, the storage needs to support "range requests" | ||
+ | ===Attributes=== | ||
+ | |< 100% 10% 60% 10% 10% 10% >| | ||
+ | ^ 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