y-increment

Report the amount by which the turtles' coordinates ycor would change if the turtles were to move forward the given distances with their current headings.

dy(turtles, dist = 1)

# S4 method for agentMatrix,numeric
dy(turtles, dist = 1)

# S4 method for agentMatrix,missing
dy(turtles)

Arguments

turtles

AgentMatrix object representing the moving agents.

dist

Numeric. Vector of distances the turtles would have to move forward to compute the increment values. Must be of length 1 or of length turtles. The default value is dist = 1.

Value

Numeric. Vector of length turtles.

Details

Report the cosine of the turtles' heading multiplied by the dist values. Heading 0 is north and angles are calculated in degrees in a clockwise manner.

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

Author

Sarah Bauduin

Examples

w1 <- createWorld(minPxcor = 0, maxPxcor = 4, minPycor = 0, maxPycor = 4)
t1 <- createOTurtles(world = w1, n = 10)
dy(turtles = t1)
#>  [1]  1.00000  0.80902  0.30902 -0.30902 -0.80902 -1.00000 -0.80902 -0.30902
#>  [9]  0.30902  0.80902