QGIS Algorithm provided by QGIS (native c++) Join by lines (hub lines) (native:hublines). Creates lines joining two point layers, based on a common attribute value. This algorithm creates hub and spoke diagrams by connecting lines from points on the Spoke layer to matching points in the Hub layer. Determination of which hub goes with each point is based on a match between the Hub ID field on the hub points and the Spoke ID field on the spoke points. If input layers are not point layers, a point on the surface of the geometries will be taken as the connecting location. Optionally, geodesic lines can be created, which represent the shortest path on the surface of an ellipsoid. When geodesic mode is used, it is possible to split the created lines at the antimeridian (±180 degrees longitude), which can improve rendering of the lines. Additionally, the distance between vertices can be specified. A smaller distance results in a denser, more accurate line. —————- Notes —————- - This algorithm drops existing primary keys or FID values and regenerates them in output layers.
qgis_hublines(
HUBS = qgisprocess:::qgis_default_value(),
HUB_FIELD = qgisprocess:::qgis_default_value(),
HUB_FIELDS = qgisprocess:::qgis_default_value(),
SPOKES = qgisprocess:::qgis_default_value(),
SPOKE_FIELD = qgisprocess:::qgis_default_value(),
SPOKE_FIELDS = qgisprocess:::qgis_default_value(),
GEODESIC = qgisprocess:::qgis_default_value(),
GEODESIC_DISTANCE = qgisprocess:::qgis_default_value(),
ANTIMERIDIAN_SPLIT = qgisprocess:::qgis_default_value(),
OUTPUT = qgisprocess:::qgis_default_value(),
...,
.complete_output = .complete_output_option(),
.quiet = .quiet_option(),
.messages = .message_option()
)
source
- Hub layer. Path to a vector layer.
field
- Hub ID field. The name of an existing field. ; delimited list of existing field names.
field
- Hub layer fields to copy (leave empty to copy all fields). The name of an existing field. ; delimited list of existing field names.
source
- Spoke layer. Path to a vector layer.
field
- Spoke ID field. The name of an existing field. ; delimited list of existing field names.
field
- Spoke layer fields to copy (leave empty to copy all fields). The name of an existing field. ; delimited list of existing field names.
boolean
- Create geodesic lines. 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.
distance
- Distance between vertices (geodesic lines only). A numeric 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.
boolean
- Split lines at antimeridian (±180 degrees longitude). 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.
sink
- Hub lines. Path for new vector layer.
further parameters passed to qgisprocess::qgis_run_algorithm()
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
.
logical specifying if parameter .quiet
for qgisprocess::qgis_run_algorithm()
Default value is TRUE
.
logical specifying if messages from qgisprocess::qgis_run_algorithm()
should be printed (TRUE
) or not (FALSE
). Default value is FALSE
.