stamp: Spatial temporal analysis of moving polygons

Description Usage Arguments Details Value References See Also

View source: R/stamp.r


This function generates a SpatialPolygonsDataFrame that can be used for spatial temporal analysis of moving polygons as described in the paper Robertson et al. (2007).


stamp(T1, T2, dc = 0, direction = FALSE, distance = FALSE, ...)



a SpatialPolygonsDataFrame object of polygons from time 1.


a SpatialPolygonsDataFrame object of polygons from time 2.


spatial distance threshold for determining groupings (see Details) in appropriate units.


logical, whether or not to perform directional analysis. See documentation for stamp.direction for further details.


logical, whether or not to perform distance analysis. See documentation for stamp.distance for further details.


additional parameters to be passed to functions if direction, or distance are set to TRUE.


The stamp function can be used to perform spatial temporal analysis of moving polygons (STAMP) as outlined in the paper by Robertson et al., (2007). Polygon movement "groups" are delineated based on polygon connectedness defined by the distance threshold dc. That is, if polygon boundaries (in T1 or T2) are within distance dc of one another they will be designated to the same group. STAMP events are reported at four levels of increasing complexity:
LEV1 – disappearance (DISA), stable (STBL), and generation (GENA);
LEV2 – disappearance (DISA), contraction (CONT), stable (STBL), expansion (EXPN), and generation (GENR);
LEV3 – disappearance (DISA), T1 displacement (DISP1), convergence (CONV), concentration (CONC), contraction (CONT), stable (STBL), expansion (EXP), fragmentation (FRAG), divergence (DIV), T2 displacement (DISP2), and generation (GENR);
LEV4 – LEV4 is different from other levels. It is used to identify those groups where union (UNION), division (DIVISION), and both union and division (BOTH) events occur. These events occur when there are more than one stable event in a group. Groups with one or no stable events recieve an NA value for LEV4.
See Robertson et al. (2007; especially Figure 1) for complete descriptions of all STAMP movement event types.

Note also that there must be a globally unique ID column in each data frame passed to the stamp function


This function returns a SpatialPolygonsDataFrame with the following data columns:


Polygon ID from T1 polygons; NA if it did not exist,


Polygon ID from T2 polygons; NA if it did not exist,


Level 1 STAMP designation,


Level 2 STAMP designation,


Level 3 STAMP designation,


Level 4 STAMP designation,


Group ID signifying group membership,


Polygon area in appropriate areal units,

(optional) Additional columns from directional analysis if direction = TRUE,

(optional) Additional columns from distance analysis if distance = TRUE,


Robertson, C., Nelson, T., Boots, B., and Wulder, M. (2007) STAMP: Spatial-temporal analysis of moving polygons. Journal of Geographical Systems, 9:207-227. Long, J., Robertson, C., and Nelson, T. (2018) stampr: Spatial-temporal analysis of moving polygons in R. Journal of Statistical Software, 84:1.

See Also

stamp.direction stamp.distance stamp.shape

colinr23/stampr documentation built on April 18, 2018, 9:29 p.m.