QGIS algorithm - Join attributes by location

Source: R/qgis_joinattributesbylocation.R

QGIS Algorithm provided by QGIS (native c++) Join attributes by location (native:joinattributesbylocation). Join attributes from one vector layer to another by location. This algorithm takes an input vector layer and creates a new vector layer that is an extended version of the input one, with additional attributes in its attribute table. The additional attributes and their values are taken from a second vector layer. A spatial criteria is applied to select the values from the second layer that are added to each feature from the first layer in the resulting one. —————- Notes —————- - This algorithm drops existing primary keys or FID values and regenerates them in output layers.

qgis_joinattributesbylocation(
  INPUT = qgisprocess:::qgis_default_value(),
  PREDICATE = qgisprocess:::qgis_default_value(),
  JOIN = qgisprocess:::qgis_default_value(),
  JOIN_FIELDS = qgisprocess:::qgis_default_value(),
  METHOD = qgisprocess:::qgis_default_value(),
  DISCARD_NONMATCHING = qgisprocess:::qgis_default_value(),
  PREFIX = qgisprocess:::qgis_default_value(),
  OUTPUT = qgisprocess:::qgis_default_value(),
  NON_MATCHING = qgisprocess:::qgis_default_value(),
  ...,
  .complete_output = .complete_output_option(),
  .quiet = .quiet_option(),
  .messages = .message_option()
)

Arguments

INPUT

source - Join to features in. Path to a vector layer.

PREDICATE

enum of ("intersect", "contain", "equal", "touch", "overlap", "are within", "cross") - Features they (geometric predicate). Number of selected option, e.g. '1'. Comma separated list of options, e.g. '1,3'.

JOIN

source - By comparing to. Path to a vector layer.

JOIN_FIELDS

field - Fields to add (leave empty to use all fields). The name of an existing field. ; delimited list of existing field names.

METHOD

enum of ("Create separate feature for each matching feature (one-to-many)", "Take attributes of the first matching feature only (one-to-one)", "Take attributes of the feature with largest overlap only (one-to-one)") - Join type. Number of selected option, e.g. '1'. Comma separated list of options, e.g. '1,3'.

DISCARD_NONMATCHING

boolean - Discard records which could not be joined. 1 for true/yes. 0 for false/no. field:FIELD_NAME to use a data defined value taken from the FIELD_NAME field. expression:SOME EXPRESSION to use a data defined value calculated using a custom QGIS expression.

PREFIX

string - Joined field prefix. String value. field:FIELD_NAME to use a data defined value taken from the FIELD_NAME field. expression:SOME EXPRESSION to use a data defined value calculated using a custom QGIS expression.

OUTPUT

sink - Joined layer. Path for new vector layer.

NON_MATCHING

sink - Unjoinable features from first layer. Path for new vector layer.

...

further parameters passed to qgisprocess::qgis_run_algorithm()

.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.

.quiet

logical specifying if parameter .quiet for qgisprocess::qgis_run_algorithm() Default value is TRUE.

.messages

logical specifying if messages from qgisprocess::qgis_run_algorithm() should be printed (TRUE) or not (FALSE). Default value is FALSE.

Details

Outputs description

  • JOINED_COUNT - outputNumber - Number of joined features from input table

  • NON_MATCHING - outputVector - Unjoinable features from first layer

  • OUTPUT - outputVector - Joined layer