it.unibo.alchemist.model.actions.LevyWalk.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of alchemist-euclidean-geometry Show documentation

Alchemist geometric components for Euclidean spaces

There is a newer version: 35.0.3

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.actions

import it.unibo.alchemist.model.Environment
import it.unibo.alchemist.model.Node
import it.unibo.alchemist.model.Reaction
import it.unibo.alchemist.model.positions.Euclidean2DPosition
import org.apache.commons.math3.distribution.ParetoDistribution
import org.apache.commons.math3.random.RandomGenerator

/**
 * Selects a target based on a random direction extracted from [randomGenerator],
 * and a random distance extracted from a [ParetoDistribution] of parameters [scale] and [shape].
 * Moves toward the targets at a constant [speed] and changes targets on collision.
 */
class LevyWalk @JvmOverloads constructor(
    node: Node,
    reaction: Reaction,
    environment: Environment,
    randomGenerator: RandomGenerator,
    speed: Double,
    private val scale: Double = 1.0, // default parameters for the Pareto distribution
    private val shape: Double = 1.0,
) : GenericRandomWalker(
    node,
    reaction,
    environment,
    randomGenerator,
    speed,
    ParetoDistribution(randomGenerator, scale, shape),
) {
    override fun cloneAction(node: Node, reaction: Reaction) =
        LevyWalk(node, reaction, environment, randomGenerator, speed, scale, shape)
}