it.unibo.alchemist.model.cognitive.actions.CognitiveAgentWander.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of alchemist-cognitive-agents Show documentation

Abstraction for group of pedestrians capable of influence each other emotionally.

There is a newer version: 35.0.0

Show newest version

/*
 * Copyright (C) 2010-2023, Danilo Pianini and contributors
 * listed, for each module, in the respective subproject's build.gradle.kts file.
 *
 * This file is part of Alchemist, and is distributed under the terms of the
 * GNU General Public License, with a linking exception,
 * as described in the file LICENSE in the Alchemist distribution's top directory.
 */

package it.unibo.alchemist.model.cognitive.actions

import it.unibo.alchemist.model.Environment
import it.unibo.alchemist.model.Node
import it.unibo.alchemist.model.Position2D
import it.unibo.alchemist.model.Reaction
import it.unibo.alchemist.model.cognitive.PedestrianProperty
import it.unibo.alchemist.model.geometry.Euclidean2DTransformation
import it.unibo.alchemist.model.geometry.Vector2D
import it.unibo.alchemist.model.movestrategies.TargetSelectionStrategy
import it.unibo.alchemist.model.physics.environments.Physics2DEnvironment
import it.unibo.alchemist.model.positions.Euclidean2DPosition
import it.unibo.alchemist.util.Iterables.randomElement
import it.unibo.alchemist.util.RandomGenerators.nextDouble
import org.apache.commons.math3.random.RandomGenerator

/**
 * Give the impression of a random walk through the environment targeting an ever changing pseudo-randomly point
 * of a circumference at a given distance and with a given radius from the current node position.
 *
 * @param environment
 *          the environment inside which the node moves.
 * @param pedestrian
 *          the owner of this action.
 * @param randomGenerator
 *          the simulation {@link RandomGenerator}.
 * @param offset
 *          the distance from the node position of the center of the circle.
 * @param radius
 *          the radius of the circle.
 */
open class CognitiveAgentWander(
    private val environment: Physics2DEnvironment,
    reaction: Reaction,
    override val pedestrian: PedestrianProperty,
    protected val randomGenerator: RandomGenerator,
    protected val offset: Double,
    protected val radius: Double,
) : AbstractSteeringActionWithTarget(
    environment,
    reaction,
    pedestrian,
    TargetSelectionStrategy {
        randomGenerator.position(
            environment,
        )
    },
) {

    private val heading by lazy {
        environment.setHeading(node, randomGenerator.random2DVersor(environment));
        { environment.getHeading(node) }
    }

    override fun nextPosition(): Euclidean2DPosition = heading()
        .resized(offset)
        .surrounding(radius)
        .randomElement(randomGenerator)
        .coerceAtMost(maxWalk)

    override fun cloneAction(node: Node, reaction: Reaction) =
        CognitiveAgentWander(environment, reaction, node.pedestrianProperty, randomGenerator, offset, radius)
}

/**
 * Generate a random Euclidean position.
 */
private fun RandomGenerator.position(environment: Environment<*, Euclidean2DPosition>) =
    random2DVersor(environment).let {
        val distance = nextInt()
        Euclidean2DPosition(it.x * distance, it.y * distance)
    }

/**
 * Generate a random Euclidean direction.
 */
private fun  RandomGenerator.random2DVersor(environment: Environment<*, V>): V
    where V : Vector2D, V : Position2D =
    environment.makePosition(nextDouble(-1.0, 1.0), nextDouble(-1.0, 1.0))