Perform orbit element conversions.
Convert <ScenarioPath> OrbitPointMotion [Precision <Value>] {FromElementsType} <Elements> {ToElementsType}
Convert one set of orbit elements into another. Valid values for {ToElementsType} and {FromElementsType} are Cartesian, Equinoctial, Keplerian, Spherical.
Use the Precision <Value> option to specify the precision of the returned data. <Value> is an integer from 0 to 20. The Precision option does not effect the returned mu value.
Note: There is no conversion of reference frame. The elements are effectively converted in the frame they are entered in.
Hint: Keplarian and Equinoctial are more appropriately used in Inertial frames, not Fixed frames.
Hint: The entered <mu> value be must be within 800000.0 m^3/sec^2 of Earth mu value. In place of the <mu> value a Central Body name can be entered. The <mu> value will then be obtained from the specified Central Body.
Hint: The precision for entered data is limited to 20 decimal places.
The following table decribes the elements that are entered and returned for the specific element types.
| ElementsType | <Elements> | Description |
|---|---|---|
| Cartesian | <mu> <X> <Y> <Z> <vX> <vY> <vZ> | <mu> is entered/returned in
Connect distance units cubed.
All other values are entered/returned using Connect distance units. |
| Equinoctial | <mu> <SemimajorAxis> <h> <k> <p> <q> <lambda> {Retrograde | Posigrade} | <mu> is entered/returned in
Connect distance units cubed.
<SemimajorAxis> is entered/returned using Connect distance units. The entered value be must >= 0.001 <h> and <k> must be >= -1.0 and <= 1.0 <lambda> is entered/returned in degrees and must be >= -360.0 and <= 360.0 degrees. |
| Keplerian | <mu> <Periapse> <Eccentricity> <RAAN> <Inclination> <ArgOfPerigee> <TrueAnom> | <mu> is entered/returned in
Connect distance units cubed;
<Periapse> is entered/returned using Connect distance units. The entered value be must > 0.0 <Eccentricity> must be >= 0.0 and < 1.0 <RAAN> is entered/returned in degrees and must be >= -180.0 and <= 360.0 degrees. <Inclination> is entered/returned in degrees and must be >= 0.0 and <= 180.0 degrees. <ArgOfPerigee> is entered/returned in degrees and must be >= 0.0 and <= 360.0 degrees. <TrueAnom> is entered/returned in degrees and must be >= -180.0 and <= 360.0 degrees. |
| Spherical | <mu> <RightAscension> <Declination> <Radius> <FlightPathAzimuth> <HorizontalFlightPathAngle> <Velocity> | <mu> is entered/returned in
Connect distance units cubed;
<RightAscension> is entered/returned in degrees and must be >= -180.0 and <= 360.0 degrees. <Declination> is entered/returned in degrees and must be >= -90.0 and <= 90.0 degrees. <Radius> is entered/returned using Connect distance units and must be > 0.0 <FlightPathAzimuth> is entered/returned in degrees and must be >= -180.0 and <= 360.0 degrees. <HorizontalFlightPathAngle> is entered/returned in degrees and must be >= -90.0 and <= 90.0 degrees. <Velocity> is entered/returned using Connect distance units over Connect time units and must be >= 0.0 |
Input a Spherical element set and receive a cartesian set in return (connect distance units are meters):
Convert * OrbitPointMotion SPHERICAL 3.986004418E+14 192.514264 0.001841 42164169.637128 89.9987625709908 0 3074.6600988768 CARTESIAN
398600441800000.000000 -41162437.212170 -9136244.420287 1354.798503 666.225530 -3001.612610 0.066404
Input a Cartesian element set and receive a Keplarian set in return (connect distance units are meters):
Convert * OrbitPointMotion Cartesian 3.986004418E+14 -41162437.1170865 -9136244.84875818 1354.4628705525 666.225561395869 -3001.61260351279 6.64040812431711E-02 Keplerian
398600441800000.000000 42164169.637135 0.000000000000 136.4278768271 0.0022178441 0.0000000000 56.0863877892
Convert an equinoctial element set to spherical, using the mu value from Earth:
Convert * OrbitPointMotion Equinoctial Earth 26553374.572 -0.7409 -0.0060732 -0.005062 0.61759 269.530382 Retrograde Spherical
398600441800000.000000 91.6266774202 -63.3844871342 6879318.417779 268.1256845619 0.0001204621 10043.525794
Convert an equinoctial element set to spherical, using the mu value from Earth, returning values with 8 decimal places:
Convert * OrbitPointMotion Precision 8 Equinoctial Earth 26553374.572 -0.7409 -0.0060732 -0.005062 0.61759 269.530382 Retrograde Spherical
398600441800000.000000 91.62667742 -63.38448713 6879318.41777872 268.125684560.00012046 10043.52579446
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1