Return the agents sorted according to their value.

sortOn(agents, world, var)

# S4 method for matrix,worldMatrix,missing
sortOn(agents, world)

# S4 method for matrix,worldArray,character
sortOn(agents, world, var)

# S4 method for agentMatrix,missing,character
sortOn(agents, var)

## Arguments

agents Matrix (ncol = 2) with the first column "pxcor" and the second column "pycor" representing the patches coordinates, or AgentMatrix object representing the moving agents. WorldMatrix or worldArray object. Character. The name of the selected agents variable. If agents are patches and the world is a worldMatrix object, var must not be provided. If agents are patches and the world is a worldArray object, var is the name of the layer to use to define the patches values. If agents are turtles, var is one of the turtles' variable and can be equal to "xcor", "ycor", any of the variables created when turtles were created, as well as any variable created using turtlesOwn().

## Value

Matrix (ncol = 2) with the first column "pxcor" and the second column "pycor" representing the coordinates of the patches sorted according to their values, if agents are patches, or

AgentMatrix representing the turtles sorted according to their var values, if agents are turtles.

## Details

world must not be provided if agents are turtles.

The sorting of the agents is done in a increasing order.

## References

Wilensky, U. 1999. NetLogo. http://ccl.northwestern.edu/netlogo/. Center for Connected Learning and Computer-Based Modeling, Northwestern University. Evanston, IL.

# Patches
sortHeadingT1 <- sortOn(agents = t1, var = "heading")