Geometry Decomposition

Build a map of path-based geometry, this is a simple description of the number of parts in an object and their basic structure. Translation and restructuring operations for planar shapes and other hierarchical types require a data model with a record of the underlying relationships between elements. The gibble() function creates a geometry map, a simple record of the underlying structure in path-based hierarchical types. There are methods for the planar shape types in the 'sf' and 'sp' packages and for types in the 'trip' and 'silicate' packages.

BuildStatus BuildStatus AppVeyor BuildStatus CoverageStatus CRANstatus cranchecks Downloads

The goal of gibble is to provide a straightforward map of path-based data structures. Paths are connected linear sequences of coordinates, otherwise known as lines. Structured spatial data includes objects composed of paths, which are islands, holes within island, lines, and points. Polygons require an extra grouping level subobject to ensure holes are nested within their island, but this is ignored for other types.

The map is simply a record of the path, its size (number of vertices and geometric dimension), its groupings (which object and subobject), and its type (something like “polygon”, “line”, “point”). Internally a bare functionality works with matrices and all numeric values, but gibble then turns this set of values into a data frame where entities can be labelled arbitrarily.

Sequential linear structures are not optimal for many operations when working with spatial data, and in particular they cannot describe surfaces in 3D geometry because they are inherently, topologically, one-dimensional. Gibble provides a simple bridge between path and primitive types, which do generalize to any topological dimension. Gibble considers a point to be a degenerate path, so that the path concept is consistent for any simple features-analogue.

The original impetus for gibble was to illustrate how basic topological editing might be provided via the mapedit package, and is used to consolidate the geometry decomposition tools in silicate.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


gibble 0.2.0

  • Add gibble methods for silicate PATH and PATH0.

gibble 0.1.2

  • Fix gibble for PATH objects from silicate (when they are points).

  • SpatialPoints has object column, needed for silicate.

gibble 0.1.0

  • Fixed multipoints for silicate, both sf and sp.

  • Fixes for SpatialLines and SpatialMultiPoints, found in anglr.

gibble 0.0.2

  • Added PATH, sp , trip methods for gibble.

gibble 0.0.1

  • First release

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.4.0 by Michael Sumner, a year ago

Report a bug at

Browse source code at

Authors: Michael Sumner [aut, cre]

Documentation:   PDF Manual  

GPL-3 license

Imports dplyr, methods, tibble, rlang

Suggests covr, testthat, knitr, rmarkdown

Imported by silicate.

See at CRAN