Turtles on

Report the individuals among turtles that are on the same patches as the agents.

turtlesOn(world, turtles, agents, breed, simplify = TRUE)

# S4 method for worldNLR,agentMatrix,matrix,missing
turtlesOn(world, turtles, agents, simplify)

# S4 method for worldNLR,agentMatrix,matrix,character
turtlesOn(world, turtles, agents, breed, simplify = TRUE)

Arguments

world

WorldMatrix or worldArray object.

turtles

AgentMatrix object representing the moving agents.

agents

Matrix (ncol = 2) with the first column pxcor and the second column pycor representing the patches coordinates, or

          `AgentMatrix` object representing the moving `agents`.

breed

Characters. Vector of breed names for the selected turtles. If missing, there is no distinction based upon breed.

simplify

Logical. If simplify = TRUE, all turtles on the same patches as any agents are returned; if simplify = FALSE, the turtles are evaluated for each agents's patches individually.

Value

AgentMatrix representing any individuals from turtles of any of the given breed, if specified, located on the same patches as any of the agents, if simplify = TRUE, or

    Matrix (`ncol` = 2) with the first column `whoTurtles` and the second column

    `id` showing which `turtles` are on the same

    `patches` as which `agents` represented by `id`, if `simplify = FALSE`.

    `id` represents and follows the order of the `agents`. `id` does not represent

    the `who` numbers

    of the `agents` if `agents` are `turtles`.

Details

The agents must be located inside the world's extent.

References

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

See also

https://ccl.northwestern.edu/netlogo/docs/dictionary.html#turtles-on

Author

Sarah Bauduin

Examples

w1 <- createWorld(
  minPxcor = 0, maxPxcor = 9, minPycor = 0, maxPycor = 9,
  data = runif(100)
)
t1 <- createTurtles(n = 500, coords = randomXYcor(w1, n = 500))
plot(w1)
points(t1, col = of(agents = t1, var = "color"), pch = 16)


t2 <- turtlesOn(world = w1, turtles = t1, agents = patch(w1, 2, 2))