General MissionAnalysis Tool (GMAT)
Documentation Style Example
General Mission Analysis Tool (GMAT): Documentation Style Ex-ample
Introduction
This is an introductory paragraph.
iii
Table of ContentsI. How-tos .................................................................................................................. 1
Reporting Data ................................................................................................... 3Reporting Data During a Propagation Span ................................................... 3
Sample Elements ................................................................................................. 5Miscellaneous elements ................................................................................ 6
II. Tutorials ................................................................................................................ 7Propagating a Spacecraft ...................................................................................... 9
Objective and Overview .............................................................................. 9Configure the Resources .............................................................................. 9Configure the Mission Tree ........................................................................ 12Running the Mission .................................................................................. 13
iv
Part I. How-tos
Table of ContentsReporting Data ........................................................................................................................... 3
Reporting Data During a Propagation Span ........................................................................... 3Sample Elements ......................................................................................................................... 5
Miscellaneous elements ........................................................................................................ 6
IntroductionThis is an introductory paragraph to the how-tos.
How-tos
3
Reporting DataGMAT provides several ways to report mission data (such as altitude or delta-V values) to plaintext files. GMAT can report data at each integration time step in the mission or at specific mis-sion events, such as periapsis passage. The report functionality is controlled via the ReportFileresource and the Report and Toggle commands.
Reporting Data During a Propagation Span
You can report data at each integration step in the mission sequence by creating a ReportFileresource and adding data to it. Starting from the default mission:
1. On the Resources tree, right-click the Output folder, point to Add, and click ReportFile.2. Double-click the ReportFile1 resource.3. In the Parameter List area, click Edit.4. In the Selected Value(s) list, click DefaultSC.EarthMJ2000.X and click <- to remove it
from the list.5. In the Object Properties list, click Altitude and click -> to add it to the Selected Value(s)
list.6. Add DefaultSC.A1ModJulian to the Selected Value(s) list if it doesn’t already exist.7. Click OK, then in the ReportFile - ReportFile1 dialog box, click OK again.8. Click Run. To view the generated report, on the Output tree, double-click ReportFile1.
4
How-tos
5
Sample ElementsTable 1. An example table
Column 1 Column 2
Row 1 Column 1 Row 1 Column 2
Row 2 Column 1 Row 2 Column 2
Row 3 Column 1 Row 3 Column 2
Figure 1. An example small screenshot
Figure 2. An example large screenshot
How-tos Sample Elements
6
Example 1. An example code snippet
Create Spacecraft DefaultSC;GMAT DefaultSC.DateFormat = TAIModJulian;GMAT DefaultSC.Epoch = '21545';GMAT DefaultSC.CoordinateSystem = EarthMJ2000Eq;GMAT DefaultSC.DisplayStateType = Cartesian;GMAT DefaultSC.X = 7100;GMAT DefaultSC.Y = 0;GMAT DefaultSC.Z = 1300;GMAT DefaultSC.VX = 0;GMAT DefaultSC.VY = 7.35;GMAT DefaultSC.VZ = 1;GMAT DefaultSC.DryMass = 850;GMAT DefaultSC.Cd = 2.2;GMAT DefaultSC.Cr = 1.8;GMAT DefaultSC.DragArea = 15;GMAT DefaultSC.SRPArea = 1;
Miscellaneous elements
• A numbered equation:(1)
• An unnumbered equation:
• A cross-reference to Figure 1
Part II. Tutorials
Table of ContentsPropagating a Spacecraft .............................................................................................................. 9
Objective and Overview ...................................................................................................... 9Configure the Resources ...................................................................................................... 9Configure the Mission Tree ................................................................................................ 12Running the Mission .......................................................................................................... 13
IntroductionThis is an introductory paragraph to the tutorials.
Tutorials
9
Propagating a SpacecraftObjective and Overview
In this tutorial, you will learn how to create a Spacecraft and a Propagator, and then propagatethe spacecraft to the desired position - in this example, to orbit perigee, which is the minimumdistance to Earth. The meaning of the term "propagate" here is to simulate the spacecraft orbitalmotion. The basic steps in this tutorial are:
1. Configure theSpacecraft and define its epoch and orbital elements.2. Configure the Propagator.3. Modify the default OrbitView to visualize the spacecraft trajectory.4. Modify the Propagate command to to propagate the spacecraft to the perigee.5. Run the mission and analyze the results.
Configure the Resources
Configure the Spacecraft
In this section, you will rename a Spacecraft and set the Spacecraft's initial epoch and classicalorbital elements. You'll need GMAT open, with the Default Mission loaded. To load the DefaultMission click New Mission in the Toolbar or start a new GMAT session.
Rename the Spacecraft
To rename DefaultSC to Sat.
1. In the Resources Tree, right-click DefaultSC, and select Rename.2. In the Rename dialog box, type Sat .3. Click OK.
Set the Spacecraft Epoch
Now you will set the initial epoch of Sat.
1. In the Resources Tree, double-click on Sat. Click the Orbit tab if it is not already selected.2. In the Epoch Format box, select UTCGregorian. You'll see the value in the Epoch field
change to the UTC Gregorian epoch format.3. In in the Epoch field, type 22 Jul 2014 11:29:10.811.4. Click Apply to save these changes.
Set the Keplerian Orbital Elements
To set the Keplerian oribital elements of Sat:
1. In the StateType box select Keplerian . In Elements list you will see the GUI reconfigureto display to the Keplerian representation.
2. In the SMA box, type 83474.318.3. In the ECC box, type 0.89652.4. In the INC box, type 12.4606.
Tutorials Propagating a Spacecraft
10
5. In the RAAN box, type 112.8362.6. In the AOP box, type 218.9805.7. In the TA box, type 180.8. Compare your configuration with Figure 3 below and fix any differences, and click OK.
At this point, save your work to the disk: In the Toolbar , click the Save button. If this is the firsttime you have saved the mission, you'll be prompted to provide a name and location for the file.
Figure 3. Spacecraft State Setup
Configure the Propagator
In this section you'll rename the Propagator, and configure the force model.
Rename the Propagator
Here you'll rename the propagator with a more descriptive name:
1. In the Resources Tree, double-click DefaultProp, and select Rename.2. In the Rename dialog box, type LowEarthProp.3. Click OK.
Configure the Force Model
Now configure the force model. For this tutorial you will use an Earth 10x10 spherical harmonicmodel, Jacchia-Roberts atmospheric model, solar radiation pressure, and point mass perturba-tions from the Sun and Moon.
Propagating a Spacecraft Tutorials
11
1. In the Resources Tree, double-click LowEarthProp,2. In the Gravity list, type 10 both the Degree box.3. Type 10 in the Order box.4. In Atmosphere Model box, select JacchiaRoberts.5. Click the Select button next to the Point Masses text box. This opens the CelestialBodyS-
elect dialog box.6. In the Available Bodies list, click Sun, then click -> to add Sunto the Selected Bodies list.7. Add Moon (named Luna in GMAT) using the same procedure above.8. Compare your configuration with the figure below and fix any differences.9. Click Use SolarRadiation Pressure to toggle it on.10.Compare your LowEarthProp configuration with Figure 4 below, fix any discrepencies, and
click OK.
Figure 4. Force Model Configuration
Configuring the Orbit View Plot
Below you will configure an Orbit View plot so you can visualize Sat and its trajectory. Theorbit of Sat is highly eccentric. To view the entire orbit in the plot, we need to adjust the settingsof DefaultOrbitView.
1. In the Resources Tree, click on DefaultOrbitView.2. In the three boxes next to ViewPointVector, type the values 30000, -5000, and 5000 respec-
tively.3. In the Drawing Options list, uncheck DrawXY Plane.4. Compare your DefaultOrbitView configuration with Figure 5 below, fix any discrepencies,
and click OK.
Tutorials Propagating a Spacecraft
12
Figure 5. DefaultOrbitView Configuration
Configure the Mission Tree
Configure the Propagate Command
This is the last step in the tutorial before running the mission. Below you will configure a Prop-agate command to propagate (model the motion of) Sat to orbit perigee.
1. Click the Mission tab to bring the Mission Tree to the foreground.2. Double-click on Propagate1.3. In the Stopping Conditions list, right click the (...) button next to Sat.ElapsedSecs to bring
up the Parameter Select Dialog4. In the Object list, select Sat if it is not already selected. This directs GMAT to associate the
stopping condition with the spacecraft Sat.5. In the Object Properties list, double-click Periapsis to add it to the Selected Values list
as shown in Figure 6.6. Click OK.7. Compare your Propagate1 configuration with Figure 7 below, fix any discrepencies, and click
OK.
Propagating a Spacecraft Tutorials
13
Figure 6. Propagate Command Parameter Select Dialog Configuration
Figure 7. Propagate Command Configuration
Running the Mission
Congratulations, you have now configured your first GMAT mission and are ready to run themission and analyze the results.
1. Click the Save button in the Toolbar to save your mission.2. Click the Run button in the Toolbar.
You will see GMAT propagate the orbit and stop at orbit periapsis. Figure 8 below illustrateswhat you should see after correctly completing this tutorial. Here are a few things you can tryto explore the results of this tutorial:
Tutorials Propagating a Spacecraft
14
1. Manipulate the Orbit View plot using your mouse to orient the trajectory so that you can toverify that at the final location the spacecraft is at perigee.
2. Click the Mission Tab to bring the Mission Tree to the foreground.3. Left-click on Propagate1 and select Command Summary to see data on the final state of
Sat.4. What values for longitude and latitude do you see for Sat.5. Are the values for the final longitude and latitude of Sat consistent with the Ground Track
plot Sat?
Figure 8. Orbit View Plot after Mission Run