jadex.extension.envsupport.environment.space3d

Class Space3D

java.lang.Object

jadex.commons.SimplePropertyObject

jadex.commons.meta.TypedPropertyObject

jadex.extension.envsupport.environment.SynchronizedPropertyObject

jadex.extension.envsupport.environment.AbstractEnvironmentSpace

jadex.extension.envsupport.environment.space3d.Space3D

All Implemented Interfaces:

IExtensionInstance, IPropertyObject, ITypedPropertyObject, IEnvironmentSpace

Direct Known Subclasses:

ContinuousSpace3D, Grid3D

public abstract class Space3D
extends AbstractEnvironmentSpace

General 3D space.

Field Summary

Fields

Modifier and Type	Field and Description
static String	BORDER_RELAXED Border relaxed mode.
static String	BORDER_STRICT Border strict mode.
static String	BORDER_TORUS Border torus behavior.
static String	PROPERTY_BORDER The constant for the border property.
static String	PROPERTY_POSITION The constant for the position property.

Method Summary

Methods

Modifier and Type	Method and Description
IVector3	adjustPosition(IVector3 pos) Calculate a position according to the space borders.
IVector1	calculateDistance(IVector1 dx, IVector1 dy, IVector1 dz) Calculate the distance in the space.
IVector3	getAreaSize() Returns the size of the simulated area.
String	getBorderMode() Get the border mode.
IVector1	getDistance(IVector1 pos1, IVector1 pos2, boolean isx) Get the distance between two coordinates (x or y).
IVector1	getDistance(IVector3 pos1, IVector3 pos2) Get the distance between three positions.
ISpaceObject	getNearestObject(IVector3 position, IVector1 maxdist, String type) Returns the nearest object to the given position within a maximum distance from the position.
Set	getNearObjects(IVector3 position, IVector1 maxdist) Retrieve all objects in the distance for a position
Set	getNearObjects(IVector3 position, IVector1 maxdist, IFilter filter) Retrieve all objects in the distance for a position
Set	getNearObjects(IVector3 position, IVector1 maxdist, String type) Retrieve all objects in the distance for a position
IVector3	getRandomPosition(IVector3 distance) Retrieves a random position within the simulation area with a minimum distance from the edge.
Object[]	getSpaceObjects() Get all space objects.
void	initSpaceObject(ISpaceObject ret) Init an object in this space.
void	setAreaSize(IVector3 areasize) Set the area size.
void	setPosition(Object id, IVector3 pos) Set the position of an object.

Methods inherited from class jadex.extension.envsupport.environment.AbstractEnvironmentSpace

addAvatarMappings, addDataConsumer, addDataProvider, addDataView, addDataViewMapping, addEnvironmentListener, addInitialAvatar, addObjectTaskType, addPerceptGenerator, addPerceptProcessor, addPerceptType, addSpaceAction, addSpaceObjectType, addSpaceProcessType, addTaskListener, cancelSpaceAction, componentAdded, componentRemoved, createObjectTask, createPercept, createSpaceObject, createSpaceObjectZombie, createSpaceProcess, destroySpaceObject, getAvatar, getAvatar, getAvatars, getClassLoader, getComponentActionList, getComponents, getDataConsumer, getDataConsumers, getDataProvider, getDataView, getDataViews, getExternalAccess, getFetcher, getOwner, getPerceptList, getPerceptType, getProcesses, getProperty, getSpaceAction, getSpaceObject, getSpaceObject0, getSpaceObjectsByType, getSpaceObjectsCollection, getSpaceProcess, getSpaceProcessNames, getViews, init, initSpace, performSpaceAction, performSpaceAction, removeAvatarMappings, removeDataView, removeEnvironmentListener, removeObjectTask, removeObjectTaskType, removePerceptGenerator, removePerceptProcessor, removePerceptType, removeSpaceAction, removeSpaceObjectType, removeSpaceProcess, removeSpaceProcessType, removeTaskListener, setFetcher, setInitData, setOwner, terminate, waitForTask

Methods inherited from class jadex.extension.envsupport.environment.SynchronizedPropertyObject

addPropertyChangeListener, getMonitor, getPropertyNames, hasProperty, removePropertyChangeListener, setProperty

Methods inherited from class jadex.commons.meta.TypedPropertyObject

getMetaData, getMetaDatas

Methods inherited from class jadex.commons.SimplePropertyObject

getProperties, setProperties, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface jadex.commons.IPropertyObject

getPropertyNames, hasProperty, setProperty

Field Detail

PROPERTY_POSITION

public static final String PROPERTY_POSITION

The constant for the position property.

See Also:

Constant Field Values

PROPERTY_BORDER

public static final String PROPERTY_BORDER

The constant for the border property.

See Also:

Constant Field Values

BORDER_STRICT

public static final String BORDER_STRICT

Border strict mode.

See Also:

Constant Field Values

BORDER_RELAXED

public static final String BORDER_RELAXED

Border relaxed mode.

See Also:

Constant Field Values

BORDER_TORUS

public static final String BORDER_TORUS

Border torus behavior.

See Also:

Constant Field Values

Method Detail

getAreaSize

public IVector3 getAreaSize()

Returns the size of the simulated area.

Returns:

size of the simulated area

setAreaSize

public void setAreaSize(IVector3 areasize)

Set the area size.

Parameters:

areasize - The area size.

getBorderMode

public String getBorderMode()

Get the border mode.

Returns:

the border_mode

initSpaceObject

public void initSpaceObject(ISpaceObject ret)

Init an object in this space.

Overrides:

initSpaceObject in class AbstractEnvironmentSpace

setPosition

public void setPosition(Object id,
               IVector3 pos)

Set the position of an object.

Parameters:

id - The object id.

pos - The object position.

getDistance

public IVector1 getDistance(IVector3 pos1,
                   IVector3 pos2)

Get the distance between three positions.

Parameters:

pos1 - The first position.

pos2 - The second position.

pos3 - The third position.

getDistance

public IVector1 getDistance(IVector1 pos1,
                   IVector1 pos2,
                   boolean isx)

Get the distance between two coordinates (x or y).

Parameters:

pos1 - The first position.

pos2 - The second position.

calculateDistance

public IVector1 calculateDistance(IVector1 dx,
                         IVector1 dy,
                         IVector1 dz)

Calculate the distance in the space.

Parameters:

dx - The distance in x.

dy - The distance in y.

dz - The distance in z.

Returns:

The distance according to the distance metrics of the space.

adjustPosition

public IVector3 adjustPosition(IVector3 pos)

Calculate a position according to the space borders.

getRandomPosition

public IVector3 getRandomPosition(IVector3 distance)

Retrieves a random position within the simulation area with a minimum distance from the edge.

Parameters:

distance - minimum distance from the edge, null or zero for no distance

getNearestObject

public ISpaceObject getNearestObject(IVector3 position,
                            IVector1 maxdist,
                            String type)

Returns the nearest object to the given position within a maximum distance from the position.

Parameters:

position - position the object should be nearest to

maxdist - maximum distance from the position, use null for unlimited distance

Returns:

nearest object's ID or null if none is found

getNearObjects

public Set getNearObjects(IVector3 position,
                 IVector1 maxdist)

Retrieve all objects in the distance for a position

Parameters:

position -

distance -

Returns:

The near objects.

getNearObjects

public Set getNearObjects(IVector3 position,
                 IVector1 maxdist,
                 String type)

Retrieve all objects in the distance for a position

Parameters:

position -

distance -

Returns:

The near objects.

getNearObjects

public Set getNearObjects(IVector3 position,
                 IVector1 maxdist,
                 IFilter filter)

Retrieve all objects in the distance for a position

Parameters:

position -

distance -

Returns:

The near objects.

getSpaceObjects

public Object[] getSpaceObjects()

Get all space objects.

Returns:

All space objects.