Translate geometric objects

Source: R/gt_translate.R

Translate geometric objects by adding a constant in x and y dimension.

gt_translate(obj, x = NULL, y = NULL, fid = NULL, update = TRUE)

Arguments

obj

[geometric object(1)]
the object to translate.
x

[numeric(1)]
the translation constant (offset) in x dimension.
y

[numeric(1)]
the translation constant (offset) in y dimension.
fid

[integerish(.)]
in case only a subset of features shall be translated, specify that here.
update

[logical(1)]
whether or not to update the window slot after translation.

Value

geom of the mathematically translated obj.

See also

Other geometry tools: gt_filter(), gt_locate(), gt_pull(), gt_reflect(), gt_rotate(), gt_scale(), gt_skew(), gt_stretch()

Examples

# translate several features
visualise(gtGeoms$polygon, linewidth = 3)
newPoly <- gt_translate(obj = gtGeoms$polygon, x = 5, y = c(-10, 5),
                        update = FALSE)
visualise(geom = newPoly, linecol = "green", new = FALSE)


# translate a single feature
visualise(gtGeoms$polygon, linewidth = 3)
newPoly <- gt_translate(obj = gtGeoms$polygon, x = 5, fid = 2,
                        update = FALSE)
visualise(geom = newPoly, linecol = "green", new = FALSE)