Create `n`

moving agents with a set of defined variables.

createTurtles(n, coords, world, heading, breed, color)
# S4 method for numeric,matrix,missing
createTurtles(n, coords, world, heading,
breed, color)
# S4 method for numeric,missing,ANY
createTurtles(n, coords, world, heading, breed,
color)

## Arguments

n |
Integer. |

coords |
Matrix (ncol = 2) with the first column "xcor" and the second
column "ycor" representing the turtles inital locations.
`nrow(coords)` must be equal to 1 or to `n` .
Given coordinates must be inside the `world` 's extent. If missing,
turtles are put in the center of the `world` . |

world |
WorldMatrix or worldArray object. |

heading |
Numeric. Vector of values between 0 and 360. Must be of length 1 or
of length `n` . If missing, a random heading is assigned to
each turtle. |

breed |
Character. Vector of "breed" names. Must be of length 1 or of length
`n` . If missing, `breed = "turtle"` for all turtles. |

color |
Character. Vector of color names. Must be of length `n` .
If missing, colors are assigned using the function `rainbow(n)` . |

## Value

AgentMatrix object of length `n`

with data for the
turtles being: "xcor", "ycor", "who", "heading", "prevX", "prevY",
"breed", and "color".

## Details

If `coords`

is provided, `world`

must not be provided.

The identity of the turtles is defined by their "who" number. This
numbering starts at 0 and increments by 1.

The coordinates from the previous time step are stored in "prevX" and
"prevY". The initial values are `NA`

.

## 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#create-turtles

## Examples