Hatch new turtles

Create new turtles from parent turtles.

hatch(turtles, who, n, breed)

# S4 method for agentMatrix,numeric,numeric
hatch(turtles, who, n, breed)

Arguments

turtles

AgentMatrix object representing the moving agents.

who

Integer. Vector of the who numbers for the selected turtles.

n

Integer. Vector of length 1 or of length who. Number of new turtles to create for each parent.

breed

Character. One breed name. If missing, the created turtles are of the same breed as their parent turtle.

Value

AgentMatrix representing the turtles with the new hatched ones.

Details

The parent turtle must be contained in the turtles.

     The created `turtles` inherit of all the data from the parent `turtle`,

     except for the `breed` if specified otherwise, and for the `who` numbers.

     The `who`" numbers of the `turtles` created take on following the highest

     `who` number among the `turtles`.



     All new hatched `turtles` are placed at the end of the `agentMatrix` object.

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

Author

Sarah Bauduin

Examples

w1 <- createWorld(minPxcor = 0, maxPxcor = 4, minPycor = 0, maxPycor = 4)
t1 <- createTurtles(n = 10, world = w1)
NLcount(t1)
#> [1] 10
t1 <- hatch(turtles = t1, who = 0, n = 2)
NLcount(t1)
#> [1] 12