alchemist/it.unibo.alchemist.model.reactions/ChemicalNodeReaction

ChemicalNodeReaction

open class ChemicalNodeReaction<T>(node: Node<T>, timeDistribution: TimeDistribution<T>) : AbstractMarkovianNodeReaction<T>

Base for memoryless chemical reactions.

The generic implementation accepts no conditions: concrete chemical families must define their accepted semantic condition types and compute their own rate from typed model state. Construction rejects non-memoryless distributions.

Type Parameters

concentration type

Inheritors

BiochemicalNodeReaction

Constructors

ChemicalNodeReaction

constructor(node: Node<T>, timeDistribution: TimeDistribution<T>)

Properties

actions

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

The Actions executed by this reaction.

canExecute

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.

conditions

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

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

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.

host

override val host: Node<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.

meanDelay

open override val meanDelay: Double

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

nextOccurrence

override val nextOccurrence: Observable<Time>

The absolute Time of the next occurrence.

rate

override val rate: Double

The current rate of the exponentially distributed delays, namely the propensity of this reaction. By default, it is the rate of its ExponentialTime.

timeDistribution

override val timeDistribution: TimeDistribution<T>

The delay distribution governing this reaction's putative occurrences.

Functions

cloneOnNewNode

open override fun cloneOnNewNode(node: Node<T>): ChemicalNodeReaction<T>

Clones this reaction's program on a new node, for example when nodes are created at runtime.

compareTo

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

dispose

open override fun dispose()

Disposes and releases the resources held by this object.

execute

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.

shouldEqual

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

toGraphQLReactionSurrogate

fun <T> NodeReaction<T>.toGraphQLReactionSurrogate(): ReactionSurrogate<T>

Converts a NodeReaction to a ReactionSurrogate.

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

Converts a node-hosted Reaction to a ReactionSurrogate.

toString

open override fun toString(): String

updateSchedulingAfterFiring

override fun updateSchedulingAfterFiring(currentTime: Time)

Refreshes reaction state after firing, then applies firing scheduling policy.

updateSchedulingAfterInvalidation

override fun updateSchedulingAfterInvalidation(currentTime: Time)

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