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)

world | WorldMatrix or worldArray object. |
---|---|

turtles | AgentMatrix object representing the moving agents. |

dist | Numeric. Vector of distances from the |

torus | Logical to determine if the |

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`

.

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.

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

https://ccl.northwestern.edu/netlogo/docs/dictionary.html#patch-ahead

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,] 8 6 #> [2,] 3 0 #> [3,] NA NA #> [4,] 2 8 #> [5,] 6 2 #> [6,] 2 7 #> [7,] NA NA #> [8,] 4 2 #> [9,] 1 9 #> [10,] NA NA