alchemist/it.unibo.alchemist.model.protelis.actions/RunProtelisProgram

RunProtelisProgram

class RunProtelisProgram> : Action<Any>

An Action that executes a Protelis program.

Requires the current randomGenerator and environment, a valid ProtelisDevice (device), and the local reaction hosting the computation.

The program can be created using a String (originalProgram), or, alternatively, by providing a ProtelisProgram (program).

retentionTime specifies whether, upon message usage, the received messages should be deleted (assuming a reasonable synchronization among devices) or if they should remain in memory for a specified amount of time. By default, retentionTime is Double.NaN, indicating that messages are deleted upon read.

It is possible to simulate the loss of messages due to a higher connection distance by providing a RealDistribution (packetLossDistance) mapping distances to the loss probability. By default, this feature is disabled.

Constructors

RunProtelisProgram

@JvmOverloads

constructor(randomGenerator: RandomGenerator, environment: Environment<Any, P>, device: ProtelisDevice, reaction: Reaction<Any>, program: ProtelisProgram, retentionTime: Double = Double.NaN)

@JvmOverloads

constructor(randomGenerator: RandomGenerator, environment: Environment<Any, P>, device: ProtelisDevice, reaction: Reaction<Any>, program: ProtelisProgram, retentionTime: Double = Double.NaN, packetLossDistributionName: String, vararg packetLossDistributionParameters: Double)

@JvmOverloads

constructor(randomGenerator: RandomGenerator, environment: Environment<Any, P>, device: ProtelisDevice, reaction: Reaction<Any>, program: String, retentionTime: Double = Double.NaN)

@JvmOverloads

constructor(randomGenerator: RandomGenerator, environment: Environment<Any, P>, device: ProtelisDevice, reaction: Reaction<Any>, program: String, retentionTime: Double = Double.NaN, packetLossDistributionName: String, vararg packetLossDistributionParameters: Double)

Properties

context

open override val context: Context

device

val device: ProtelisDevice

environment

val environment: Environment<Any, P>

executionContext

@Transient

var executionContext: AlchemistExecutionContext

Provides an access to the underlying org.protelis.vm.ExecutionContext.

isComputationalCycleComplete

var isComputationalCycleComplete: Boolean

node

val node: Node<Any>

The Alchemist Node hosting the ProtelisDevice.

originalProgram

val originalProgram: String

outboundDependencies

open override val outboundDependencies: ImmutableListSet<Dependency>

packetLossDistance

val packetLossDistance: RealDistribution?

program

val program: ProtelisProgram

randomGenerator

val randomGenerator: RandomGenerator

reaction

val reaction: Reaction<Any>

retentionTime

val retentionTime: Double

Functions

asMolecule

fun asMolecule(): Molecule

cloneAction

open override fun cloneAction(node: Node<Any>, reaction: Reaction<Any>): RunProtelisProgram

This method allows to clone this action on a new node. It may result useful to support runtime creation of nodes with the same reaction programming, e.g. for morphogenesis.

equals

open operator override fun equals(other: Any?): Boolean

execute

open override fun execute()

Effectively executes this action.

getContext

open override fun getContext(): Context

getOutboundDependencies

open override fun getOutboundDependencies(): ImmutableListSet<Dependency>

hashCode

open override fun hashCode(): Int

prepareForComputationalCycle

fun prepareForComputationalCycle()

Resets the computation status (used for dependency management).

toString

open override fun toString(): String