NetLogoR (version 1.0.5)

createTurtles: Create turtles

Description

Create n moving agents with a set of defined variables.

Usage

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)

Value

AgentMatrix object of length n with data for the turtles being: xcor, ycor, who, heading, prevX, prevY, breed, and color.

Arguments

n

Integer.

coords

Matrix (ncol = 2) with the first column xcor and the second column ycor representing the turtles initial 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).

Author

Sarah Bauduin

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

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