R/qgis_exportaddgeometrycolumns.R

Defines functions qgis_exportaddgeometrycolumns

Documented in qgis_exportaddgeometrycolumns

##' QGIS Algorithm provided by QGIS Add geometry attributes (qgis:exportaddgeometrycolumns). This algorithm computes geometric properties of the features in a vector layer. It generates a new vector layer with the same content as the input one, but with additional attributes in its attributes table, containing geometric measurements. Depending on the geometry type of the vector layer, the attributes added to the table will be different.
##'
##' @title QGIS algorithm - Add geometry attributes
##'
##' @param INPUT `source` - Input layer. Path to a vector layer.
##' @param CALC_METHOD `enum`  of `("Layer CRS", "Project CRS", "Ellipsoidal")` - Calculate using. Number of selected option, e.g. '1'. Comma separated list of options, e.g. '1,3'.
##' @param OUTPUT `sink` - Added geom info. Path for new vector layer.
##' @param ... further parameters passed to `qgisprocess::qgis_run_algorithm()`
##' @param .complete_output logical specifying if complete out of `qgisprocess::qgis_run_algorithm()` should be used (`TRUE`) or first output (most likely the main) should read (`FALSE`). Default value is `TRUE`.
##' @param .quiet logical specifying if parameter `.quiet` for `qgisprocess::qgis_run_algorithm()` Default value is `TRUE`.
##' @param .messages logical specifying if messages from `qgisprocess::qgis_run_algorithm()` should be printed (`TRUE`) or not (`FALSE`). Default value is `FALSE`.
##'
##' @details
##' ## Outputs description
##' * OUTPUT - outputVector - Added geom info
##'
##'
##' @export
##' @md
##' @importFrom qgisprocess qgis_run_algorithm

qgis_exportaddgeometrycolumns <- function(INPUT = qgisprocess:::qgis_default_value(), CALC_METHOD = qgisprocess:::qgis_default_value(), OUTPUT = qgisprocess:::qgis_default_value(),..., .complete_output = .complete_output_option(), .quiet = .quiet_option(), .messages = .message_option()) {

  check_algorithm_necessities("qgis:exportaddgeometrycolumns")

  if (.messages){
    output <- qgisprocess::qgis_run_algorithm("qgis:exportaddgeometrycolumns", `INPUT` = INPUT, `CALC_METHOD` = CALC_METHOD, `OUTPUT` = OUTPUT,..., .quiet = .quiet)
  } else {
    suppressMessages(
      output <- qgisprocess::qgis_run_algorithm("qgis:exportaddgeometrycolumns", `INPUT` = INPUT, `CALC_METHOD` = CALC_METHOD, `OUTPUT` = OUTPUT,..., .quiet = .quiet)
      )
  }

  if (.complete_output) {
    return(output)
  }
  else{
    qgisprocess::qgis_extract_output(output, "OUTPUT")
  }
}
JanCaha/r_package_qgis documentation built on April 4, 2024, 8:10 p.m.