Package HAL.GridsAndAgents
Class AgentGrid2D<T extends AgentBaseSpatial>
- java.lang.Object
-
- HAL.GridsAndAgents.AgentGrid2D<T>
-
- Type Parameters:
T
- the type of agent that the AgentGrid2D will hold
- All Implemented Interfaces:
Grid2D
,java.io.Serializable
,java.lang.Iterable<T>
public class AgentGrid2D<T extends AgentBaseSpatial> extends java.lang.Object implements Grid2D, java.lang.Iterable<T>, java.io.Serializable
AgentGrid2Ds can hold any type of 2D Agent- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description AgentGrid2D(int x, int y, java.lang.Class<T> agentClass)
pass to the constructor the dimensions of the grid and the agent class type, written T.type where T is the name of the occupying agent class.AgentGrid2D(int x, int y, java.lang.Class<T> agentClass, boolean wrapX, boolean wrapY)
pass to the constructor the dimensions of the grid and the agent class type, written T.type where T is the name of the occupying agent class.
-
Method Summary
Modifier and Type Method Description void
_PassAgentConstructor(java.lang.Class<T> agentClass)
meant to be used specifically in conjunction with the LoadState Utils function.java.util.List<T>
AllAgents()
returns the list of all agents as an unmodifiable listjava.util.List<T>
AllDeads()
returns the list of all dead agents as an unmodifiable listint
ApplyAgentsRad(double rad, double x, double y, AgentRadDispToAction2D<T> action)
applies AgentRadDispToAction2D function to all agents within radiusvoid
CleanAgents()
cleans the list of agents, removing dead ones, may improve the efficiency of the agent iteration if many agents have died do not call this while in the middle of iterationvoid
CleanShuffle(Rand rn)
calls CleanAgents, then ShuffleAgentsT
GetAgent(int index)
Gets a single agent at the specified grid square, beware using this function with stackable agents, as it will only return one of the stack of agents.T
GetAgent(int x, int y)
Gets a single agent at the specified grid square, beware using this function with stackable agents, as it will only return one of the stack of agents.void
GetAgents(java.util.ArrayList<T> putHere, int i)
appends to the provided arraylist all agents on the square at the specified coordinatesvoid
GetAgents(java.util.ArrayList<T> putHere, int x, int y)
appends to the provided arraylist all agents on the square at the specified coordinatesvoid
GetAgents(java.util.ArrayList<T> putHere, int x, int y, AgentToBool<T> EvalAgent)
appends to the provided arraylist all agents on the square at the specified coordinates, will subset only agents for which EvalAgent returns truevoid
GetAgents(java.util.ArrayList<T> putHere, int i, AgentToBool<T> EvalAgent)
appends to the provided arraylist all agents on the square at the specified coordinates, will subset only agents for which EvalAgent returns trueT
GetAgentSafe(int x, int y)
Same as GetAgent above, but if x or y are outside the domain, it will apply wrap around if wrapping is enabled, or return null.void
GetAgentsHood(java.util.ArrayList<T> retAgentList, int[] hood, int centerX, int centerY)
gets all agents within the given neighborhood and adds them to the ArrayList argumentvoid
GetAgentsHood(java.util.ArrayList<T> retAgentList, int[] hood, int centerX, int centerY, AgentToBool<T> EvalAgent)
gets all agents within the given neighborhood forwhich EvalAgent returns true and adds them to the ArrayList argumentvoid
GetAgentsHoodMapped(java.util.ArrayList<T> retAgentList, int[] hood, int hoodLen)
gets all agents in the provided neighborhood, assumes that the neighborhood has already been mapped to a locationvoid
GetAgentsHoodMapped(java.util.ArrayList<T> retAgentList, int[] hood, int hoodLen, AgentToBool<T> EvalAgent)
gets all agents in the provided neighborhood, assumes that the neighborhood has already been mapped to a locationvoid
GetAgentsRad(java.util.ArrayList<T> retAgentList, double x, double y, double rad)
gets all agents that are within rad, and adds them to the ArrayListvoid
GetAgentsRad(java.util.ArrayList<T> retAgentList, double x, double y, double rad, AgentToBool<T> EvalAgent)
gets all agents that are within rad forwhich EvalAgent returns true, and adds them to the ArrayListvoid
GetAgentsRad(java.util.ArrayList<T> retAgentList, java.util.ArrayList<double[]> displacementInfo, double x, double y, double rad)
gets all agents that are within rad, and adds them to the ArrayList, displacementInfo contains the following info for each agent: [dist from point,x disp,y disp]void
GetAgentsRad(java.util.ArrayList<T> retAgentList, java.util.ArrayList<double[]> displacementInfo, double x, double y, double rad, AgentToBool<T> EvalAgent)
gets all agents that are within rad forwhich EvalAgent returns true, and adds them to the ArrayListvoid
GetAgentsRect(java.util.ArrayList<T> retAgentList, int x, int y, int width, int height)
gets all agents within the rectangle argument defined by the bottom corner and the dimension argumentsvoid
GetAgentsRect(java.util.ArrayList<T> retAgentList, int x, int y, int width, int height, AgentToBool<T> EvalAgent)
gets all agents forwhich evalAgent returns true within the rectangle argument defined by the bottom corner and the dimension argumentsvoid
GetAgentsSafe(java.util.ArrayList<T> putHere, int x, int y)
appends to the provided arraylist all agents on the square at the specified coordinates, will apply wraparound if the coordinates are outside the domainvoid
GetAgentsSafe(java.util.ArrayList<T> putHere, int x, int y, AgentToBool<T> EvalAgent)
appends to the provided arraylist all agents on the square at the specified coordinates forwhich EvalAgent returns true, will apply wraparound if the coordinates are outside the domainint
GetTick()
gets the current grid timestep.void
IncTick()
increments the internal grid tick counter by 1, used with the Age() and BirthTick() functions to get age information about the agents on an AgentGrid.boolean
IsWrapX()
boolean
IsWrapY()
java.lang.Iterable<T>
IterAgents(int i)
iterates over all agents at positionjava.lang.Iterable<T>
IterAgents(int x, int y)
iterates over all agents at positionjava.lang.Iterable<T>
IterAgentsHood(int[] hood, int centerI)
iterates over all agents found in a neighborhood after mappingjava.lang.Iterable<T>
IterAgentsHood(int[] hood, int centerX, int centerY)
iterates over all agents found in a neighborhood after mappingjava.lang.Iterable<T>
IterAgentsHoodMapped(int[] hood, int hoodLen)
iterates over all agents found in an already mapped neighborhoodjava.lang.Iterable<T>
IterAgentsRad(double x, double y, double rad)
iterates over all agents within radiusjava.lang.Iterable<T>
IterAgentsRect(int x, int y, int width, int height)
iterates over all agents in the rectangle defined by (x,y) as the lower left corner, and (x+width,y+height) as the top right corner.java.lang.Iterable<T>
IterAgentsSafe(int x, int y)
Same as IterAgents above, but will apply wraparound if x,y fall outside the grid dimensions.java.util.Iterator<T>
iterator()
int
Length()
int
MapEmptyHood(int[] hood, int centerI)
similar to the MapHood function, but will only include indices of locations that are emptyint
MapEmptyHood(int[] hood, int centerX, int centerY)
similar to the MapHood function, but will only include indices of locations that are emptyint
MapOccupiedHood(int[] hood, int centerI)
similar to the MapHood function, but will only include indices of locations that are occupiedint
MapOccupiedHood(int[] hood, int centerX, int centerY)
similar to the MapHood function, but will only include indices of locations that are occupiedT
NewAgentPT(double x, double y)
returns an uninitialized agent at the specified coordinatesT
NewAgentPTSafe(double newX, double newY)
returns an uninitialized agent at the specified coordinates, will apply wraparound if the coordinates are outside the domainT
NewAgentPTSafe(double newX, double newY, double fallbackX, double fallbackY)
returns an uninitialized agent at the specified coordinates, will apply wraparound or use the fallback if the coordinates are outside the domainT
NewAgentSQ(int index)
returns an uninitialized agent at the specified indexT
NewAgentSQ(int x, int y)
returns an uninitialized agent at the specified coordinatesint
Pop()
returns the number of agents that are alive in the gridint
PopAt(int i)
gets the population at a specific locationint
PopAt(int x, int y)
gets the population at a specific locationint
PopAt(int x, int y, AgentToBool EvalAgent)
gets the population at a specific location, subsetting to only those for which EvalAgent returns trueint
PopAt(int i, AgentToBool EvalAgent)
gets the population at a specific location, subsetting to only those for which EvalAgent returns trueT
RandomAgent(int x, int y, Rand rn)
returns a single random agent from the provided coordinatesT
RandomAgent(int x, int y, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the provided coordinates forwhich EvalAgent returns trueT
RandomAgent(int i, Rand rn)
returns a single random agent from the provided coordinatesT
RandomAgent(int i, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the provided coordinates forwhich EvalAgent returns trueT
RandomAgent(Rand rn)
gets a random agent from the grid, be careful not to use this during iteration over the gridT
RandomAgentHood(int[] hood, int x, int y, Rand rn)
returns a single random agent from the set of all agents within the specified neighborhoodT
RandomAgentHood(int[] hood, int x, int y, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified neighborhood forwhich EvalAgent returns trueT
RandomAgentHoodMapped(int[] hood, int hoodLen, Rand rn)
returns a single random agent from the set of all agents within the specified neighborhood, assumes the neighborhood has already been mappedT
RandomAgentHoodMapped(int[] hood, int hoodLen, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified neighborhood forwhich EvalAgent returns true, assumes the neighborhood has already been mappedT
RandomAgentRad(double x, double y, double rad, Rand rn)
returns a single random agent from the set of all agents within the specified radiusT
RandomAgentRad(double x, double y, double rad, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified radius forwhich EvalAgent returns trueT
RandomAgentRect(int x, int y, int width, int height, Rand rn)
returns a single random agent from the set of all agents within the specified rectangleT
RandomAgentRect(int x, int y, int width, int height, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified rectangle forwhich EvalAgent returns trueT
RandomAgentSafe(int x, int y, Rand rn)
returns a single random agent, will apply wraparound if the coordiantes are outside of the gridT
RandomAgentSafe(int x, int y, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent that satisfies EvalAgent, will apply wraparound if the coordiantes are outside of the gridvoid
Reset()
calls dispose on all agents in the typeGrid, resets the tick timer to 0.void
ResetHard()
calls dispose on all agents and completely resets the internal agentlist, also resets the tick timer to 0.void
ResetTick()
sets the tick to 0.void
ShuffleAgents(Rand rn)
shuffles the agent list to randomize iteration.int
Xdim()
int
Ydim()
-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface HAL.Interfaces.Grid2D
AlongLineIs, ApplyHood, ApplyHood, ApplyHoodMapped, ApplyRectangle, BoundaryIs, ContainsValidI, ContainsValidI, DispX, DispY, Dist, DistSquared, GetHoodI, I, I, In, In, InWrap, ItoX, ItoY, MapHood, MapHood, MapHood, MapHood, MapI, MapXpt, MapXsq, MapYpt, MapYsq, RandomHoodI, WrapI
-
-
-
-
Constructor Detail
-
AgentGrid2D
public AgentGrid2D(int x, int y, java.lang.Class<T> agentClass, boolean wrapX, boolean wrapY)
pass to the constructor the dimensions of the grid and the agent class type, written T.type where T is the name of the occupying agent class. the wrap booleans specify whether to domain should use wraparound or stop at the boundary
-
AgentGrid2D
public AgentGrid2D(int x, int y, java.lang.Class<T> agentClass)
pass to the constructor the dimensions of the grid and the agent class type, written T.type where T is the name of the occupying agent class.
-
-
Method Detail
-
_PassAgentConstructor
public void _PassAgentConstructor(java.lang.Class<T> agentClass)
meant to be used specifically in conjunction with the LoadState Utils function. LoadState won't by default setup the grid constructor, so this function must be called as well for the loaded grid to be able to create more agents. pass in the same class argument as is normally used by the grid constructor
-
GetAgent
public T GetAgent(int x, int y)
Gets a single agent at the specified grid square, beware using this function with stackable agents, as it will only return one of the stack of agents. This function is recommended for the Unstackable Agents, as it tends to perform better than the other methods for single agent accesses.
-
GetAgent
public T GetAgent(int index)
Gets a single agent at the specified grid square, beware using this function with stackable agents, as it will only return one of the stack of agents. This function is recommended for the Unstackable Agents, as it tends to perform better than the other methods for single agent accesses.
-
GetAgentSafe
public T GetAgentSafe(int x, int y)
Same as GetAgent above, but if x or y are outside the domain, it will apply wrap around if wrapping is enabled, or return null.
-
NewAgentSQ
public T NewAgentSQ(int x, int y)
returns an uninitialized agent at the specified coordinates
-
NewAgentPT
public T NewAgentPT(double x, double y)
returns an uninitialized agent at the specified coordinates
-
NewAgentSQ
public T NewAgentSQ(int index)
returns an uninitialized agent at the specified index
-
NewAgentPTSafe
public T NewAgentPTSafe(double newX, double newY)
returns an uninitialized agent at the specified coordinates, will apply wraparound if the coordinates are outside the domain
-
NewAgentPTSafe
public T NewAgentPTSafe(double newX, double newY, double fallbackX, double fallbackY)
returns an uninitialized agent at the specified coordinates, will apply wraparound or use the fallback if the coordinates are outside the domain
-
CleanShuffle
public void CleanShuffle(Rand rn)
calls CleanAgents, then ShuffleAgents
-
ShuffleAgents
public void ShuffleAgents(Rand rn)
shuffles the agent list to randomize iteration. do not call this while in the middle of iteration
-
CleanAgents
public void CleanAgents()
cleans the list of agents, removing dead ones, may improve the efficiency of the agent iteration if many agents have died do not call this while in the middle of iteration
-
AllAgents
public java.util.List<T> AllAgents()
returns the list of all agents as an unmodifiable list
-
AllDeads
public java.util.List<T> AllDeads()
returns the list of all dead agents as an unmodifiable list
-
GetAgents
public void GetAgents(java.util.ArrayList<T> putHere, int x, int y)
appends to the provided arraylist all agents on the square at the specified coordinates
-
GetAgents
public void GetAgents(java.util.ArrayList<T> putHere, int i)
appends to the provided arraylist all agents on the square at the specified coordinates
-
GetAgents
public void GetAgents(java.util.ArrayList<T> putHere, int x, int y, AgentToBool<T> EvalAgent)
appends to the provided arraylist all agents on the square at the specified coordinates, will subset only agents for which EvalAgent returns true
-
GetAgents
public void GetAgents(java.util.ArrayList<T> putHere, int i, AgentToBool<T> EvalAgent)
appends to the provided arraylist all agents on the square at the specified coordinates, will subset only agents for which EvalAgent returns true
-
GetAgentsSafe
public void GetAgentsSafe(java.util.ArrayList<T> putHere, int x, int y)
appends to the provided arraylist all agents on the square at the specified coordinates, will apply wraparound if the coordinates are outside the domain
-
GetAgentsSafe
public void GetAgentsSafe(java.util.ArrayList<T> putHere, int x, int y, AgentToBool<T> EvalAgent)
appends to the provided arraylist all agents on the square at the specified coordinates forwhich EvalAgent returns true, will apply wraparound if the coordinates are outside the domain
-
GetAgentsRad
public void GetAgentsRad(java.util.ArrayList<T> retAgentList, double x, double y, double rad)
gets all agents that are within rad, and adds them to the ArrayList
-
GetAgentsRad
public void GetAgentsRad(java.util.ArrayList<T> retAgentList, double x, double y, double rad, AgentToBool<T> EvalAgent)
gets all agents that are within rad forwhich EvalAgent returns true, and adds them to the ArrayList
-
GetAgentsRad
public void GetAgentsRad(java.util.ArrayList<T> retAgentList, java.util.ArrayList<double[]> displacementInfo, double x, double y, double rad)
gets all agents that are within rad, and adds them to the ArrayList, displacementInfo contains the following info for each agent: [dist from point,x disp,y disp]
-
GetAgentsRad
public void GetAgentsRad(java.util.ArrayList<T> retAgentList, java.util.ArrayList<double[]> displacementInfo, double x, double y, double rad, AgentToBool<T> EvalAgent)
gets all agents that are within rad forwhich EvalAgent returns true, and adds them to the ArrayList
-
GetAgentsRect
public void GetAgentsRect(java.util.ArrayList<T> retAgentList, int x, int y, int width, int height)
gets all agents within the rectangle argument defined by the bottom corner and the dimension arguments
-
GetAgentsRect
public void GetAgentsRect(java.util.ArrayList<T> retAgentList, int x, int y, int width, int height, AgentToBool<T> EvalAgent)
gets all agents forwhich evalAgent returns true within the rectangle argument defined by the bottom corner and the dimension arguments
-
GetAgentsHood
public void GetAgentsHood(java.util.ArrayList<T> retAgentList, int[] hood, int centerX, int centerY)
gets all agents within the given neighborhood and adds them to the ArrayList argument
-
GetAgentsHood
public void GetAgentsHood(java.util.ArrayList<T> retAgentList, int[] hood, int centerX, int centerY, AgentToBool<T> EvalAgent)
gets all agents within the given neighborhood forwhich EvalAgent returns true and adds them to the ArrayList argument
-
GetAgentsHoodMapped
public void GetAgentsHoodMapped(java.util.ArrayList<T> retAgentList, int[] hood, int hoodLen)
gets all agents in the provided neighborhood, assumes that the neighborhood has already been mapped to a location
-
GetAgentsHoodMapped
public void GetAgentsHoodMapped(java.util.ArrayList<T> retAgentList, int[] hood, int hoodLen, AgentToBool<T> EvalAgent)
gets all agents in the provided neighborhood, assumes that the neighborhood has already been mapped to a location
-
Reset
public void Reset()
calls dispose on all agents in the typeGrid, resets the tick timer to 0.
-
ResetHard
public void ResetHard()
calls dispose on all agents and completely resets the internal agentlist, also resets the tick timer to 0.
-
PopAt
public int PopAt(int i)
gets the population at a specific location
-
PopAt
public int PopAt(int x, int y)
gets the population at a specific location
-
PopAt
public int PopAt(int i, AgentToBool EvalAgent)
gets the population at a specific location, subsetting to only those for which EvalAgent returns true
-
PopAt
public int PopAt(int x, int y, AgentToBool EvalAgent)
gets the population at a specific location, subsetting to only those for which EvalAgent returns true
-
RandomAgent
public T RandomAgent(Rand rn)
gets a random agent from the grid, be careful not to use this during iteration over the grid
-
ApplyAgentsRad
public int ApplyAgentsRad(double rad, double x, double y, AgentRadDispToAction2D<T> action)
applies AgentRadDispToAction2D function to all agents within radius
-
Pop
public int Pop()
returns the number of agents that are alive in the grid
-
MapEmptyHood
public int MapEmptyHood(int[] hood, int centerX, int centerY)
similar to the MapHood function, but will only include indices of locations that are empty
-
MapEmptyHood
public int MapEmptyHood(int[] hood, int centerI)
similar to the MapHood function, but will only include indices of locations that are empty
-
MapOccupiedHood
public int MapOccupiedHood(int[] hood, int centerX, int centerY)
similar to the MapHood function, but will only include indices of locations that are occupied
-
MapOccupiedHood
public int MapOccupiedHood(int[] hood, int centerI)
similar to the MapHood function, but will only include indices of locations that are occupied
-
IterAgentsSafe
public java.lang.Iterable<T> IterAgentsSafe(int x, int y)
Same as IterAgents above, but will apply wraparound if x,y fall outside the grid dimensions.
-
IterAgents
public java.lang.Iterable<T> IterAgents(int x, int y)
iterates over all agents at position
-
IterAgents
public java.lang.Iterable<T> IterAgents(int i)
iterates over all agents at position
-
IterAgentsRad
public java.lang.Iterable<T> IterAgentsRad(double x, double y, double rad)
iterates over all agents within radius
-
IterAgentsRect
public java.lang.Iterable<T> IterAgentsRect(int x, int y, int width, int height)
iterates over all agents in the rectangle defined by (x,y) as the lower left corner, and (x+width,y+height) as the top right corner.
-
IterAgentsHood
public java.lang.Iterable<T> IterAgentsHood(int[] hood, int centerX, int centerY)
iterates over all agents found in a neighborhood after mapping
-
IterAgentsHood
public java.lang.Iterable<T> IterAgentsHood(int[] hood, int centerI)
iterates over all agents found in a neighborhood after mapping
-
IterAgentsHoodMapped
public java.lang.Iterable<T> IterAgentsHoodMapped(int[] hood, int hoodLen)
iterates over all agents found in an already mapped neighborhood
-
RandomAgentSafe
public T RandomAgentSafe(int x, int y, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent that satisfies EvalAgent, will apply wraparound if the coordiantes are outside of the grid
-
RandomAgentSafe
public T RandomAgentSafe(int x, int y, Rand rn)
returns a single random agent, will apply wraparound if the coordiantes are outside of the grid
-
RandomAgent
public T RandomAgent(int x, int y, Rand rn)
returns a single random agent from the provided coordinates
-
RandomAgent
public T RandomAgent(int i, Rand rn)
returns a single random agent from the provided coordinates
-
RandomAgent
public T RandomAgent(int i, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the provided coordinates forwhich EvalAgent returns true
-
RandomAgent
public T RandomAgent(int x, int y, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the provided coordinates forwhich EvalAgent returns true
-
RandomAgentRad
public T RandomAgentRad(double x, double y, double rad, Rand rn)
returns a single random agent from the set of all agents within the specified radius
-
RandomAgentRad
public T RandomAgentRad(double x, double y, double rad, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified radius forwhich EvalAgent returns true
-
RandomAgentRect
public T RandomAgentRect(int x, int y, int width, int height, Rand rn)
returns a single random agent from the set of all agents within the specified rectangle
-
RandomAgentRect
public T RandomAgentRect(int x, int y, int width, int height, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified rectangle forwhich EvalAgent returns true
-
RandomAgentHood
public T RandomAgentHood(int[] hood, int x, int y, Rand rn)
returns a single random agent from the set of all agents within the specified neighborhood
-
RandomAgentHood
public T RandomAgentHood(int[] hood, int x, int y, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified neighborhood forwhich EvalAgent returns true
-
RandomAgentHoodMapped
public T RandomAgentHoodMapped(int[] hood, int hoodLen, Rand rn)
returns a single random agent from the set of all agents within the specified neighborhood, assumes the neighborhood has already been mapped
-
RandomAgentHoodMapped
public T RandomAgentHoodMapped(int[] hood, int hoodLen, Rand rn, AgentToBool<T> EvalAgent)
returns a single random agent from the set of all agents within the specified neighborhood forwhich EvalAgent returns true, assumes the neighborhood has already been mapped
-
iterator
public java.util.Iterator<T> iterator()
- Specified by:
iterator
in interfacejava.lang.Iterable<T extends AgentBaseSpatial>
-
IncTick
public void IncTick()
increments the internal grid tick counter by 1, used with the Age() and BirthTick() functions to get age information about the agents on an AgentGrid. can otherwise be used as a counter with the other grid types.
-
GetTick
public int GetTick()
gets the current grid timestep.
-
ResetTick
public void ResetTick()
sets the tick to 0.
-
-