Report one patch or turtle randomly selected among agents.

oneOf(agents)

# S4 method for matrix
oneOf(agents)

## Arguments

agents

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

Matrix (ncol = 3) with the first column "pxcor and the second column pycor representing the patches coordinates and the third column id, or

AgentMatrix object representing the moving agents, or

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

## Value

Matrix (ncol = 2, nrow = 1) with the first column pxcor and the second column pycor representing the coordinates of the selected patch from agents, or Matrix (ncol = 2) with the first column pxcor and the second column pycor representing the coordinates of the selected patches from agents, one per individual id, or AgentMatrix object representing the turtle selected from agents, or Integer. Vector of who numbers for the selected turtles from agents, one per individual id.

## Details

If agents is a matrix with ncol = 3, the selection of one random patch is done per individual id. The order of the patches coordinates returned follow the order of id. If agents is a matrix (ncol = 2) with columns whoTurtles and id, the selection of one random turtle (defined by their whoTurtles) is done per individual id. The order of the who numbers returned follow the order of id.

Sarah Bauduin

## Examples

# Patches
w1 <- createWorld(minPxcor = 0, maxPxcor = 4, minPycor = 0, maxPycor = 4)
pSelect <- oneOf(agents = patches(w1))

# Turtles
t1 <- createTurtles(n = 10, coords = randomXYcor(w1, n = 10))
tSelect <- oneOf(agents = t1)