Report the coordinates of the patches at the given distances of the turtles in the direction of their headings.

patchAhead(world, turtles, dist, torus = FALSE)

# S4 method for worldNLR,agentMatrix,numeric
patchAhead(world, turtles, dist, torus = FALSE)

## Arguments

world WorldMatrix or worldArray object. AgentMatrix object representing the moving agents. Numeric. Vector of distances from the turtles. dist must be of length 1 or of length turtles. Logical to determine if the world is wrapped. Default is torus = FALSE.

## Value

Matrix (ncol = 2) with the first column pxcor and the second column pycor representing the coordinates of the patches at the distances dist and turtles's headings directions of turtles. The order of the patches follows the order of the turtles.

## Details

If torus = FALSE and the patch at distance dist of a turtle is outside the world's extent, NA are returned for the patch coordinates. If torus = TRUE, the patch coordinates from a wrapped world are returned.

## References

Wilensky, U. 1999. NetLogo. http://ccl.northwestern.edu/netlogo/. Center for Connected Learning and Computer-Based Modeling, Northwestern University. Evanston, IL.

## Examples

w1 <- createWorld(minPxcor = 0, maxPxcor = 9, minPycor = 0, maxPycor = 9)
t1 <- createTurtles(n = 10, coords = randomXYcor(w1, n = 10))
patchAhead(world = w1, turtles = t1, dist = 1)#>       pxcor pycor
#>  [1,]    NA    NA
#>  [2,]     8     8
#>  [3,]     5     3
#>  [4,]     6     6
#>  [5,]     5     7
#>  [6,]     5     4
#>  [7,]     3     1
#>  [8,]     6     8
#>  [9,]    NA    NA
#> [10,]     6     5