Class SimulationContext

Represents a simulation context object keeping all relevant information's about the simulation execution itself. E.g., it provides the current simulation tick, step and realtime if set as well as delegates which are invoked to provide an (in tick) initialize process with thread-specific information's (StepExecutionContext.

Inheritance

System.Object

SimulationContext

Implements

ISimulationContext

IDisposable

Namespace: Mars.Interfaces

Assembly: Mars.Interfaces.dll

Syntax

public class SimulationContext : object, ISimulationContext, IDisposable

Constructors

SimulationContext(Int64)

Create a simple simulation context, which is not realtime related.

Declaration

public SimulationContext(long startStep = null)

Parameters

Type	Name	Description
System.Int64	startStep

SimulationContext(TimeSpan, DateTime, Nullable<DateTime>)

Create a simulation context with realtime settings

Declaration

public SimulationContext(TimeSpan oneTickTimeSpan, DateTime startTimePoint = null, DateTime? endTimePoint = null)

Parameters

Type	Name	Description
TimeSpan	oneTickTimeSpan
DateTime	startTimePoint
System.Nullable<DateTime>	endTimePoint

Fields

Id

The identifier of this state

Declaration

public readonly Guid Id

Field Value

Type	Description
Guid

RestartAt

State where to restart the simulation lifecycle or null if no restart is requested

Declaration

public long? RestartAt

Field Value

Type	Description
System.Nullable<System.Int64>

Properties

Active

Indicates the active or inactive state of the simulation workflow loop

Declaration

public bool Active { get; set; }

Property Value

Type	Description
System.Boolean

CurrentStaticDateTime

Declaration

public static DateTime? CurrentStaticDateTime { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

CurrentStaticStep

Gets the currently logical simulation step, which can be accessed anywhere.

Declaration

public static long CurrentStaticStep { get; set; }

Property Value

Type	Description
System.Int64

CurrentStep

Currently logical simulation step that is used

Declaration

public long CurrentStep { get; set; }

Property Value

Type	Description
System.Int64

CurrentTick

Currently simulation system tick of the workflow

Declaration

public long CurrentTick { get; set; }

Property Value

Type	Description
System.Int64

CurrentTimePoint

Realtime time point of the currently executed step

Declaration

public DateTime? CurrentTimePoint { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

EndTimePoint

Gets the ending realtime for the last executed simulation tick.

Declaration

public DateTime? EndTimePoint { get; }

Property Value

Type	Description
System.Nullable<DateTime>

FinalSimulationStep

Gets or sets the simulation action which is performed before a tick is executed This includes StepExecutionContext with information about the current technical execution.

Declaration

public Action<IStepExecutionContext> FinalSimulationStep { get; set; }

Property Value

Type	Description
Action<IStepExecutionContext>

InitSimulationStep

Gets or sets the simulation action which is performed before a tick is executed This includes StepExecutionContext with information about the current technical execution.

Declaration

public Action<IStepExecutionContext> InitSimulationStep { get; set; }

Property Value

Type	Description
Action<IStepExecutionContext>

IsAborted

Indicates whether the simulation was aborted

Declaration

public bool IsAborted { get; set; }

Property Value

Type	Description
System.Boolean

IsFinished

Indicates whether the simulation run is finished

Declaration

public bool IsFinished { get; set; }

Property Value

Type	Description
System.Boolean

IsInitialized

Indicates whether the simulation run was prepared for the first step

Declaration

public bool IsInitialized { get; set; }

Property Value

Type	Description
System.Boolean

IsPaused

Indicates whether the simulation was paused

Declaration

public bool IsPaused { get; set; }

Property Value

Type	Description
System.Boolean

IsPausedCompleted

Indicates whether the paused simulation state is already finished.

Declaration

public bool IsPausedCompleted { get; set; }

Property Value

Type	Description
System.Boolean

IsPrepared

Indicates whether the simulation was prepared and the initial tick=0 was persisted.

Declaration

public bool IsPrepared { get; set; }

Property Value

Type	Description
System.Boolean

IsTimeReferenced

Determines whether the simulation is executed with a reference to time or not

Declaration

public bool IsTimeReferenced { get; }

Property Value

Type	Description
System.Boolean

Iterations

The count of successful executed steps

Declaration

public long Iterations { get; set; }

Property Value

Type	Description
System.Int64

LastAbortDateTime

The model time point where an abortion of the simulation lifecycle was received

Declaration

public DateTime? LastAbortDateTime { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

LastAbortStep

The model step where an abortion of the simulation lifecycle was received

Declaration

public long? LastAbortStep { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

LastAbortTick

The simulation system tick where an abortion of the simulation lifecycle was received

Declaration

public long? LastAbortTick { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

LastDateTime

The last successfully executed model time point

Declaration

public DateTime? LastDateTime { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

LastPauseDateTime

The time point for realtime execution where the a pause of the loop was received or null if no pause was ever received

Declaration

public DateTime? LastPauseDateTime { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

LastPauseStep

The real simulation step where the pause command was received or null if no pause was ever received

Declaration

public long? LastPauseStep { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

LastPauseTick

The simulation system tick where the pause command was received or null if no pause was ever received

Declaration

public long? LastPauseTick { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

LastStep

The successfully executed model step or null if no step was executed

Declaration

public long? LastStep { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

LastTick

The successfully executed system tick beginning at 0 or null if no system tick was executed

Declaration

public long? LastTick { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

Meanwhile

Gets the global accessible realtime timespan of this scenario, describing how long the simulation world lasted so far.

Declaration

public TimeSpan? Meanwhile { get; }

Property Value

Type	Description
System.Nullable<TimeSpan>

OneTickTimeSpan

Gets the global accessible time delta interval for realtime scenarios.

Declaration

public TimeSpan? OneTickTimeSpan { get; }

Property Value

Type	Description
System.Nullable<TimeSpan>

OneTickTimeSpanStatic

Declaration

public static TimeSpan? OneTickTimeSpanStatic { get; set; }

Property Value

Type	Description
System.Nullable<TimeSpan>

RestartFlag

Indicates a restart of the simulation workflow, the workflow itself is active furthermore

Declaration

public bool RestartFlag { get; set; }

Property Value

Type	Description
System.Boolean

ResumeFlag

Indicates that the simulation shall be resumed from the last paused simulation step

Declaration

public bool ResumeFlag { get; set; }

Property Value

Type	Description
System.Boolean

Start2020InSeconds

Generates a simulation context that start on 01-01-2020 and has a delta t of 1 second

Declaration

public static SimulationContext Start2020InSeconds { get; }

Property Value

Type	Description
SimulationContext

StartStep

Gets or sets the optional start step for step-based execution.

Declaration

public long StartStep { get; set; }

Property Value

Type	Description
System.Int64

StartTimePoint

Gets the initializing realtime for simulation tick 0.

Declaration

public DateTime? StartTimePoint { get; }

Property Value

Type	Description
System.Nullable<DateTime>

StepFlag

Indicates whether a simulation step shall be calculated

Declaration

public bool StepFlag { get; set; }

Property Value

Type	Description
System.Boolean

Methods

Dispose()

Declaration

public void Dispose()

Equals(Object)

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
System.Object	obj

Returns

Type	Description
System.Boolean

GetHashCode()

Declaration

public override int GetHashCode()

Returns

Type	Description
System.Int32

SetTick(Int32, Int32)

Sets the current step context to the specified one.

Declaration

public void SetTick(int tick, int delta = 1)

Parameters

Type	Name	Description
System.Int32	tick	The ticks to set for.
System.Int32	delta	The delta timespan of the logical time.

UpdateStep(Int32, Int32)

Updates the clock with the system execution tick by 1, the simulation step by deltaT and the current realtime point by OneTickTimeSpan by one simulation tick.

Declaration

public void UpdateStep(int delta = 1, int steps = 1)

Parameters

Type	Name	Description
System.Int32	delta	The logical delta step for move forward in time.
System.Int32	steps	The amount of steps to update for.

Implements

ISimulationContext

IDisposable