R/mland_checks.R

In multilandr: Landscape Analysis at Multiple Spatial Scales

# mland argument checking
.mland_chk_args <- function() {

  messages <- NULL
  what     <- NULL

  # Points
  if(!class(points_layer) %in% c("character", "SpatVector", "SpatialPointsDataFrame", "SpatialPoints")){
    messages <- append(messages,
                            "- argument 'points_layer' must be a filename (string) or an object of class
                       'SpatVector', 'SpatialPointsDataFrame' or 'SpatialPoints'.")
    what     <- append(what, 2)
  } else {
    if(!class(points_layer) %in% c("SpatVector", "SpatialPointsDataFrame", "SpatialPoints")){
      if(!file.exists(points_layer)){
        messages <- append(messages, paste("- could not find points layer file: ", points_layer, "."))
        what     <- append(what, 2)
      }
    }
  }

  # Rasters
  if(is.null(rast_layer) & is.null(ext_rast_layer)){
    messages <- append(messages, "- at least one rasterlayer must be specified in 'rast_layer'
                       and/or 'ext_rast_layer'.")
    what     <- append(what, 2)
  } else {
    # Raster
    chk_raster  <- .chk_raster(messages, what, rast_layer, arg_name = "rast_layer")
    messages    <- chk_raster[[1]]
    what        <- chk_raster[[2]]
    rast_layer  <- chk_raster[[3]]

    # Extra Raster
    chk_ext_raster <- .chk_raster(messages, what, ext_rast_layer, arg_name = "ext_rast_layer")
    messages       <- chk_ext_raster[[1]]
    what           <- chk_ext_raster[[2]]
    ext_rast_layer <- chk_ext_raster[[3]]
   }

  # On the fly
  if(!is.logical(on_the_fly)){
    messages <- append(messages, "- argument 'on_the_fly' must be logical.")
    what     <- append(what, 2)
  }

  # Class names
  if(!is.null(class_names)){
    if(is.list(class_names)){
      if(length(class_names) > 0){
        for(i in 1:length(class_names)){
          if(is.character(class_names[[i]])){
            cl <- seq(1, length(class_names[[i]]), 2)
            if((length(class_names[[i]]) %% 2) != 0 |
               !all(!is.na(suppressWarnings(as.numeric(class_names[[i]][cl]))))){
              messages   <- append(messages, "- argument 'class_names' was not defined properly. See ?mland.")
              what       <- append(what, 2)
              class_names <- list()
              break
            } else {
              if(!is.character(class_names[[i]])){
                messages    <- append(messages, "- argument 'class_names' must be a list with vector of
                                 strings in even elements. See ?mland")
                what        <- append(what, 2)
                class_names <- list()
                break
              }
            }
            if("landscape" %in% class_names[[i]]){
              messages    <- append(messages, "- the string \"landscape\" must be
              avoided to name a raster class. Please use another one.")
              what        <- append(what, 2)
              class_names <- list()
              break
            }
          } else {
            messages   <- append(messages, "- argument 'class_names' was not defined properly. See ?mland.")
            what       <- append(what, 2)
            class_names <- list()
            break
          }
        }
      }
    } else {
      messages    <- append(messages, "- argument 'class_names' must be a list. The argument was
                         ignored.")
      what        <- append(what, 1)
      class_names <- list()
    }
  } else { class_names <- list() }

  # Raster names
  if(!is.null(rast_names)){
    if(!is.character(rast_names)){
      messages   <- append("- argument 'rast_names' must be a character vector.
                           Argument was discarded.")
      what       <- append(what, 1)
      rast_names <- vector("character")
    } else {
      if(any(duplicated(rast_names))){
        messages   <- append("- argument 'rast_names' contains duplicated string. Raster layer
        names should be unique to avoid ambiguites. Argument was discarded.")
        what       <- append(what, 1)
        rast_names <- vector("character")
      } else {
        if(any(substr(rast_names, 1, 3) == "ext")){
          messages   <- append("- The names for the raster layers cannot start with the
          substring \"ext\".")
          what       <- append(what, 2)
          rast_names <- vector("character")
        }
      }
    }
  } else { rast_names <- vector("character") }

  # Site reference
  if(!is.null(site_ref)){
    if(!is.character(site_ref) | length(site_ref) > 1){
      messages   <- append(messages, "- argument 'site_ref' must be a string. The argument was
                           ignored.")
      what       <- append(what, 1)
      site_ref <- NULL
    }
  }

  # Radii
  if(!is.numeric(radii) | !all(radii > 0)){
    messages <- append(messages, "- argument 'radii' must be a vector of positive numbers.")
    what     <- append(what, 2)
  }

  # Type of buffer
  if(length(bufftype) > 1 | !is.character(bufftype) |
     !tolower(bufftype[1]) %in% c("round", "square")){
    messages <- append(messages, "- argument 'bufftype' must be \"round\" or \"square\". Default \"round\"
                       was taken.")
    what     <- append(what, 1)
    bufftype <- "round"
  }

  # Segs of buffers
  if(!is.numeric(segs) | length(segs) > 1 | segs[1] < 0){
    messages <- append(messages, "- argument 'segs' must be a positive integer. Default 20 was
                       taken.")
    what     <- append(what, 1)
    segs     <- 20
  }

  # Progress
  chk_progress <- .chk_progress(messages, what, progress)
  messages <- chk_progress[[1]]
  what     <- chk_progress[[2]]

  warnings <- messages[which(what == 1)]
  errors   <- messages[which(what == 2)]

  out <- list(warnings = warnings,
              errors = errors,
              class_names = class_names,
              site_ref = site_ref,
              bufftype = bufftype,
              segs = segs,
              rast_layer = rast_layer,
              ext_rast_layer = ext_rast_layer,
              rast_names = rast_names,
              progress = progress)
  return(out)
}

.check_pointsCRS <- function(points_layer){
  mess <- FALSE
  if(terra::crs(points_layer) == ""){
    mess <- "- points layer must be projected in a crs with meters unit." }
  return(mess)
}

.check_classCRS <- function(points_layer, class, ex_p, rad){
  mess <- if(!terra::same.crs(points_layer, class)) 1 else 0

  # Check extent non-overlapping
  if(mess == 0){
    ex_cl <- terra::ext(class)
    if(ex_p[1] < ex_cl[1] |
       ex_p[2] > ex_cl[2] |
       ex_p[3] < ex_cl[3] |
       ex_p[4] > ex_cl[4]){
      mess <- 2
    } else {
      if((ex_p[1] - ex_cl[1]) < rad |
         (ex_cl[2] - ex_p[2]) < rad |
         (ex_p[3] - ex_cl[3]) < rad |
         (ex_cl[4] - ex_p[4]) < rad){
        mess <- 3
      }
    }
  }
  return(mess)
}

.check_pointsref <- function(points_layer, site_ref){
  mess <- 0
  if(!site_ref %in% names(points_layer)){
    mess <- 1
  } else {
    if(anyDuplicated(terra::as.list(points_layer)[[site_ref]]) != 0){
      mess <- 2 ; return(mess)
    }
    if(any(is.na(terra::as.list(points_layer)[[site_ref]]))){
      mess <- 3 ; return(mess)
    }
  }
  return(mess)
}