Skip to contents

Simplify geometries

Source: R/sx_simplify.R
sx_simplify.Rd

Simplify the geometry by removing points (vertices) that do not significantly contribute to the shape. Uses the Ramer-Douglas-Peucker algorithm.

Usage

sx_simplify(
  x,
  dTolerance,
  preserveTopology = FALSE,
  output = NULL,
  view_name = NULL,
  verbosity = NULL,
  ...
)

Arguments

x

Input object (sf, sedonadb_dataframe, or character view name).

dTolerance

Numeric. The tolerance distance for simplification. Vertices closer than this distance to the simplified line are removed.

preserveTopology

Logical. If TRUE, attempts to preserve the topology of the geometry (e.g., preventing self-intersections). (Not yet supported/verified for SedonaDB backend, defaults to FALSE. Warning issued if TRUE).

output

Character or NULL. Output type: sedonadb_dataframe (default), sf, tibble, geoarrow, or raw. If NULL, uses getOption("sx.output_type", "sedonadb_dataframe").

Output types:

  • sedonadb_dataframe: Lazy data frame (no collection).

  • sf: Materialized sf object.

  • tibble: Tibble without geometry.

  • geoarrow: Tibble with geoarrow_vctr geometry (Arrow-native).

  • raw: Tibble with geometry as raw WKB bytes (for database import).

view_name

Character (optional). Name to register the result as a persistent view in the active backend. If NULL (default), returns the result directly without creating a view.

Not all backends support named views. Check backend-specific documentation for availability.

verbosity

Character or NULL. Controls message output for this function call.

  • "quiet": Suppress all informational messages.

  • "info": Show standard progress and status messages.

  • "debug": Show additional diagnostic messages for troubleshooting.

If NULL (the default), uses the global sx.verbosity option. See sx_options() for persistent configuration.

...

Ignored. Used to catch and warn about unsupported sf arguments.

Value

Result (type depends on output)