uavimg_info: Extract info from UAV Images

Description Usage Arguments Details Value See Also

View source: R/uavimg_info.R

Description

Extracts info from geotagged images taken from a drone

Usage

1
2
uavimg_info(img_dirs, exiftool = NULL, csv = NULL, alt_agl = NULL,
  fwd_overlap = TRUE, cameras = NULL, quiet = FALSE)

Arguments

img_dirs

Directory(s) where the image files reside

exiftool

The path to the exiftool command line tool (omit if on the OS path)

csv

The file name of a new csv file where the exif data will be saved (omit to make a temp one)

alt_agl

The elevation above ground level in meters (optional for images with the relevative altitude saved)

fwd_overlap

Whether or not to compute the amount of overlap between one image and the next, T/F

cameras

Location of the cameras.csv file. Is NULL the package csv file will be used.

quiet

Don't show messages

Details

This will read the EXIF header data from a directory of image files, and put out the centroids and image footprints on the ground. Mapping image locations requires that the images have geostamps. In addition, mapping the image footprints requires that the camera parameters are known, and the flight elevation about ground level is either saved in the EXIF info, or provided in the alt_agl argument (in meters). If alt_agl is passed, it will override any elevation data in the EXIF info.

Camera parameters are saved in a csv file called cameras.csv. To see where this is saved, type system.file("cameras/cameras.csv", package="uavimg"). If your camera is not detected, please contact the package author or create an issue on GitHub.

This function uses a free command line tool called EXIFtool to read the EXIF data, which can be downloaded from http://www.sno.phy.queensu.ca/~phil/exiftool/. After you download it, rename the executable file, 'exiftool(-k).exe' to 'exiftool.exe', and save it somewhere on your system's PATH (e.g., c:\Windows).

Value

A named list with three elements: 1) SpatialPointsDataFrame with the image centroids, and 2) a SpatialPolygonsDataFrame of the image footprints, and 3) the image directory. An HTML report of the images can be created with uavimg_report.

See Also

uavimg_report, uavimg_exp


UCANR-IGIS/uavimg documentation built on July 13, 2020, 9:35 p.m.