Tool Colorisation (PC)
This tool attaches the color information from a RGB image to Laser Points.
The RGB Image and the Point Cloud to be colorised are the inputs along with the interior and exterior orientation parameters of the camera. The necessary interior orientation parameters are Focal Length (mm), Pixel Size (um), Principal Point Offsets (pixels) and optionally the Radial Distortion Parameters. The distortion model being used is as follows:
x_d = x_u (1 - dR)
y_d = y_u (1 - dR)
where, dR = K1 * r_u ^ 2 + K2 * r_u ^ 4 + K3 * r_u ^ 6,
r_u ^ 2 = x_u ^ 2 + y_u ^ 2,
x_u, y_u are the undistorted (corrected) image coordinates in mm,
x_d, y_d are the distorted (observed) image coordinates in mm,
K1 is in [mm ^ -2], K2 is in [mm ^ -4], K3 is in [mm ^ -6].
The necessary exterior orientation parameters are the coordinates of the Projection Center and the Cardan angles Omega, Kappa and Alpha. The Cardan angles refer to the following transformation between image coordinates (x_image) and global coordinates (X_Global):
x_image = R_1(omega) * R_2(kappa) * R_3(alpha) * X_Global
[Optional] If the Time Stamp of the RGB Image is given, an acceptable time difference between the points and the image must provided in order to colorise only those points falling that range. If no time is given all points are colorised.
The result is a colorised point cloud.
- Author: HfT Stuttgart (c) 2013
- Menu: Imagery|Photogrammetry
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Input | RGB Image | Grid (input) | rgbImage | RGB Image | - |
| Points to be Colorised | Point Cloud (input) | PC_IN | Points to be Colorised | - |
| Output | Colorised Point Cloud | Point Cloud (output) | PC_OUT | Colorised Point Cloud | - |
| Options | Grid system | Grid system | rgbImage_GRIDSYSTEM | - | - |
| Provide Time stamp of Image? | Boolean | GIVE_TIME | Do you wish to provide the time stamp of Image? | Default: 0 |
| Time stamp of Image | Floating point | IMG_TIME | Time stamp of Image | Default: 0.000000 |
| Time Difference between Image & Points | Floating point | TIME_DIFF | Acceptable Time Difference between Image and Laser Points | Default: 0.000000 |
| Focal Length (mm) | Floating point | F | Focal Length in mm | Default: 0.000000 |
| Pixel Width (um) | Floating point | W | Pixel Width in micro meters | Default: 0.000000 |
| Principal Point Offset in X (pixles) | Floating point | ppX | Principal Point Offset in X | Default: 0.000000 |
| Principal Point Offset in Y (pixels) | Floating point | ppY | Principal Point Offset in Y | Default: 0.000000 |
| Provide Radial Distortion Parameters? | Boolean | GIVE_DISTORTIONS | Do you wish to provide the Radial Distortion Parameters? | Default: 0 |
| K1 | Floating point | K1 | K1 | Default: 0.000000 |
| K2 | Floating point | K2 | K2 | Default: 0.000000 |
| K3 | Floating point | K3 | K3 | Default: 0.000000 |
| Projection Centre - X | Floating point | Xc | Projection Centre | Default: 0.000000 |
| Projection Centre - Y | Floating point | Yc | Projection Centre | Default: 0.000000 |
| Projection Centre - Z | Floating point | Zc | Projection Centre | Default: 0.000000 |
| Omega | Floating point | omega | Rotation Angle | Default: 0.000000 |
| Kappa | Floating point | kappa | Rotation Angle | Default: 0.000000 |
| Alpha | Floating point | alpha | Rotation Angle | Default: 0.000000 |
Command-line
Usage: saga_cmd imagery_photogrammetry 1 [-rgbImage <str>] [-PC_IN <str>] [-GIVE_TIME <str>] [-IMG_TIME <double>] [-TIME_DIFF <double>] [-F <double>] [-W <double>] [-ppX <double>] [-ppY <double>] [-GIVE_DISTORTIONS <str>] [-K1 <double>] [-K2 <double>] [-K3 <double>] [-Xc <double>] [-Yc <double>] [-Zc <double>] [-omega <double>] [-kappa <double>] [-alpha <double>] [-PC_OUT <str>]
-rgbImage:<str> RGB Image
Grid (input)
-PC_IN:<str> Points to be Colorised
Point Cloud (input)
-GIVE_TIME:<str> Provide Time stamp of Image?
Boolean
Default: 0
-IMG_TIME:<double> Time stamp of Image
Floating point
Default: 0.000000
-TIME_DIFF:<double> Time Difference between Image & Points
Floating point
Default: 0.000000
-F:<double> Focal Length (mm)
Floating point
Default: 0.000000
-W:<double> Pixel Width (um)
Floating point
Default: 0.000000
-ppX:<double> Principal Point Offset in X (pixles)
Floating point
Default: 0.000000
-ppY:<double> Principal Point Offset in Y (pixels)
Floating point
Default: 0.000000
-GIVE_DISTORTIONS:<str> Provide Radial Distortion Parameters?
Boolean
Default: 0
-K1:<double> K1
Floating point
Default: 0.000000
-K2:<double> K2
Floating point
Default: 0.000000
-K3:<double> K3
Floating point
Default: 0.000000
-Xc:<double> Projection Centre - X
Floating point
Default: 0.000000
-Yc:<double> Projection Centre - Y
Floating point
Default: 0.000000
-Zc:<double> Projection Centre - Z
Floating point
Default: 0.000000
-omega:<double> Omega
Floating point
Default: 0.000000
-kappa:<double> Kappa
Floating point
Default: 0.000000
-alpha:<double> Alpha
Floating point
Default: 0.000000
-PC_OUT:<str> Colorised Point Cloud
Point Cloud (output)