====== Vexcel Osprey ======

This page describes the original Vexcel UltraCam Osprey oblique mapping resources for Orbit import. ^\\
The template is created based on an export from UltraMap Aerial v5.3.3 (Build 35.4.2111.2501).

Use the corresponding [[234:desktop_ext:mapping:manage_import:templates|Orbit Import Template]] to import the described original data. \\
It is recommend to read first [[234:technology:3d_mapping:about_resources|]].

===== Imagery =====

Oblique images only.

=== Image files ===

  * Files : *.tif files, each oblique image is one tif image file.
  * Naming: [Nr] from Photo Position File + [Filename Suffix] to be specified at Import Run. E.g. "12-Oblique-Left.tif"

^ Vexcel Camera ^ Vexcel Camera Description ^ Orbit Planar ^
| Cam 2 | Oblique-Left | Planar 1 |
| Cam 3 | Oblique-Right | Planar 2 |
| Cam 4 | Oblique-Forward | Planar 3 |
| Cam 5 | Oblique-Backward | Planar 4 |

=== Image positions and orientations files ===

  * File: one *.csv or *.txt file for each camera
  * Structure: Flat ASCII text file
    * Rows: each image is one record
    * Columns: semicolumn separated (char59), headers, with exact order as the example below.
  * Structure of file name: Exactly as the result of "Concat([Nr],[Filename_Suffix])" from the example below.
  * Crs: Any [[180:technology:core:crs|supported projected coordinate system]] can be used, but all imported oblique resources should have the same CRS.

Example, Vexcel Camera 2 - Orbit Planar 1
<code>
# Camera; Session;       Nr;               X;               Y;               Z;       Rot_X;       Rot_Y;       Rot_Z;
       2;       0;        2;     534869.7931;    5210390.6028;       1467.1287;    -0.74251;    44.88090;  -179.46759;
       2;       0;        3;     534869.9492;    5210525.5136;       1466.1108;    -0.80358;    44.81863;  -179.35610;
       2;       0;        4;     534868.8679;    5210660.4961;       1465.1806;    -0.33185;    44.82729;  -179.89512;
...
</code>

Example, Vexcel Camera 3 - Orbit Planar 2
<code>
# Camera; Session;       Nr;               X;               Y;               Z;       Rot_X;       Rot_Y;       Rot_Z;
       3;       0;        2;     534869.2991;    5210390.7529;       1467.1336;     0.57260;   -45.06517;  -179.30631;
       3;       0;        3;     534869.4549;    5210525.6627;       1466.1153;     0.68402;   -45.12528;  -179.24513;
       3;       0;        4;     534868.3755;    5210660.6513;       1465.1850;     0.14545;   -45.12537;  -179.71736;
...
</code>

Example, Vexcel Camera 4 - Orbit Planar 3
<code>
# Camera; Session;       Nr;               X;               Y;               Z;       Rot_X;       Rot_Y;       Rot_Z;
       4;       0;        2;     534869.5341;    5210390.4534;       1467.2576;    44.85803;     0.81872;  -178.71914;
       4;       0;        3;     534869.6904;    5210525.3637;       1466.2394;    44.89154;     0.88002;  -178.54612;
       4;       0;        4;     534868.6072;    5210660.3495;       1465.3093;    44.85275;     0.17130;  -179.555
...
</code>

Example, Vexcel Camera 5 - Orbit Planar 4
<code>
# Camera; Session;       Nr;               X;               Y;               Z;       Rot_X;       Rot_Y;       Rot_Z;
       5;       0;        2;     534869.5305;    5210390.8848;       1467.2593;   -45.07121;    -0.94160;  -178.68583;
       5;       0;        3;     534869.6859;    5210525.7950;       1466.2414;   -45.03369;    -1.12404;  -178.51392;
       5;       0;        4;     534868.6081;    5210660.7808;       1465.3109;   -45.08857;    -0.40501;  -179.52499;
...
</code>

=== Camera calibrations ===

Example for a camera

<code>
Pixel_Size_mm = 0.00600
Principal_Distance = 123.009695
PPA_X = 6.842097
PPA_Y = 0.014417
Image_Width_mm = 53.40000
Image_Height_mm = 39.90000
</code>

===== DEM =====

=== Raster file ===

  * File : one *.tif file with corresponding *.tfw
  * Naming : free of choice
  * Crs : Any supported projected coordinate system can be used, but all imported oblique resources should have the same crs.