alchemist/it.unibo.alchemist.model.physics.reactions/PhysicsUpdate

PhysicsUpdate

class PhysicsUpdate<T>(val environment: Dynamics2DEnvironment<T>, val timeDistribution: TimeDistribution<T> = DiracComb(DEFAULT_RATE)) : AbstractReaction<T> , TimeDistributedReaction<T>

A reaction hosted by a Dynamics2DEnvironment, advancing its physics at every occurrence. Without an explicit timeDistribution or rate, it fires 30 times per time unit; environments may install their own instance with a different rate (EnvironmentWithDynamics uses a rate of 1, unless the simulation provides one).

Constructors

constructor(environment: Dynamics2DEnvironment<T>, timeDistribution: TimeDistribution<T> = DiracComb(DEFAULT_RATE))

constructor(environment: Dynamics2DEnvironment<T>, updateRate: Double)

Properties

open override var actions: List<Action<T>>

The Actions executed by this reaction.

open override val canExecute: Observable<Boolean>

Observes whether the reaction procedure can be selected and executed by the engine. This observable emits updates when that state changes. Reactions whose procedure includes checking occurrence-time conditions may remain executable even when those conditions will suppress their model effects.

open override var conditions: List<Condition<T>>

The Conditions interpreted by this reaction's scheduling and execution policy.

val environment: Dynamics2DEnvironment<T>

The physics environment advanced by this reaction.

finitePositiveMeanDelayOrError

open val finitePositiveMeanDelayOrError: Double

The current meanDelay, for consumers requiring it to be finite and positive, such as those converting speeds into per-occurrence movements.

open override val host: Dynamics2DEnvironment<T>

The model entity hosting this reaction, fixed for the lifetime of the reaction. A host only registers reactions whose host is the host itself.

open override val meanDelay: Double

The expected delay between two occurrences of this reaction in the current model state.

override val nextOccurrence: Observable<Time>

The absolute Time of the next occurrence.

timeDistribution

open override val timeDistribution: TimeDistribution<T>

The delay distribution governing this reaction's putative occurrences.

Functions

operator override fun compareTo(other: Reaction<T>): Int

open override fun dispose()

Disposes and releases the resources held by this object.

open override fun execute()

Prepares valid conditions, applies the model mutation, and advances surviving distributed reactions.

initializationComplete

override fun initializationComplete(atTime: Time, environment: Environment<T, *>)

Initializes reactive inputs after the model has been fully assembled.

infix fun Reaction<*>.shouldEqual(other: Reaction<*>)

toGraphQLReactionSurrogate

fun <T> Reaction<T>.toGraphQLReactionSurrogate(host: Node<T>): ReactionSurrogate<T>

Converts a node-hosted Reaction to a ReactionSurrogate.

open override fun toString(): String

updateSchedulingAfterFiring

open override fun updateSchedulingAfterFiring(currentTime: Time)

Advances distribution-backed scheduling after successful execution at currentTime.

updateSchedulingAfterInvalidation

override fun updateSchedulingAfterInvalidation(currentTime: Time)

Refreshes this reaction's scheduling after one or more observed model inputs changed.