Perform 3D displacement mapping from DEMs using raw BUnwarpJ transformation file

dem.displacement.mapping(tx_file, r_source, r_target, is_inverse = FALSE)

Arguments

tx_file

The raw transformation file (.txt) from BUnwarpJ.

r_source

The DEM raster filename used as source for image registration.

r_target

The DEM raster filename used as target for image registration.

is_inverse

(logical) TRUE if image registraiton performed in the inverse direction, otherwise FALSE.

Value

Returns a data frame containing the following columns:

x_source & y_source

x & y coordinates from a CRS for the registration

z_source

the elevation value (intensity) corresponding the source locations

x_target & y_target

x & y coordinates from a CRS representing the x & y transformation for every location in the source image

z_target

the elevation value (intensity) corresponding the target locations (from the target image /elevation model)

x_disp

x displacement of registered image (from source image)

y_disp

y displacement of registered image (from source image)

z_disp

z displacement of registered image (from source image) (z_target - z_source)

xy_disp

magnitude of the displacement in 2D (xy)

xyz_disp

magnitude of the displacement in 3D (xyz)

aspect

geographic orientation of vector direction with 0 degrees being due north and 90 degrees being due east

slope

angle in degrees of displacement in z direction