Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
dev:technology:3d_mapping:supported_resources [2021/02/05 16:38] jeroen |
dev:technology:3d_mapping:supported_resources [2024/03/11 14:01] (current) glen [Video] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Supported Mapping Resources ====== | ====== Supported Mapping Resources ====== | ||
- | This page describes the supported Mobile Mapping, Aerial, and Oblique | + | This page documents all supported |
+ | To read more about concepts of a Mapping Run and Resource Groups, see [[dev: | ||
====== General Notes ====== | ====== General Notes ====== | ||
Line 64: | Line 66: | ||
===== Photo positions, orientations and metadata ===== | ===== Photo positions, orientations and metadata ===== | ||
- | The absolute position and orientations at time of recording | + | The absolute position and orientations at the time of recording |
Two possibilities : | Two possibilities : | ||
- | * absolute position and orientation for each camera at time of recording | + | * absolute position and orientation for each camera at the time of recording |
- | * combining the absolute position and orientation of a reference frame at time of recording with the fixed relative | + | * absolute position and orientation of a reference frame at the time of recording |
=== Absolute positions and orientations === | === Absolute positions and orientations === | ||
- | **Supported formats** \\ | + | === Supported formats |
Preferably .txt or .csv files. \\ | Preferably .txt or .csv files. \\ | ||
But any [[dev: | But any [[dev: | ||
- | **Specifications** | + | |
+ | === Specifications | ||
* One text file for each camera containing at least the below-described information for each image. | * One text file for each camera containing at least the below-described information for each image. | ||
* Column headers are optional and free of choice. | * Column headers are optional and free of choice. | ||
Line 86: | Line 91: | ||
* Origin (rotation = 0°) or rotation offset and positive sense of rotation of orientation angles can be customized. | * Origin (rotation = 0°) or rotation offset and positive sense of rotation of orientation angles can be customized. | ||
- | ** Attributes | + | === Attributes |
|< 100% 15% 55% 10% 10% 10% >| | |< 100% 15% 55% 10% 10% 10% >| | ||
^ Field ^ Description ^ Data type ^ Units ^ Necessity | ^ Field ^ Description ^ Data type ^ Units ^ Necessity | ||
Line 120: | Line 126: | ||
^ Field ^ Description ^ Data type ^ Units ^ Necessity | ^ Field ^ Description ^ Data type ^ Units ^ Necessity | ||
| CameraName| Unique name to identify the camera and to link these camera specifications with the position and orientation file. | string | | CameraName| Unique name to identify the camera and to link these camera specifications with the position and orientation file. | string | ||
- | | CameraDeltaX | Fix distance in X expressed in meters from the origin of the camera reference frame \\ to the IMU/GPS reference frame. | decimal | + | | CameraDeltaX | Fix distance in X expressed in meters from the origin of the camera reference frame \\ to the IMU/GPS reference frame. | decimal |
| CameraDeltaY | Fix distance in Y expressed in meters from the origin of the camera reference frame \\ to the IMU/GPS reference frame. | ::: | ::: | ::: | | | CameraDeltaY | Fix distance in Y expressed in meters from the origin of the camera reference frame \\ to the IMU/GPS reference frame. | ::: | ::: | ::: | | ||
| CameraDeltaZ | Fix distance in Z expressed in meters from the origin of the camera reference frame \\ to the IMU/GPS reference frame. | ::: | ::: | ::: | | | CameraDeltaZ | Fix distance in Z expressed in meters from the origin of the camera reference frame \\ to the IMU/GPS reference frame. | ::: | ::: | ::: | | ||
|< 100% 15% 55% 10% 10% 10% >| | |< 100% 15% 55% 10% 10% 10% >| | ||
- | | CameraDeltaPan | Fix Pan of camera reference frame to IMU/GPS reference frame. \\ Positive for clockwise rotation of camera frame. | decimal | + | | CameraDeltaPan | Fix Pan of camera reference frame to IMU/GPS reference frame. \\ Positive for clockwise rotation of camera frame. | decimal |
| CameraDeltaTilt | Fix tilt of camera reference frame to IMU/GPS reference frame. \\ Positive when camera frame goes up / looking up. | ::: | ::: | ::: | | | CameraDeltaTilt | Fix tilt of camera reference frame to IMU/GPS reference frame. \\ Positive when camera frame goes up / looking up. | ::: | ::: | ::: | | ||
| CameraDeltaRoll | Fix roll of camera reference frame to IMU/GPS reference frame. \\ Positive when camera reference frame rolls to the left. | ::: | ::: | ::: | | | CameraDeltaRoll | Fix roll of camera reference frame to IMU/GPS reference frame. \\ Positive when camera reference frame rolls to the left. | ::: | ::: | ::: | | ||
Line 149: | Line 155: | ||
===== Spherical images ===== | ===== Spherical images ===== | ||
- | **Supported formats** \\ | + | === Supported formats |
Preferably .jpg files. \\ | Preferably .jpg files. \\ | ||
But any [[dev: | But any [[dev: | ||
- | **Supported types** \\ | + | === Supported types === |
Orbit supports any Spherical and Cubic Panorama, independently of file size or pixel resolution. \\ | Orbit supports any Spherical and Cubic Panorama, independently of file size or pixel resolution. \\ | ||
For example, Ladybug 3 and 5 are supported. | For example, Ladybug 3 and 5 are supported. | ||
Line 181: | Line 188: | ||
One camera import requires one set of images and one position and orientation file. | One camera import requires one set of images and one position and orientation file. | ||
- | **Supported formats** \\ | + | === Supported formats |
Preferably .jpg files. But any [[dev: | Preferably .jpg files. But any [[dev: | ||
- | **Supported types** \\ | + | === Supported types === |
- | Orbit supports any distorted Planar picture, independently of file size or pixel resolution. \\ | + | |
+ | Any size, any resolution. \\ | ||
+ | Preferably undistorted images, see Lens distortion. | ||
=== Camera calibration === | === Camera calibration === | ||
Line 192: | Line 202: | ||
|< 100% 10% 60% 10% 10% 10% >| | |< 100% 10% 60% 10% 10% 10% >| | ||
- | ^ Field ^ Description ^ Data type ^ Units ^ Necessity | + | ^ What ^ Description ^ Data type ^ Units ^ Necessity |
| CameraName | Unique name to identify the camera and to link these camera specifications with the position and orientation file. | string | | CameraName | Unique name to identify the camera and to link these camera specifications with the position and orientation file. | string | ||
| SensorName | Reference of sensor to have the possibility to review the sensor specifications. | string | | SensorName | Reference of sensor to have the possibility to review the sensor specifications. | string | ||
Line 201: | Line 211: | ||
| SensorPixelPPY | The principal point value along the sensor height. | ::: | ::: | ::: | | | SensorPixelPPY | The principal point value along the sensor height. | ::: | ::: | ::: | | ||
| FocalLength | The focal length of the lens, expressed in mm. \\ [[http:// | | FocalLength | The focal length of the lens, expressed in mm. \\ [[http:// | ||
- | | k1, k2, k3, p1, p2 | Radial distortion parameters, regarding the formulas of D.C. Brown. \\ [[http:// | + | |
+ | === Lens Distortion === | ||
+ | |||
+ | The use of undistorted planar images is preferred. \\ | ||
+ | When providing distorted images, lens distortion parameters must be provided corresponding to Brown implementation of OpenCV model. | ||
+ | |||
+ | |< 100% 10% 60% 10% 10% 10% >| | ||
+ | ^ What ^ Description ^ Data type ^ Units ^ Necessity | ||
+ | | k1, | ||
=== Street Level\Indoor === | === Street Level\Indoor === | ||
+ | |||
{{orbitgis_extensions_mi: | {{orbitgis_extensions_mi: | ||
=== Oblique === | === Oblique === | ||
+ | |||
{{: | {{: | ||
=== Nadir === | === Nadir === | ||
{{: | {{: | ||
- | |||
====== Point Cloud ====== | ====== Point Cloud ====== | ||
Line 218: | Line 237: | ||
There are no limitations on the number of points, files, or the total size. | There are no limitations on the number of points, files, or the total size. | ||
- | **Required for** | + | === Required for === |
* Mobile Mapping: Recommended | * Mobile Mapping: Recommended | ||
* Oblique Mapping: Optional | * Oblique Mapping: Optional | ||
* Aerial Mapping: Strongly recommended | * Aerial Mapping: Strongly recommended | ||
- | **Supported formats** | + | === Supported formats |
* One or more supported point cloud resources, see [[dev: | * One or more supported point cloud resources, see [[dev: | ||
* Preferred: *.las files. | * Preferred: *.las files. | ||
- | **Additional Notes for ASCII text files** \\ | + | === Additional Notes for ASCII text files === |
When using an Ascii text file as point cloud import it is possible to configure the data-structure: | When using an Ascii text file as point cloud import it is possible to configure the data-structure: | ||
* Flat ASCII text file, separated, columns and column headers | * Flat ASCII text file, separated, columns and column headers | ||
- | * R, G, B, I value ranges 0-25, values may be empty | + | * R, G, B, I value ranges 0-255, values may be empty |
* Character to define end of line | * Character to define end of line | ||
Line 239: | Line 259: | ||
[[http:// | [[http:// | ||
- | **Required for** | + | === Required for === |
* Mobile Mapping: Optional | * Mobile Mapping: Optional | ||
* Oblique Mapping: Recommended | * Oblique Mapping: Recommended | ||
* Aerial Mapping: Optional | * Aerial Mapping: Optional | ||
- | **Supported formats** | + | === Supported formats |
* One or more supported raster resources, see [[dev: | * One or more supported raster resources, see [[dev: | ||
* Preferred: single raster GeoTIFF file. | * Preferred: single raster GeoTIFF file. | ||
- | **Notes** | + | === Notes=== |
* CRS: Any [[dev: | * CRS: Any [[dev: | ||
Line 256: | Line 279: | ||
Use the [[dev: | Use the [[dev: | ||
- | + | ====== | |
- | ====== | + | |
An Orthophoto covering the same area as the Mapping Resources can be used. | An Orthophoto covering the same area as the Mapping Resources can be used. | ||
Any [[dev: | Any [[dev: | ||
+ | ====== Image Annotations ====== | ||
+ | |||
+ | Image annotation xml files are linked to the Mapping Resource images by filename. | ||
+ | |||
+ | ==== Supported formats ===== | ||
+ | |||
+ | One csv or xml annoation file with annotations for all imagery. | ||
+ | Once xml annotation file per image. | ||
+ | |||
+ | === Generic === | ||
+ | |||
+ | < | ||
+ | <?xml version=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Context Insight === | ||
+ | |||
+ | Version 2.0 | ||
+ | |||
+ | < | ||
+ | <?xml version=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | Version 1.0 | ||
+ | |||
+ | < | ||
+ | <?xml version=" | ||
+ | <Scene version=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <Shot id=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | <Shot id=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ====== 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. | ||
+ | Video Attributes | ||
+ | * File Example: <Orbit Run>/ | ||
+ | AttributeName=OrbitVideoTime | ||
+ | AttributeType=INT4 | ||
+ | AttributeExpression=[Imported Value] | ||
+ | | ||
+ | AttributeName=OrbitVideoFileName | ||
+ | AttributeType=STRING | ||
+ | AttributeExpression=[Imported Value]</ | ||
====== References and Geodata ====== | ====== References and Geodata ====== | ||
Any [[dev: | Any [[dev: |
Last modified:: 2021/02/05 16:38