# gm_coordinates: gm_coordinates In geometries: Convert Between R Objects and Geometric Structures

## Description

Converts all coordinates from various geometric shapes into a single data.frame.

## Usage

 `1` ```gm_coordinates(x) ```

## Arguments

 `x` object representing geometry shapes (e.g., list of matrices)

## Details

The data.frame returned will always have an 'id' column. Then will follow an 'id+counter' column for every level of nesting the geometry is within.

The coordinates always start in column 'c1', the first column after all the id columns. Then there is a column 'c+counter' for every coordinate in the geometry.

This function is designed to handle multiple and different nested of geometry structures.

## Value

a single data.frame representing all the values in the input lists and matrices.

## Examples

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78``` ```x <- 1:3 gm_coordinates( x ) m <- matrix(1:12, ncol = 3) gm_coordinates( m ) l <- list( matrix(1:12, ncol = 2 ) ) gm_coordinates( l ) l <- list( matrix(1:12, ncol = 4 ) ) gm_coordinates( l ) l <- list( list( matrix(1:12, ncol = 2) ) ) gm_coordinates( l ) l <- list( list( matrix(1:12, ncol = 2) , matrix(1:4, ncol = 2) ) ) gm_coordinates( l ) l <- list( list( matrix(1:12, ncol = 2) , matrix(1:4, ncol = 2) ) , 1:5 , 1:2 , matrix(1:9, ncol = 3) ) gm_coordinates( l ) l <- list( matrix(1:4, ncol = 2) , list( matrix(1:9, ncol = 3) ) ) gm_coordinates( l ) l <- list( list( list( matrix(1:12, ncol = 2) ) ) , list( list( matrix(1:24, ncol = 2) ) ) ) gm_coordinates( l ) l <- list( list( list( matrix(1:12, ncol = 2) ) ) , list( list( matrix(1:3, ncol = 3) , matrix(1:24, ncol = 2) ) ) ) gm_coordinates( l ) ```

geometries documentation built on Jan. 13, 2021, 8:12 p.m.