alchemist-incarnation-protelis/it.unibo.alchemist.model.protelis/AlchemistExecutionContext

AlchemistExecutionContext

class AlchemistExecutionContext>(val environmentAccess: Environment<Any, P>, node: Node<Any>, protelisDevice: ProtelisDevice, reaction: Reaction<Any>, val randomGenerator: RandomGenerator, networkManager: AlchemistNetworkManager) : AbstractExecutionContext<AlchemistExecutionContext> , SpatiallyEmbeddedDevice<Double> , LocalizedDevice, TimeAwareDevice<Number> (source)

Execution context that bridges the Alchemist simulation and the Protelis VM.

This class provides Protelis with the device identity, coordinates, timing and network-related information retrieved from the hosting Alchemist simulation objects.

Parameters

node

the local node hosting this execution context

protelisDevice

the device wrapper exposing node properties to Protelis

reaction

the reaction hosting the running Protelis program

networkManager

the network manager used to share state among neighbouring devices

Type Parameters

the position type used by the environment

Constructors

AlchemistExecutionContext

constructor(environmentAccess: Environment<Any, P>, node: Node<Any>, protelisDevice: ProtelisDevice, reaction: Reaction<Any>, randomGenerator: RandomGenerator, networkManager: AlchemistNetworkManager)

constructor(environment: Environment<Any, P>, localNode: Node<Any>, reaction: Reaction<Any>, random: RandomGenerator, networkManager: AlchemistNetworkManager)

Types

Companion

object Companion

Internal constants.

Properties

coordinates

open override val coordinates: Tuple

currentTime

open override val currentTime: Double

deltaTime

open override val deltaTime: Number?

devicePosition

val devicePosition: P

The device position, in form of Position.

deviceUID

open override val deviceUID: DeviceUID

environmentAccess

val environmentAccess: Environment<Any, P>

Experimental access to the simulated environment, for building oracles.

executionEnvironment

override val executionEnvironment: ExecutionEnvironment?

randomGenerator

val randomGenerator: RandomGenerator

The internal random generator used by the execution context.

storedState

override val storedState: Map<CodePath?, Any?>?

Functions

buildField

fun <T : Any?, R : Any?> buildField(computeValue: Function<T?, R?>?, localValue: T?): Field<R?>?

buildFieldDeferred

fun <T : Any?, R : Any?> buildFieldDeferred(computeValue: Function<T?, R?>?, currentLocal: T?, toBeSent: Supplier<T?>?): Field<R?>?

commit

fun commit()

distanceTo

fun distanceTo(target: Int): Double

fun distanceTo(target: DeviceUID?): Double

Computes the distance between two nodes, through Environment.getDistanceBetweenNodes.

equals

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

getCoordinates

open override fun getCoordinates(): Tuple

getCurrentTime

open override fun getCurrentTime(): Double

getDeltaTime

open fun getDeltaTime(): Number?

getDeviceUID

open override fun getDeviceUID(): DeviceUID

getExecutionEnvironment

fun getExecutionEnvironment(): ExecutionEnvironment?

getPersistent

fun getPersistent(ifAbsent: Supplier<P?>?): P?

getVariable

fun getVariable(name: Reference?): Any?

hashCode

open override fun hashCode(): Int

nbrDelay

open override fun nbrDelay(): Field<Number>

nbrLag

open override fun nbrLag(): Field<Number>

nbrRange

open override fun nbrRange(): Field<Double>

nbrVector

open override fun nbrVector(): Field<Tuple>

newCallStackFrame

fun newCallStackFrame(vararg id: Byte)

fun newCallStackFrame(vararg id: Int)

nextRandomDouble

open override fun nextRandomDouble(): Double

putMultipleVariables

fun putMultipleVariables(map: Map<Reference?, *>?)

putVariable

fun putVariable(name: Reference?, value: Any?)

restrictDomain

fun restrictDomain(@Nonnull f: Field<*>): AlchemistExecutionContext?

returnFromCallFrame

fun returnFromCallFrame()

routingDistance

fun routingDistance(dest: GeoPosition): Double

fun routingDistance(dest: Node<Any>): Double

fun routingDistance(dest: Number): Double

fun routingDistance(dest: Tuple): Double

Computes the distance along a map. Requires a MapEnvironment.

runInNewStackFrame

fun <T : Any?> runInNewStackFrame(id: Int, operation: Function<ExecutionContext?, T?>?): T?

setGloballyAvailableReferences

fun setGloballyAvailableReferences(knownFunctions: Map<Reference?, *>?)

setPersistent

fun setPersistent(o: Any?)

setup

fun setup()