gt_pull: Extract a single column from a geometric object

Description Usage Arguments Details Value See Also Examples

View source: R/gt_pull.R

Description

This function allows to extract a specific column from any geometric object for which all required getters are available and thus reflects the base function $.

Usage

1
gt_pull(obj, var, ungroup = FALSE)

Arguments

obj

[geometric object(1)]
the object to pull a column from.

var

[character(1)]
name of the variable to pull.

ungroup

[logical(1)]
inversely to the argument group in gc_geom, this argument provides the attribute to pull per each individual feature, producing duplicates in case there is more than one feature per group.

Details

This function searches for var by first looking in the groups, then the features and finally the points of obj. This results always in an output that is limited to the unique cases of var. In case you want the explicit values of, for instance, fid in obj@points, you have to extract points and then use pull on the result.

Value

vector of the column specified in var.

See Also

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

Examples

1
2
3
4
5
6
7
8
# pull values from a geom (there are two features, thus two values) ...
gt_pull(gtGeoms$point, "fid")

# pull from a Raster* with RAT
gt_pull(gtGeoms$grid$categorical, "cover")

# pull from an sf-object
gt_pull(gtSF$point, "a")

geometr documentation built on Sept. 21, 2021, 1:07 a.m.