menu
info Documentation

Automation Schedule

The Automation Schedule is a list of scheduled property changes defined in the scenario file that allows the user to automatically modify model object properties at specified simulation times while the simulation is running. These commands follow the same format as the rest of the scenario file, using the same parameter definitions and values.

The Automation Schedule is defined under the AutomationSchedule key within the Settings section of the scenario file. Each entry in the schedule is a ScheduledPropertySet that specifies four fields:

Field Description
Time The simulation time at which the property change should be applied, in ISO 8601 format (e.g. "2025-01-01T12:30:00").
ModelObject The name of the model object whose property should be changed.
Property The name of the property to change.
Value The new value to assign to the property.

Example

The following example shows an AutomationSchedule containing two scheduled property changes on the ExampleSat Thruster model object:

{
  "$type": "D2S2.Simulation.ScenarioFile, D2S2",
  "Settings": {
    "$type": "D2S2.Simulation.SimulationSettings, D2S2",
    "SimulationStart": "2025-01-01T12:00:00",
    "SimulationDuration": "12:00:00",
    "SimulationPeriod": "00:00:00.2000000",
    "RunForever": true,
    "RealTime": false,
    "SamplePeriodMultiplier": 1,
    "SampleList": {
    "AutomationSchedule": {
      "$type": "System.Collections.Generic.List`1[[D2S2.Simulation.ScheduledPropertySet, D2S2]], mscorlib",
      "$values": [
        {
          "$type": "D2S2.Simulation.ScheduledPropertySet, D2S2",
          "Time": "2025-01-01T12:00:00",
          "ModelObject": "ExampleSat Thruster",
          "Property": "DutyCycle",
          "Value": 1
        },
        {
          "$type": "D2S2.Simulation.ScheduledPropertySet, D2S2",
          "Time": "2025-01-01T14:00:00",
          "ModelObject": "ExampleSat Thruster",
          "Property": "DutyCycle",
          "Value": 0
        }
      ]
    }
  },
  ...
}

In this example, the ControlModeSelection property of the ExampleSat Thruster is set to 1 at the simulation start, and then changed to 0 two hours later. It should be noted that for the script the work the scenario has to contain a thruster named "ExampleSat Thruster."