uavRmp (version 0.5)

makeAP: UAV Mission Planning tool for autonomous monitoring flight tasks with respect to DSM/DEM, orthophoto data retrieval.

Description

The basic idea is to provide an easy to use workflow for controlling rtf-UAVs for planning autonomous surveys to retrieve aerial data sets.

Usage

makeAP(projectDir = "~", locationName = "flightArea", surveyArea = NULL,
  flightAltitude = 100, launchAltitude = NULL, followSurface = FALSE,
  followSurfaceRes = NULL, demFn = NULL, altFilter = 1,
  horizonFilter = 30, terrainSmooth = FALSE, flightPlanMode = "track",
  presetFlightTask = "remote", overlap = 0.8, maxSpeed = 20,
  maxFlightTime = 10, picRate = 2, windCondition = 0, uavType = "solo",
  cameraType = "MAPIR2", cmd = 16, uavViewDir = 0, djiBasic = c(0, 0, 0,
  -90, 0), dA = FALSE, heatMap = FALSE, picFootprint = FALSE,
  rcRange = NULL, copy = FALSE)

Arguments

projectDir

character path to the main folder where several locations can be hosted, default is "~"

locationName

character path to the location folder where all tasks of this plot are hosted, default is "flightArea"

surveyArea

you may provide either the coordinates by c(lon1,lat1,lon2,lat2,lon3,lat3,launchLat,launchLon) or an OGR compatible file (prefunable to find an inherited method for function <U+2018>makeAP<U+2019> for signature <U+2018>"missing"<U+2019>erably geoJSON or KML) with at least 4 coordinates that describe the flight area. The fourth coordinate is the launch position. You will find further explanation under seealso.

flightAltitude

set the default flight altitude of the mission. It is assumed that the UAV is started at the highest point of the surveyArea otherwise you have to defined the position of launching.

launchAltitude

absolute altitude of launching position. It will overwrite the DEM based estimation if any other value than -9999

followSurface

boolean TRUE performs an altitude correction of the mission's flight altitude using additional DEM data. If no DEM data is provided and followSurface is TRUE, SRTM data will be downloaded and used. Further explanation at seealso

followSurfaceRes

horizontal step distance for analyzing the DEM altitudes

demFn

filename of the corresponding DEM data file.

altFilter

if followingTerrain is equal TRUE then altFilter is the threshold value of accepted altitude difference (m) between two way points. If this value is not exceeded, the way point is omitted due to the fact that only 99 way points per mission are allowed.

horizonFilter

integer filter size of the rolling filter kernel for the flight track. Must be multiplied by the followSurfaceRes to get the spatial extent

terrainSmooth

terrain smoothiiing switch

flightPlanMode

type of flight plan. Available are: "waypoints", "track", "manual".

presetFlightTask

(DJI only) strongly recommended to use "remote" Options are: "simple_ortho" takes one picture/way point, "multi_ortho" takes 4 picture at a waunable to find an inherited method for function <U+2018>makeAP<U+2019> for signature <U+2018>"missing"<U+2019>unable to find an inherited method for function <U+2018>makeAP<U+2019> for signature <U+2018>"missing"<U+2019>ypoint, two vertically down and two in forward and backward viewing direction and an Angele of -60deg, "simple_pano" takes a 360 deg panorama picture and "remote" which assumes that the camera is controlled by the remote control (RC)

overlap

overlapping of the pictures in percent (1.0 = 100)

maxSpeed

cruising speed

maxFlightTime

user defined estimation of the lipo lifetime (20 min default)

picRate

fastest stable interval (s) for shooting pictures

windCondition

1= calm 2= light air 1-5km/h, 3= light breeze 6-11km/h, 4=gentle breeze 12-19km/h 5= moderate breeze 20-28km/h

uavType

type of uav. currently "djip3" and "solo" are supported

cameraType

depending on uav system for dji the dji4k is default for solo you can choose GP3_7MP GP3_11MP and MAPIR2

cmd

mavlink command

uavViewDir

dview direction of uav

djiBasic

c(0,0,0,-90) curvesize (DJI only) controls the curve angle of the uav passing way points. By default it is set to (= 0.0). rotationdir (DJI only) camera control parameter set the UAV basic turn direction to right (0) or left (1) gimbalmode (DJI only) camera control parameter 0 deactivates the gimbal control 1 activates the gimbal for focusing POIs 2 activates the gimbal for focus and interpolate a field of view in an angel of gimbalpitchangle gimbalpitchangle (DJI only) vertical angle of camera +30 deg..-90 deg actiontype (DJI only) individual actionype settings of the camera c(1,1,...) actionparam (DJI only) corresponding parameter for the above individual actiontype c(0,0,...) uavViewDir viewing direction of camera default is 0

dA

if TRUE the real extent of the used DEM is returned helpful for low altitudes flight planning

heatMap

switch for calculating the overlapping factor on a raster map

picFootprint

switch for calculating the footprint at all way points

rcRange

range of estimated range of remote control

copy

copy switch

Warning

Take care! There are still a lot of construction zones around. This script is far beyond to be in a mature state. Please control and backup all controls again while planning and performing autonomous flight plans and missions. You will have a lot of chances to make a small mistake what may yield in a damage of your UAV or even worse in involving people, animals or non-cash assets. Check your risk, use parachute systems and even if it is running like a charm, keep alert!

Details

makeAP (Make UAV Remote Controlled Survey) creates either intermediate flight control files for the DJI phantom x UAVs or ready to upload control files for the 3DR Solo. The DJI control files are designed for using with the proprietary litchi flight control app exchange format, while the 3DR Solo files are using the MAVLINK common message set, that is used by the PixHawk flight controller family. Both are implemented very rudimentarily. DJI: The reason using DJI is their absolute straightforward usage. Everybody can fly with a DJI but the price is a hermetically closed system. Only the litchi app provides additionally to a cloud based mission planner an offline/standalone interface to upload a CSV formated way point file for autonomous flights to the Phantom. PixHawk/3DR Solo: The open uav community is focused on the PixHawk autopilot unit and the Mission Planner software. It is well documented and several APIs are provided. Nevertheless a terrain following autonomous flight planning tool is not available. makeAP creates static implementation of the MAV format that is ready to be uploaded directly on the Pixhawk controller using the solo_upload function.

See Also

The underlying concept, a tutorial and a field guid can be found in the package vignettes. See browseVignettes("uavRmp") or vignette(package = "uavRmp") or at Github uavRmp manual).

Examples

# NOT RUN {
# }
# NOT RUN {
# Depending on the arguments, the following spatial data sets can returned

# lp      the planned launching position of the UAV.
# wp      waypoints inclusive all information
# oDEM    the original (input) digital surface model (DSM)
# rDEM    the resampled (used) DSM
# fp      optimized footprints of the camera
# fA      flight area with at least 2 overlaps
# rcA     area covered by the RC according to the range and line of sight
# hm      a heatmap abundance of pictures/pixel (VERY SLOW, only if heatMap = TRUE)

## for visualisation and vecDraw load mapview
require(mapview)

## (1) get example DEM data
demFn <- system.file("extdata", "mrbiko.tif", package = "uavRmp")
tutorial_flightArea <- system.file("extdata", "flightarea.kml", package = "uavRmp")

## (2) simple flight, 50 meters above ground
##     assuming a flat topography,

fp <- makeAP(surveyArea = tutorial_flightArea,
              demFn = demFn)
              
## (3) typical real case scenario
##     a flight altitude BELOW 50 m is extreme
##     You have to use a high resulution DSM
##     (here simulated with a standard DEM)

fp <- makeAP(projectDir ="~/uav/test",
           locationName = "examples",
           surveyArea=tutorial_flightArea,
           followSurface = TRUE,
           flightAltitude = 90,
           demFn = demFn,
           windCondition = 1,
           uavType = "solo",
           followSurfaceRes = 5,
           altFilter = .75)

## (5) view results
mapview::mapview(fp3$wp,cex=4, lwd=0.5)+
mapview::mapview(fp3$lp,color = "red", lwd=1,cex=4)+
mapview::mapview(fp3$fA,color="blue", alpha.regions = 0.1,lwd=0.5)+
mapview::mapview(fp3$oDEM,col=terrain.colors(256))

## (4) digitize flight area using leafDraw()
##     save vectors as "kml" or "json" files
##     provide full filename +  extension!


vecDraw(preset="uav")

# }