Convert OrbitPointMotion
Perform orbit element conversions.
Syntax
Convert <ScenarioPath> OrbitPointMotion [Precision <Value>] {FromElementsType} <Elements> {ToElementsType}
Description
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.
There is no conversion of reference frame. The elements are effectively converted in the frame they are entered in.
Keplarian and Equinoctial are more appropriately used in Inertial frames, not Fixed frames.
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.
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 |
Examples
Input a Spherical element set and receive a cartesian set in return (connect distance units are meters):
Return message
Return mu and the Cartesian element set:398600441800000.000000 -41162437.212170 -9136244.420287 1354.798503 666.225530 -3001.612610 0.066404
Examples
Input a Cartesian element set and receive a Keplarian set in return (connect distance units are meters):
Return message
Return mu and the Keplerian element set:398600441800000.000000 42164169.637135 0.000000000000 136.4278768271 0.0022178441 0.0000000000 56.0863877892
Examples
Convert an equinoctial element set to spherical, using the mu value from Earth:
Return message
Return mu and the Spherical element set:398600441800000.000000 91.6266774202 -63.3844871342 6879318.417779 268.1256845619 0.0001204621 10043.525794
Examples
Convert an equinoctial element set to spherical, using the mu value from Earth, returning values with 8 decimal places:
Return message
Return mu and the Spherical element set using a precision of 8:398600441800000.000000 91.62667742 -63.38448713 6879318.41777872 268.125684560.00012046 10043.52579446
Group membership
This command belongs to the following group(s):
Version
10.1