You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Explore

Known Bugs

 

JIRA ID Summary Recommendation 
GMT-585 Multiple redundant properties/fields for epoch 
GMT-1098 Tab key navigation fails 
GMT-1346 Add ability for user-defined parameters 
GMT-1439 Parameter design for multiple dependency 
GMT-1483 Ability to Calculate and Output Sun Vector to any point 
GMT-1899 Beta Angle is Off by about .003 degrees 
GMT-1933 Earth Fixed RA changed from 0-360 to -180-180 measurement 
GMT-2011 Larger angular momentum errors in 09/15 build 
GMT-2318 STM Parameters are wrong when using Coordinate System other than EarthMJ2000Eq 
GMT-2475 Provide a parameter to check convergence status of a VF13 optimizer 
GMT-2673 User Reported: Parameter Select Dialog Box Silently Changes User's Selected Object 
GMT-2755 ParameterCreateDialog does not close properly after adding string parameter on Mac 

 

Failing Tests

Failing tests listed as of 09/11/2012.

 

JIRA ID Test Summary Rec. 
 

CSParams_UserAsteroid_2Body_VenusFixed

  
 

CSParams_UserComet_2Body_VenusFixed

  
 

CSParams_UserMoon_2Body_VenusFixed

  
 

CSParams_UserPlanet_2Body_VenusFixed

  
 CSParams_Uranus1_2Body_UranusFixed  
 CSParams_Saturn1_2Body_SaturnFixed  
 CSParams_Pluto1_2Body_PlutoFixed  
 CSParams_Neptune1_2Body_NeptuneMJ2000Ec  
 CSParams_Neptune1_2Body_NeptuneFixed  
 CSParams_Hyperbolic_2Body  
 CSParams_GEO_2Body  

 

Other Findings

 

JIRA ID Summary Rec. 
 Inconsistent naming: RadApo/RadPer and VelApoapsis/RadPeriapsis 
 ParameterSelectDialog is badly named 
 ParameterSelectDialog string consistency issues 
 ParameterSelectDialog doesn't remove item from available list once chosen 

 

Requirements

 

ID Requirements 
FRR-38.1.0The system shall allow the user to calculate or set the following object properties with respect to any celestial body in FRR-16:
FRR-38.1.1.01)      Spacecraft and orbit parameters
FRR-38.1.1.11.   Altitude (read only)
FRR-38.1.1.22.   Beta angle (read only)
FRR-38.1.1.33.   C3 energy (read only)
FRR-38.1.1.44.   Eccentric anomaly (read/write)
FRR-38.1.1.55.   Eccentricity (read/write)
FRR-38.1.1.66.   Orbit energy (read only)
FRR-38.1.1.77.    Magnitude of angular momentum (read only)
FRR-38.1.1.88.    Latitude (read only)
FRR-38.1.1.89.    Longitude (read only)
FRR-38.1.1.1010.                     Local sidereal time (read only)
FRR-38.1.1.1111.                     Mean anomaly (read/write)
FRR-38.1.1.1212.                     Mean hour angle (read only)
FRR-38.1.1.1313.                     Mean motion (read only)
FRR-38.1.1.1414.                     Orbit period (read only)
FRR-38.1.1.1515.                     Radius of apogee (read/write)
FRR-38.1.1.1616.                     Radius of perigee (read/write)
FRR-38.1.1.1717.                     Magnitude of position vector (read only)
FRR-38.1.1.1818.                     Orbit semi-latus rectum (read only)
FRR-38.1.1.1919.                     Orbit semi major axis (read/write)
FRR-38.1.1.2020.                     True anomaly (read/write)
FRR-38.1.1.2121.                     Velocity at apoapsis (read only)
FRR-38.1.1.2222.                     Velocity at periapsis (read only)
FRR-38.2.0The system shall allow the user to calculate the following object properties with respect to any coordinate system in FR-xxx:
FRR-38.2.1.01)      Spacecraft and orbit parameters
FRR-38.2.1.11.   Argument of periapsis (read/write)
FRR-38.2.1.22.   Azimuth (read/write)
FRR-38.2.1.33.   B dot T (read only)
FRR-38.2.1.44.   B dot R (read only)
FRR-38.2.1.55.   B vector angle (read only)
FRR-38.2.1.66.   B vector magnitude (read only)
FRR-38.2.1.77.   Declination (read/write)
FRR-38.2.1.88.   Declination of velocity (read/write)
FRR-38.2.1.99.   Flight path angle (read/write)
FRR-38.2.1.1010.                     Hyperbolic anomaly (read/write)
FRR-38.2.1.1111.                     Orbit angular momentum components (read only)
FRR-38.2.1.1212.                     Orbit inclination (read/write)
FRR-38.2.1.1313.                     Orbits transition matrix (read only)
FRR-38.2.1.1414.                     3x3 partitions of Orbit STM (read only)
FRR-38.2.1.1515.                     Right ascension (read/write)
FRR-38.2.1.1616.                     Right ascension of the ascending node (read/write)
FRR-38.2.1.1717.                     Right ascension of velocity (read/write)
FRR-38.2.1.1818.                     Magnitude of velocity (read/write)
FRR-38.2.1.1919.                     Components of velocity (read/write)
FRR-38.2.1.2020.                     Components of position (read/write)
FRR-38.2.1.2121.                     Right Asencsion of Outgoing Aysptote (read/write)
FRR-38.2.1.2222.                     Declination of Outgoing Aysptote (read/write)
FRR-38.3.0The system shall allow the user to calculate the following object properties:
FRR-38.3.1.01)      Spacecraft and orbit parameters
FRR-38.3.1.33.   Spacecraft Angular velocity components (read/write)
FRR-38.3.1.44.   Drag coefficient (read/write)
FRR-38.3.1.55.   SRP coefficient (read/write)
FRR-38.3.1.66.   Direction cosine matrix components ( read/write)
FRR-38.3.1.77.   Drag area (read/write)
FRR-38.3.1.88.   Dry mass (read/write)
FRR-38.3.1.99.   Elapsed days (read only)
FRR-38.3.1.1010.                     Elapsed seconds (read only)
FRR-38.3.1.1111.                     Euler angles for any sequence (read/write)
FRR-38.3.1.1212.                     Euler angle rates for any sequence (read/write)
FRR-38.3.1.1313.                     Quaternion components (read/write)
FRR-38.3.1.1414.                     SRP area (read/write)
FRR-38.3.1.1515.                     Epoch in TAI modified Julian (read/write)
FRR-38.3.1.1616.                     Epoch in TAI Gregorian (read/write)
FRR-38.3.1.1919.                     Epoch in TDB modified Julian (read/write)
FRR-38.3.1.2020.                     Epoch in TDB Gregorian (read/write)
FRR-38.3.1.2121.                     Epoch in TT modified Julian (read/write)
FRR-38.3.1.2222.                     Epoch in TT Gregorian (read/write)
FRR-38.3.1.2323.                     Epoch in UTC modified Julian (read/write)
FRR-38.3.1.2424.                     Epoch in UTC Gregorian (read/write)
FRR-38.3.1.2525.                     Spacecraft total mass (read only)
FRR-38.3.1.2626.                     Modified Rodriguez parameters (read/write)
FRR-38.3.1.2727.                     Euler Angles (read/write)
FRR-38.3.1.2828.                     Euler Angle Rates (read/write)
FRR-38.3.2.02)      Impulsive burn parameters
FRR-38.3.2.11.   Element1 (read/write)
FRR-38.3.2.22.   Element2 (read/write)
FRR-38.3.2.33.   Element3 (read/write)
FRR-38.3.2.44.  Velocity component (read/write)
FRR-38.3.2.55.   Normal component (read/write)
FRR-38.3.2.66.   Binormal component (read/write)
FRR-38.3.3.03)      Tank Properties
FRR-38.3.3.11.   Pressure (read/write)
FRR-38.3.3.22.  Volume (read/write)
FRR-38.3.3.33.   Fuel Density (read/write)
FRR-38.3.3.44.   Fuel Mass (read/write)
FRR-38.3.3.55.   Temperature (read/write)
FRR-38.3.3.66.   RefTemperature (read/write

 

Interface/Functional Spec

Overview 

Data property available for use by commands

Description 

Parameters are named resource properties that can be used to obtain data for use by Mission Sequence commands. Unlike resource fields, which can be set in the initialization portion of a script (or in the GUI's Resources tree),  parameters are derived properties that can only be used to get data, not store it. There is some overlap between the two categories, however: the ECC property of Spacecraft is both a field (i.e. settable during initialization) and a parameter (i.e. usable by Mission Sequence commands).

Parameters are classified as one of three types: central-body-dependent parameters, coordinate-system-dependent parameters, and standalone parameters. Standalone parameters are the simplest type, in that they have no dependencies. The ElapsedSecs parameter of Spacecraft is an example of this; it is simple referenced as Spacecraft.ElapsedSecs.

Central-body-dependent parameters, as the name suggests, have a value that is dependent on the chosen celestial body. The Altitude parameter of Spacecraft is an example of this. To reference this parameter, you must specify a central body, such as Spacecraft.Mars.Altitude. Any built-in central body or user-defined Asteroid, Comet, Moon, or Planet is valid as a dependency.

Likewise, coordinate-system-dependent parameters have a value that is dependent on the chosen coordinate system. The DEC parameter of Spacecraft is an example of this. To reference this parameter, you must specify the name of a CoordinateSystem resource, such as Spacecraft.EarthFixed.DEC. Any default or user-defined CoordinateSystem resource is valid as a dependency.

The nuances of fields and parameters in GMAT are explored in more detail in the script language documentation, and the individual parameters are documented along with the resources their parent resources. The GUI, however, has a parameter selection interface that is common to all parameters. This interface is documented in GUI, below.
 
See Also: Script Language, FuelTank, ImpulsiveBurn, Spacecraft

GUI 

Parameters can be used as input in several places throughout GMAT, such as the ReportFile and XYPlot resources and the If/Else, Propagate, and Report commands. In the GUI, all of these use a common interface called the ParameterSelectDialog that allows for interactive parameter selection. A basic ParameterSelectDialog window looks like the following:

The ParameterSelectDialog window is used to build a parameter, along with any dependencies, for use in a command or resource. Some resources and commands have different requirements for the types of parameters that can be used, so the ParameterSelectDialog can take slightly different forms, depending on where it's used. This section will describe the generic interface, then mention any resource- or command-specific exceptions.

General Usage

The first step in choosing a parameter is to select the object (or resource) type from the Object Type list in the upper right. Five types can appear in this list: Spacecraft, ImpulsiveBurn, Variable, Array, and String.

Once you've selected a type, The Object List box is populated with all existing resources of that type. Use this list to choose the specific resource you'd like to reference.

If the Spacecraft type is selected, the Attached Hardware List appears below the Object List. This list displays any hardware (such as FuelTank resources) attached to the selected Spacecraft. If the Array type is selected, Row and Col boxes appear. Use these to specify a row and column to select an individual array element, or check Select Entire Object to choose the entire array.

Once a resource is selected, the Object Properties list is populated with all available parameters provided by that resource. Some resources, such as instances of Variable or Array, are themselves parameters, so this list remains empty.

Parameters with different dependency types are commingled in the Object Properties list. When you select one, the appropriate dependency (if any) appears below the list. For example, after selecting the Spacecraft AOP parameter, a Coordinate System list appears. After selecting the Spacecraft Apoapsis parameter, a Central Body list appears. And after selecting the Spacecraft Cd parameter, no dependency list appears.

To select a parameter, select the appropriate Object Type, the specific resource from the Object List or Attached Hardware List, the desired parameter from the Object Properties list, and the required dependency, and add it to the Selected Value(s) list on the right. There are six buttons available to control this list:

  • UP: Move the selected item in the Selected Value(s) list up one position (if allowed).
  • DN: Move the selected item in the Selected Value(s) list down one position (if allowed).
  • ->: Add the selected item in the Object Properties list to the Selected Value(s) list.
  • <-: Remove the selected item in the Selected Value(s) list.
  • =>: Add all items to the Selected Value(s) list.
  • <=: Remove all items from the Selected Value(s) list.

When finished, the Selected Value(s) list contains the final selected parameters. Click OK to accept the selection.

Special Considerations

Some resources and commands (such as the Propagate command Parameter argument) only accept a single parameter as input; in this context the ParameterSelectDialog only allows one parameter in the Selected Value(s) list and does not allow use of the UP, DN, and => buttons.

In some instances (such as in the Vary command), only parameters that are also fields (and so can be set in the Mission Sequence) can be used. In this case only the allowed parameters will be shown in the Object Properties list.

In the Propagate command Parameter argument, only parameters of Spacecraft can be used. In this case only Spacecraft will be shown in the Object Type list.

Parameters

These tables will be transferred to the individual resource pages in the final documentation.

C1SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C1
C2SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C2
C3SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C3
C4SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C4
C5SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C5
C6SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C6
C7SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C7
C8SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C8
C9SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C9
C10SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C10
C11SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C11
C12SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C12
C13SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C13
C14SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C14
C15SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C15
C16SpacecraftAttachedObject  (Thruster)YYYThrust Coefficient C16
K1SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K1
K2SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K2
K3SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K3
K4SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K4
K5SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K5
K6SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K6
K7SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K7
K8SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K8
K9SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K9
K10SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K10
K11SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K11
K12SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K12
K13SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K13
K14SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K14
K15SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K15
K16SpacecraftAttachedObject  (Thruster)YYYImpulse Coefficient K16
ThrustDirection1SpacecraftAttachedObject  (Thruster)YYYThrustDirection1
ThrustDirection2SpacecraftAttachedObject  (Thruster)YYYThrustDirection2
ThrustDirection3SpacecraftAttachedObject  (Thruster)YYYThrustDirection3

Spacecraft

Parameter Description
ElapsedSecsSpacecraftYN
ElapsedDaysSpacecraftYN
A1ModJulianSpacecraftYY
A1GregorianSpacecraftYY
TAIModJulianSpacecraftYY
TAIGregorianSpacecraftYY
TTModJulianSpacecraftYY
TTGregorianSpacecraftYY
TDBModJulianSpacecraftYY
TDBGregorianSpacecraftYY
UTCModJulianSpacecraftYY
UTCGregorianSpacecraftYY
XSpacecraftYY
YSpacecraftYY
ZSpacecraftYY
VXSpacecraftYY
VYSpacecraftYY
VZSpacecraftYY
SMASpacecraftYY
ECCSpacecraftYY
INCSpacecraftYY
RAANSpacecraftYY
AOPSpacecraftYY
TASpacecraftYY
MASpacecraftYY
EASpacecraftYY
HASpacecraftYY
MMSpacecraftYN
VelApoapsisSpacecraftYN
VelPeriapsisSpacecraftYN
ApoapsisSpacecraftYN
PeriapsisSpacecraftYN
OrbitPeriodSpacecraftYN
RadApoSpacecraftYY
RadPerSpacecraftYY
C3EnergySpacecraftYN
EnergySpacecraftYN
RMAGSpacecraftYY
RASpacecraftYY
DECSpacecraftYY
VMAGSpacecraftYY
RAVSpacecraftYY
DECVSpacecraftYY
AZISpacecraftYY
FPASpacecraftYY
SemilatusRectumSpacecraftYN
HMAGSpacecraftYN
HXSpacecraftYN
HYSpacecraftYN
HZSpacecraftYN
DLASpacecraftYN
RLASpacecraftYN
AltitudeSpacecraftYN
MHASpacecraftYN
LongitudeSpacecraftYN
LatitudeSpacecraftYN
LSTSpacecraftYN
BetaAngleSpacecraftYN
BdotTSpacecraftYN
BdotRSpacecraftYN
BVectorMagSpacecraftYN
BVectorAngleSpacecraftYN
DCM11SpacecraftYY
DCM12SpacecraftYY
DCM13SpacecraftYY
DCM21SpacecraftYY
DCM22SpacecraftYY
DCM23SpacecraftYY
DCM31SpacecraftYY
DCM32SpacecraftYY
DCM33SpacecraftYY
EulerAngle1SpacecraftYY
EulerAngle2SpacecraftYY
EulerAngle3SpacecraftYY
MRP1SpacecraftYY
MRP2SpacecraftYY
MRP3SpacecraftYY
Q1SpacecraftYN
Q2SpacecraftYN
Q3SpacecraftYN
Q4SpacecraftYN
QuaternionSpacecraftYY
AngularVelocityXSpacecraftYY
AngularVelocityYSpacecraftYY
AngularVelocityZSpacecraftYY
EulerAngleRate1SpacecraftYY
EulerAngleRate2SpacecraftYY
EulerAngleRate3SpacecraftYY
DryMassSpacecraftYY
CdSpacecraftYY
CrSpacecraftYY
DragAreaSpacecraftYY
SRPAreaSpacecraftYY
TotalMassSpacecraftYN
OrbitSTMSpacecraftYN
OrbitSTMASpacecraftYN
OrbitSTMBSpacecraftYN
OrbitSTMCSpacecraftYN
OrbitSTMDSpacecraftYN
  

ImpulsiveBurn

 

ParameterDescription
Element1ImpulsiveBurnYY
Element2ImpulsiveBurnYY
Element3ImpulsiveBurnYY
VImpulsiveBurnYY
NImpulsiveBurnYY
BImpulsiveBurnYY
  

FuelTank

ParameterDescription
FuelMassSpacecraftYY
VolumeSpacecraftYY
FuelDensitySpacecraftYY
PressureSpacecraftYY
TemperatureSpacecraftYY
RefTemperatureSpacecraftYY
DutyCycleSpacecraftYY
ThrustScaleFactorSpacecraftYY
GravitationalAccelSpacecraftYY
  
  

Examples 

Describe the example with a short sentence two and include minimal script for example below

Create Spacecraft aSat;
Create ForceModel aForceModel;
Create Propagator aProp;
aProp.FM              = aForceModel;
aProp.Type            = PrinceDormand78;
aProp.InitialStepSize   = 60;
aProp.Accuracy        = 1e-011;
aProp.MinStep         = 0;
aProp.MaxStep         = 86400;
aProp.MaxStepAttempts = 50;
aProp.StopIfAccuracyIsViolated = true;
 
BeginMissionSequence
 
Propagate aProp(aSat) {aSat.ElapsedDays = .2};

Test Procedures

Assumptions 

If you are making assumptions about how tests will be performed or that other test areas will cover some of this functionality describe that here.

Existing Tests

Describe existing test types using a row for each class of test.

 

PriorityStatusSummary
   
   
   

 

Recommended Additional Tests 

Nominal Tests

 

PriorityStatusSummary
  [for Resources only] Cloning the resource in the Mission Sequence, using all non-default values in all field configurations
   
   

 Edge/Corner/Stres

 

PriorityStatusSummary
   
   
   

 Unique Validation

 

PriorityStatusSummary
   
   
   

Unique Mode Tests

 

PriorityStatusSummary
   
   
   

Unique GUI Tests 

These are tests that are unique to the GUI interface for this feature that are not covered by the standard GUI test template and procedures.

 

PriorityStatusSummary
   
   
   


Contents:

  • No labels