stamp.direction: Perform polygon directional analysis
In colinr23/stampr: Spatial Temporal Analysis of Moving Polygons

Description Usage Arguments Details Value References See Also

View source: R/stamp.direction.r

stamp.direction facilitates polygon directional analysis using a variety of methods.

1	stamp.direction(stmp, dir.mode = "CentroidAngle", ndir = 4, group = FALSE)

`stmp`	a `SpatialPolygonsDataFrame` object generated from the `stamp` function.
`dir.mode`	a character item identifying which directional relations method is to be used. See Details for information on each individual method.
`ndir`	(optional) parameter identifying the number of directions to be computed. See inidividual method Details for appropriate usage.
`group`	(optional) a logical value identifying whether direction should be computed on groups or individual event polygons (only used with `CentroidAngle` method).

The stamp.direction function can be used to facilitate directional analysis on output stamp.obj objects from function stamp. Currently, four directional analysis methods are available:

"CentroidAngle" – The centroid angle is simply the angle between the centroids of two polygons. The centroid angle method is computed on STAMP objects by first grouping all T1 polygons (by STAMP group) and computing their centroid. Then, the angle from each T1 group centroid, to the centroid of each STAMP event within the group is calculated. Centroid angles are recorded in degrees, with North having a value of 0, East 90, and so on. "CentroidAngle" ignores the ndir parameter.
"ConeModel" – The cone model method calculates areas of STAMP event polygons within cones radiating from the centroid of the origin polygon. The cone model method first computes the centroid of all T1 polygons in a STAMP grouping. It then computes ndir equally spaced cones radiating outward from the T1 centroid. The first cone is always centered on North, but there can be any number of cones. The area of each STAMP event, in each cone (specifying direction), is then calculated. See Peuquet and Zhang (1987) for more detailed information
"MBRModel" – The minimum bounding rectangle (MBR) method first computes the MBR for all T1 events in a STAMP grouping. Then the lines of four edges of the MBR are extended outwards to infinity creating sections for the eight cardinal directions around the MBR, along with the MBR itself. The area of each stamp event within each of the nine sections is then computed. See Skiadopoulos et al. (2005) for more detailed information. "MBRModel" ignores the ndir parameter.
"ModConeModel" – The modified cone model first computes the centroid of the T1 event that includes a stable event type. Then ndir = 4 or 8 cones are created outward from this centroid to the minimum bounding rectangle of the entire grouping. As described by Robertson et al. (2007) this approach is more accomodating to polygon groups that are irregular in size or shape. If there is more than 1 stable event (as flagged by the stamp.obj LEV4 column, the Voronoi segregation method defined by Robertson et al. (2007) is employed. The modified cone model method first computes the centroid of all T1 polygons in a STAMP grouping. It then computes the bounding box of ALL events in a STAMP grouping. Then, ndir=4 or 8 cones are computed. In the case of ndir=4, cones radiate from the T1 centroid to the four corners of the bounding box. The result of the modified cone model method is that the cones are not equally spaced, but tailored to the individual STAMP groupings shape. See Robertson et al. (2007) for more detailed information.

Appends the input stamp object with appropriate columns for the directional analysis chosen, if dir.mode is:

`"CentroidAngle"`	A single column with centroid angle results, in degrees (North = 0 degrees). If `group=TRUE` then values are identical for all event polygons in the group.
`"ConeModel"`	`ndir` new columns with the area of the STAMP event in each direction, named appropriately (e.g., as `DIR45`, where 45 refers to the mid-point of that directional cone).
`"MBRModel"`	9 new columns with the area of the STAMP event in each direction, named appropriately as "SW","S","SE","W","SAME","E","NW","N","NE".
`"ModConeModel"`	`ndir` new columns with the area of the STAMP event in each direction, named appropriately as, for example, "N","E","S","W" with `ndir=4`.

Note: STAMP events that are singular (i.e., only 1 polygon in the group) will have NA's from directional analysis.

Robertson, C., Nelson, T., Boots, B., and Wulder, M. (2007) STAMP: Spatial-temporal analysis of moving polygons. Journal of Geographical Systems, 9:207-227.

Peuquet, D., Zhang, C.X. (1987) An algorithm to determine the directional relationship between arbitrarily-shaped polygons in the plane. Pattern Recognition, 20:65-74.

Skiadopoulos, S. Giannoukos, C., Sarkas, N., Vassiliadis, P., Sellis, T., and Koubarakis, M. (2005) Computing and managing directional relations. IEEE Transactions on Knowledge and Data Engineering, 17:1610-1623.

stamp, stamp.distance, stamp.shape

colinr23/stampr documentation built on May 13, 2019, 9:54 p.m.