menu
info Documentation

Tutorial 3: Simulating a sequence

Welcome to the third tutorial of the Dawn Dusk Satellite Simulator (D2S2) tutorial series. In this session, our emphasis will be on simulating the scenario developed in the preceding tutorials. It is essential to have completed Tutorial 1 and 2, as they serve as prerequisites for this session. You shall learn how to run the simulation, view the simulation animation and results, as well as save simulation results as a .csv file. Additionally, we shall perform a ground station access time analysis.

Running the simulation

We shall now simulate the orbit of the satellite created in the previous section, then explore different simulation views.

  1. Go to Simulation View.
  2. Under Display Options, make sure that Show Orbits is selected.

The D2S2 screen should now be similar to Figure 1, with an enlarged satellite, and its orbit as a white line.

Figure 1: Screen capture corresponding to steps 1 and 2. The Show Orbits button is circled.

  1. Go to Simulation Options at the top of the screen and select 6 hours as the simulation duration.
  2. Click Run Simulation .

Figure 2: Screen capture corresponding to steps 3 and 4. The simulation options, run simulation, and reset simulation buttons are circled.

Viewing the simulation animation

Following the simulation run, you can replay it using the video player-like interface located at the bottom of the screen. Figure 3 shows an annotated screenshot that highlights the relevant controls.

Figure 3: Screen capture showing the relevant playback controls.

  1. Increase the playback speed to maximum , then go to the start of the simulation and resume playback.

So far, we have viewed the simulation from an inertial reference frame. However, we could also view the satellite’s trajectory projected onto a map of the Earth or have the camera track the satellite. For more information on the camera views, see reference coordinate frames.

  1. Go to Camera and select Map view 2D camera .
  2. Reset the simulation playback as in step 5, then inspect the playback of the simulation in this view (see Figure 4).

Figure 4: Screen capture corresponding to steps 6 and 7. The map view is enabled by pressing the encircled map view button.

Next, we shall view the simulation with the camera fixed to the satellite.

  1. Select SimSat from the drop down satellite selection menu on the top toolbar.
  2. Press the Orbit camera button.
  3. Replay the simulation animation while inspecting the satellite view.

Figure 5: Screen capture corresponding to steps 8 to 10. The orbit camera view is enabled by making the encircled selections.

Saving the simulation results

Now that we have explored the various views, we are prepared to capture the simulation data in a .csv format. While it is possible to record any aspect of the simulation study, for simplicity, we will start by only saving the position (x, y, and z) of the satellite. To achieve this,

  1. Select the SimSat by either:
  • Selecting the orbit camera view (see steps 8 and 9), then clicking on SimSat (see Figure 6 left), or - Selecting SimSat from the model view simulation model tree (see Figure 6),

Figure 6: Screen capture corresponding to step 11. These are via the orbital view (top), and the simulation model tree (bottom).

After selecting SimSat, its input and state will appear on the right-hand side of the screen as in Figure 6.

  1. In the Input window, go to Satellite Kinematic State, then select Position. A graph showing the X, Y, and Z position of the satellite as a function of time appears beneath the Input window.
  2. Click Save CSV to save the simulation results.

Figure 6: Screen capture corresponding to steps 12 and 13. The SimSat state is shown, and the save .csv button is circled.

Ground station access time analysis

As a final exercise, we perform an analysis to determine the time that the satellite has access to the ground station over the 6-hour simulation window. Access time is defined as one if the satellite conforms to a certain elevation limit from a ground target, and zero otherwise. This limit corresponds to the Minimum Elevation Input property.

  1. Ensure that the simulation has run its course until the 6 hour mark.
  2. Select the ground station (using either the simulation or model view).
  3. In the Longyearbyen State tab, select Satellite Visibility.

The plot view now shows a function of the satellite visibility over time, as in Figure 7.

Figure 7: The plot view showing the ground station access time.

Congratulations! You have run and saved the results of your first D2S2 simulation. In the next tutorial (coming soon), we shall create the SimSat mission power budget.