alchemist/it.unibo.alchemist.model.physics.environments/Dynamics2DEnvironment

Dynamics2DEnvironment

interface Dynamics2DEnvironment<T> : Physics2DEnvironment<T> , Euclidean2DEnvironment<T>

Any implementing Environment should take care of physical dynamics, in particular collision detection and response. This interface provides some hooks in order to be able to manage some of the node's physical state.

Properties

open val origin: Euclidean2DPosition

abstract val shapeFactory: Euclidean2DShapeFactory

A factory of shapes compatible with this environment.

Functions

addGlobalReaction

abstract fun addGlobalReaction(p0: GlobalReaction<T>)

abstract fun addLayer(p0: Molecule, p1: Layer<T, Euclidean2DPosition>)

abstract fun addNode(p0: Node<T>, p1: Euclidean2DPosition): Boolean

abstract fun addTerminator(p0: Predicate<Environment<T, Euclidean2DPosition>>)

farthestPositionReachable

abstract fun farthestPositionReachable(node: Node<T>, desiredPosition: Euclidean2DPosition, hitboxRadius: Double = getShape(node).radius): Euclidean2DPosition

Computes the farthest position reachable by a node towards a desiredPosition, avoiding node overlapping. If no node is located in between, desiredPosition is returned. Otherwise, the first position where the node collides with someone else is returned. For collision purposes, hitboxes are used: each node is given a circular hitbox of radius equal to its shape's radius (shapeless nodes can't cause overlapping). The client can specify a different radius for the hitbox of the moving node.

abstract fun getDimensions(): Int

getDistanceBetweenNodes

abstract fun getDistanceBetweenNodes(p0: Node<T>, p1: Node<T>): Double

getGlobalReactions

abstract fun getGlobalReactions(): ListSet<GlobalReaction<T>>

abstract fun getHeading(node: Node<T>): Euclidean2DPosition

Gets the heading of a node as a direction vector.

@Nonnull

abstract fun getIncarnation(): Incarnation<T, Euclidean2DPosition>

abstract fun getLayer(p0: Molecule): Optional<Layer<T, Euclidean2DPosition>>

abstract fun getLayers(): ListSet<Layer<T, Euclidean2DPosition>>

abstract fun getLinkingRule(): LinkingRule<T, Euclidean2DPosition>

getNeighborhood

abstract fun getNeighborhood(p0: Node<T>): Neighborhood<T>

abstract fun getNodeByID(p0: Int): Node<T>

abstract fun getNodeCount(): Int

abstract fun getNodes(): ListSet<Node<T>>

abstract fun getNodesWithin(shape: Shape<Euclidean2DPosition, Euclidean2DTransformation>): List<Node<T>>

Gets all nodes whose shape.intersect is true for the given shape.

getNodesWithinRange

abstract fun getNodesWithinRange(p0: Node<T>, p1: Double): ListSet<Node<T>>

abstract fun getNodesWithinRange(p0: Euclidean2DPosition, p1: Double): ListSet<Node<T>>

abstract fun getOffset(): DoubleArray

@Nonnull

abstract fun getPosition(p0: Node<T>): Euclidean2DPosition

abstract fun getShape(node: Node<T>): Shape<Euclidean2DPosition, Euclidean2DTransformation>

Gets the shape of a node relatively to its position and heading in the environment.

abstract fun getSimulation(): Simulation<T, Euclidean2DPosition>

abstract fun getSize(): DoubleArray

getSizeInDistanceUnits

abstract fun getSizeInDistanceUnits(): DoubleArray

abstract fun getVelocity(node: Node<T>): Euclidean2DPosition

Get node's current linear velocity.

abstract fun isTerminated(): Boolean

abstract operator override fun iterator(): MutableIterator<Node<T>>

abstract fun makePosition(vararg p0: Number): Euclidean2DPosition

abstract fun makePosition(vararg coordinates: Double): Euclidean2DPosition

open fun makePosition(x: Double, y: Double): Euclidean2DPosition

open fun moveNode(node: Node<T>, direction: Euclidean2DPosition)

moveNodeToPosition

@Nonnull

abstract fun moveNodeToPosition(@Nonnull p0: Node<T>, @Nonnull p1: Euclidean2DPosition)

fun <R> Iterable<R>.randomElement(randomGenerator: RandomGenerator): R

Returns a random element of the Iterable using the provided randomGenerator.

removeGlobalReaction

abstract fun removeGlobalReaction(p0: GlobalReaction<T>)

abstract fun removeNode(p0: Node<T>)

abstract fun setHeading(node: Node<T>, direction: Euclidean2DPosition)

Sets the heading of a node.

abstract fun setLinkingRule(p0: LinkingRule<T, Euclidean2DPosition>)

abstract fun setSimulation(p0: Simulation<T, Euclidean2DPosition>)

abstract fun setVelocity(node: Node<T>, velocity: Euclidean2DPosition)

Set node's current linear velocity.

fun <R> Iterable<R>.shuffled(randomGenerator: RandomGenerator): Iterable<R>

Fisher–Yates shuffle algorithm using a RandomGenerator. More information on Wikipedia.

subscriptionMonitor

fun <T, P : Position<out P>> Environment<T, P>.subscriptionMonitor(): EnvironmentSubscriptionMonitor<T, P>

Returns the EnvironmentSubscriptionMonitor of this Environment.

toGraphQLEnvironmentSurrogate

fun <T, P : Position<out P>> Environment<T, P>.toGraphQLEnvironmentSurrogate(): EnvironmentSurrogate<T, P>

Converts an Environment to a EnvironmentSurrogate.

abstract fun updatePhysics(elapsedTime: Double)

Compute any collision response and update node positions.