geo_locate: Locate (and identify) clicks

In EhrmannS/geometr: Generate and Modify Interoperable Geometric Objects

Locate (and identify) clicks

Description

Click into a plot to get the location or identify values

Usage

geo_locate(
  samples = 1,
  panel = NULL,
  identify = FALSE,
  snap = FALSE,
  raw = FALSE,
  show = TRUE,
  ...
)

Arguments

samples	integerish(1) the number of clicks.
panel	character(1) the panel in which to locate (i.e. the title shown over the plot).
identify	logical(1) get the raster value or geom ID at the sampled location (TRUE) or merely the location (FALSE, default).
snap	logical(1) should the returned value(s) be set to the nearest raster cell's center (TRUE) or should they remain the selected, "real" value (FALSE, default)?
raw	logical(1) should the complete statistics about the clicks be returned (TRUE), or should only the basic output be returned (FALSE, default)?
show	logical(1) should information be plotted (TRUE), or should they merely be returned to the console (FALSE, default)?
...	graphical parameters of the objects that are created when show = TRUE.

Value

A tibble of the selected locations and, if identify = TRUE, the respective values. If show = TRUE the values are also shown in the plot.

See Also

Other geometry tools: geo_filter(), geo_pull(), geo_reflect(), geo_rotate(), geo_scale(), geo_skew(), geo_stretch(), geo_translate()

Examples

if(dev.interactive()){

  # locate coordinates with geoms
  geo_vis(geom = gtGeoms$polygon)
  geo_locate(samples = 2)

  # locate or identify values with rasters
  geo_vis(raster = gtGeoms$grid)
  geo_locate(identify = TRUE, snap = TRUE)

  # with several panels, specify a target
  geo_vis(gtGeoms$grid, gtGeoms$grid)
  geo_locate(samples = 4, panel = "categorical",
            snap = TRUE, identify = TRUE)

}

EhrmannS/geometr documentation built on Jan. 31, 2024, 9:13 a.m.