Sprout new turtles

Create n new turtles on specific patches.

sprout(n, patches, breed, heading, color, turtles)

# S4 method for numeric,matrix
sprout(n, patches, breed, heading, color,
  turtles)

Arguments

n	Integer. Vector of length 1 or of length the number of patches. Number of new turtles to create on each patch.
patches	Matrix (ncol = 2) with the first column pxcor and the second column pycor representing the patches coordinates.
breed	Character. Vector of breed names. Must be of length 1 or of length the number of patches. If missing, breed = turtle for all the sprouted turtles.
heading	Numeric. Vector of values between 0 and 360. Must be of length 1 or of length the number of patches. If missing, a random heading is assigned to each sprouted turtle.
color	Character. Vector of color names. Must be of length 1, of length the number of patches or of length sum(n). If missing, colors are assigned using the function rainbow(n).
turtles	AgentMatrix object representing the moving agents.

Value

AgentMatrix including the new sprouted turtles.

Details

nrow(patches) must be equal to 1 or to n.

If turtles is provided, the new turtles are added to the turtles when returned. The who numbers of the sprouted turtles therefore follow the ones from the turtles. All new sprouted turtles are placed at the end of the agentMatrix object. If no turtles is provided, a new agentMatrix is created and the who numbers start at 0.

If turtles is provided and had additional variables created with turtlesOwn(), NA is given for these variables for the new sprouted turtles.

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#sprout

Examples

t1 <- sprout(patches = cbind(pxcor = 2, pycor = 2), n = 3)
t2 <- sprout(patches = cbind(pxcor = 3, pycor = 3), n = 3, turtles = t1)