HPOP Drag
Set options for modeling drag for the HPOP propagator.
Syntax
HPOP <ObjectPath> Drag {DragState} <Coeff> <AreaMassRatio> {"AtmDensModel"} [{LowAltAtmDensityMdl} <DensityBlendingAltRange>]
Related commands
Description
The HPOP Drag command enables you to set drag model options for propagating a satellite's or missile's orbit using the high-precision orbit propagator (HPOP) module.
This command is valid for Satellites and Missiles.
{DragState} can be On or Off.
If {DragState} is On, enter <Coeff>, <AreaMassRatio> and {"AtmDensModel"}.
<Coeff> is a real number between -100.0 and 100.0.
<AreaMassRatio> is a real number between 0.0 and 9999.0, and you enter it in m^2/kg.
Valid values for {"AtmDensModel"} and their associated <Parameters> are outlined in the Table below. The table also lists the object(s) for which each model is valid. For missiles, you can only use atmosphere models that are valid to the ground.
Enter {LowAltAtmDensityMdl} and <DensityBlendingAltRange> to specify values for low-altitude atmospheric density model. If included, you must enter both values.
{LowAltAtmDensityMdl} is the lower-altitude atmospheric density model. Valid values are "MSISE 1990" and "NRLMSISE 2000".
<DensityBlendingAltRange> is the range of overlap for which the density models will be blended. This is a real number between 0.0 and 1000.0km. Enter the value in Connect distance units.
If {DragState} is Off, you should not enter any other values.
| {"AtmDensModel"} | <Parameters> | Valid for: |
|---|---|---|
| "Harris-Priester" | You can set additional values manually or via a flux/geomag file:
| Satellite, Missile |
| "1976 Standard" | N/A | Satellite, Missile |
| "Jacchia 1960" | N/A | Satellite, Missile |
| "Jacchia 1971" | You can set additional values manually or via a flux/geomag file:
| Satellite |
| "Jacchia 1970" | Satellite | |
| "Jacchia-Roberts" | Satellite | |
| "CIRA 1972" | Satellite | |
| "NRLMSISE 2000" | Satellite, Missile | |
| "MSISE 1990" | Satellite, Missile | |
| "MSIS 1986" | Satellite | |
| "DTM 2012" | Satellite | |
| "DTM 2020" | Satellite | |
| "<UserModelName>" | "<FilePath>" | Satellite |
| "DensityModelPlugin" | "<DisplayName>" "<XMLConfigurationSettings>"
You can set additional values manually or via a flux/geomag file:
If you do not provide plugin configuration settings, you must still send an empty string "<?xml/>" as part of the Connect command. The plugin's configuration settings are stored in a specific XML format, the same format used when saved as part of the Satellite file. That format uses a quote character (") for certain attribute values. You must escape these quote characters by replacing them with the escape sequence or else the command parser will become confused. The escape sequence is an ampersand followed by the letters quot. While not required, you may replace all XML special characters (< >' "&) by their XML escape sequences, although the only required character to be escaped is the quote character ("). | Satellite, Missile |
<DailyF10.7> and <AverageF10.7> are real numbers between 40 and 10000.
<GeoMagIndex> is a real number between 0.0 and 10.0.
The only valid "<UserModelName>" is "SampleDensFunc".
For this command to be valid, the satellite or missile must already be defined as using the HPOP propagator.
To set additional drag model options, see the HPOP Options command.
"<FilePath>" is the path to a file on your local drive.
Examples
To turn on the Harris-Priester drag model for the ERS1 satellite with a coefficient of 1.04 and an area/mass ratio of 0.22:
To turn on the MSISE 1990 drag model with a coefficient of 2.08 and an area/mass ratio of 0.175:
To turn on the Jacchia 1971 drag model specifying a flux file:
To use a user-defined atmosphere drag model by specifying a flux file:
To set a low-altitude atmosphere model with a blending range of 90000.0 m:
To set a density model plugin without specifying any configuration settings:
To set a density model plugin and also specify optional configuration settings for that plugin:
This command example is not completely correct. You actually need to replace both quote characters (") around "Earth" with the escape sequence, which is an ampersand followed by the letters quot.
Return message
If activated, Connect returns an acknowledgement message.Group membership
This command belongs to the following group(s):
Version
12.10