towards {NetLogoR} | R Documentation |
Directions towards
Description
Report the directions of each agents
towards each corresponding agents2
.
Usage
towards(agents, agents2, world, torus = FALSE)
## S4 method for signature 'matrix,matrix'
towards(agents, agents2, world, torus = FALSE)
Arguments
agents |
Matrix ( `AgentMatrix` object representing the moving `agents`. |
agents2 |
Matrix ( `AgentMatrix` object representing the moving `agents`, or Matrix (`ncol` = 2) with the first column `x` and the second column `y` representing locations coordinates. |
world |
|
torus |
Logical to determine if the |
Details
agents
and agents2
must have the same number of agents/locations
or if different, one of them must have only one agent/location. If
agents
and agents2
have the same number of agents/locations,
the directions are calculated for each pair agents[i]
and agents2[i]
and not for each agents
towards every single agents2
.
If `torus = FALSE`, `world` does not need to be provided. If `torus = TRUE` and the distance from one `agents` to its corresponding `agents2` is smaller around the sides of the `world` than across it, then the direction to `agents2` going around the sides of the `world` is returned. The direction from a patch to its location returns 0; the direction from a turtle to its location returns the turtle's heading.
Value
Numeric. Vector of angles in degrees of length equal to the largest
number of agents/locations between agents
and agents2
.
Author(s)
Sarah Bauduin
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#towards
<https://ccl.northwestern.edu/netlogo/docs/dictionary.html#towardsxy>
Examples
w1 <- createWorld(minPxcor = 0, maxPxcor = 4, minPycor = 0, maxPycor = 4)
towards(agents = patches(w1), agents2 = cbind(x = 0, y = 0))
t1 <- createTurtles(n = 10, world = w1)
towards(agents = t1, agents2 = cbind(x = 0, y = 0))