Implementation in R of a pipeline that performs the Time-SIFT process to time series of drone images using the Metashape python API. All photos are loaded and aligned, then orthomosaics and (optionally) DEMs will be generated for each date or flight.
Usage
generate_Mosa(
path_in,
out_dir_ortho,
out_dir_DEM = NULL,
out_dir_project = NULL,
data_type = "RGB",
resol_ref = 0.05,
crs = "EPSG::32622",
site_name = "",
calibrate_col = TRUE,
sun_sensor = FALSE,
group_by_flight = FALSE,
from_mesh = FALSE,
downscale_factor_alignement = 1L,
downscale_factor_depth_map = 2L,
suffix = "_"
)Arguments
- path_in
character. Path to the folder where the data is located. Inside this folder, any structure of subfolders containing images is accepted, as long as the date is specified in the folders' name in YYYYMMDD/YYYYMM format. This date is what will be used later to distinct which image belongs to which date when building orthomosaics.
- out_dir_ortho
character. Folder where the orthomosaics are saved.
- out_dir_DEM
character. Folder where the DEMs are saved. If no path is specified, the DEMs are not saved by default.
- out_dir_project
character. Folder where the Metashape project is saved. If no path is specified, the project is not saved by default.
- data_type
character. The type of the data used. Either 'RGB' (default) or 'MS' (for multispectral images).
- resol_ref
numeric. The resolution (in meters) used to generate DEMs and orthomosaics. Defaults to 0.05.
- crs
character. Coordinate system used for the orthomosaic, in a string format. Example: crs="EPSG::32622" (default value).
- site_name
character. Adds the data site name into the names of all created folders and files, to better separate generated data from different projects. If not specified, the names will stay generic.
- calibrate_col
logical. Applies white balance.
- sun_sensor
logical. Calibrates the reflectance using the sun sensor. Only applies to multispectral images.
- group_by_flight
logical. Regroups data by flight (i.e. one orthomosaic for each subfolder of the input folder containing images). If FALSE, regroups it by date (default).
- from_mesh
logiclal. Generates the orthomosaics based on the mesh model rather than the DEM. In this case, the DEM will not be created.
- downscale_factor_alignement
integer. Alignment accuracy (0 - Highest, 1 - High, 2 - Medium, 4 - Low, 8 - Lowest). Defaults to 1.
- downscale_factor_depth_map
integer. Depth map quality (1 - Ultra high, 2 - High, 4 - Medium, 8 - Low, 16 - Lowest). Defaults to 2.
- suffix
character. Text to add at the end of the output filenames.
Examples
if (FALSE) { # \dontrun{
library(reticulate)
generate_Mosa(path_in = "path_to_my_drone_data",
out_dir_ortho = "my_output_folder/ORTHO",
#out_dir_DEM = "my_output_folder/DEM",
data_type = "RGB",
resol_ref = 0.5,
site_name = "Bouamir",
crs = "EPSG::32633"
)
generate_Mosa(path_in = "path_to_my_drone_data",
out_dir_ortho = "my_output_folder/ORTHO",
#out_dir_DEM = "my_output_folder/DEM",
data_type = "MS",
sun_sensor = TRUE,
crs = "EPSG::32622",
downscale_factor_depth_map = 4,
group_by_flight = TRUE,
suffix = "_ORTHO"
)
} # }