alchemist-physics/it.unibo.alchemist.model.physics.properties/PhysicalPedestrian2D

PhysicalPedestrian2D

interface PhysicalPedestrian2D<T> : PhysicalPedestrian<T, Euclidean2DPosition, Euclidean2DTransformation, Euclidean2DShapeFactory> (source)

A pedestrian's capability to experience physical forces in a 2D space.

Properties

abstract val comfortArea: Shape<Euclidean2DPosition, Euclidean2DTransformation>

The comfort area of this pedestrian, it's a circle of radius Shape.radius + comfortRay.

abstract val comfortRay: Double

The comfort ray of this pedestrian, this is added to the radius of its Shape to obtain the comfortArea.

abstract val isFallen: Boolean

Whether the pedestrian has fallen and it is thus an obstacle.

abstract val node: Node<T>

rectangleOfInfluence

abstract val rectangleOfInfluence: Shape<Euclidean2DPosition, Euclidean2DTransformation>

Rectangle of influence. When a pedestrian enters this area, the node could experience a tangential avoidance force. See avoid.

Functions

abstract fun avoid(other: Node<T>): Euclidean2DPosition

Computes the repulsion force caused by a node that entered the rectangleOfInfluence. This is derived from the work of Pelechano et al.

avoidanceForces

abstract fun avoidanceForces(): List<Euclidean2DPosition>

Computes the total avoidance force this node is subject to.

checkAndPossiblyFall

abstract fun checkAndPossiblyFall()

Turn this node into a fallen pedestrian if it shouldFall.

abstract fun cloneOnNewNode(node: Node<T>): NodeProperty<T>

fallenAgentAvoidanceForces

abstract fun fallenAgentAvoidanceForces(): List<Euclidean2DPosition>

Computes the avoidance force from a fallen pedestrian.

abstract fun onFall(listener: (Node<T>) -> Unit)

Adds a listener to be called when node falls.

abstract fun physicalForces(environment: PhysicsEnvironment<T, Euclidean2DPosition, Euclidean2DTransformation, Euclidean2DShapeFactory>): List<Euclidean2DPosition>

abstract fun repulse(other: Node<T>): Euclidean2DPosition

Computes the repulsion force caused by a node that entered the comfortArea. This is derived from the work of Pelechano et al.

repulsionForces

abstract fun repulsionForces(): List<Euclidean2DPosition>

Computes the total repulsion force this node is subject to.

abstract fun shouldFall(pushingForces: List<Euclidean2DPosition>): Boolean

Determines if this pedestrian subject to pushingForces should fall. According to the work of Pelechano et al this should happen when the majority of pushing forces affecting one individual are approximately in the same direction and the sum of forces have a magnitude high enough to make it lose equilibrium.