Returns the names of known cameras

Read a cameras.csv file

uas_cameras(names_only = TRUE)

uas_readcameras(cameras_fn)

Arguments

names_only

Return only camera names

cameras_fn

The file name (including path) of a cameras.csv file

Value

A character vector containing the names of cameras known to the uasimg package

Details

In order to estimate the GSD and image footprint, certain properties of the camera are required, including the focal length and physical dimension of the CCD sensor. Properties of several commonly used cameras have been collected and are bundled with the package as a csv file.

If your drone camera is not in the database, you can still index your images uas_info, however generic camera settings (EXIF fields) will be used. In most cases, these settings will work fine to get the GPS coordinates and timestamps, however it won't be able to model the on-the-ground image footprint.

To add your camera to the database, you can start an issue on GitHub, or contact the package author by email. Alternately, you can find the cameras.csv file in the package folder (run system.file("cameras/cameras.csv", package = "uasimg")), and add a row for your camera. Or copy the csv file and pass the file name as the value of cameras in uas_info.

This utility function will read a cameras.csv file. Note certain columns are required. To see an example of a valid CSV file, run uas_cameras(names_only = FALSE)

Functions

  • uas_readcameras(): Read cameras csv file

See also

Examples

if (FALSE) {
uas_cameras()
}

if (FALSE) {
uas_readcameras(system.file("cameras/cameras.csv", package="uasimg"))
}