LifetimeElements Constructor

Initialize a set of lifetime orbit elements to represent one orbit pass.

Namespace: AGI.Foundation.Coordinates
Assembly: AGI.Foundation.OrbitPropagation (in AGI.Foundation.OrbitPropagation.dll) Version: 25.1.421.0 (25.1.421.0)

Syntax

C++

Copy

public LifetimeElements(
	JulianDate epoch,
	int orbitCount,
	double semimajorAxis,
	double semimajorAxisRate,
	double eccentricity,
	double eccentricityRate,
	double inclination,
	double inclinationRate,
	double argumentOfPeriapsis,
	double argumentOfPeriapsisRate,
	double rightAscensionOfAscendingNode,
	double rightAscensionOfAscendingNodeRate,
	double siderealPeriod,
	double gravitationalParameter
)

Public Sub New ( 
	epoch As JulianDate,
	orbitCount As Integer,
	semimajorAxis As Double,
	semimajorAxisRate As Double,
	eccentricity As Double,
	eccentricityRate As Double,
	inclination As Double,
	inclinationRate As Double,
	argumentOfPeriapsis As Double,
	argumentOfPeriapsisRate As Double,
	rightAscensionOfAscendingNode As Double,
	rightAscensionOfAscendingNodeRate As Double,
	siderealPeriod As Double,
	gravitationalParameter As Double
)

public:
LifetimeElements(
	JulianDate epoch, 
	int orbitCount, 
	double semimajorAxis, 
	double semimajorAxisRate, 
	double eccentricity, 
	double eccentricityRate, 
	double inclination, 
	double inclinationRate, 
	double argumentOfPeriapsis, 
	double argumentOfPeriapsisRate, 
	double rightAscensionOfAscendingNode, 
	double rightAscensionOfAscendingNodeRate, 
	double siderealPeriod, 
	double gravitationalParameter
)

new : 
        epoch : JulianDate * 
        orbitCount : int * 
        semimajorAxis : float * 
        semimajorAxisRate : float * 
        eccentricity : float * 
        eccentricityRate : float * 
        inclination : float * 
        inclinationRate : float * 
        argumentOfPeriapsis : float * 
        argumentOfPeriapsisRate : float * 
        rightAscensionOfAscendingNode : float * 
        rightAscensionOfAscendingNodeRate : float * 
        siderealPeriod : float * 
        gravitationalParameter : float -> LifetimeElements

Parameters

epoch: Type: AGI.Foundation.Time.JulianDate
The time at periapsis.
orbitCount: Type: System.Int32
The number of orbits, including this one, since the reference epoch.
semimajorAxis: Type: System.Double
Semimajor axis, in meters.
semimajorAxisRate: Type: System.Double
The rate of change of the semimajor axis, in meters per second.
eccentricity: Type: System.Double
Eccentricity.
eccentricityRate: Type: System.Double
The rate of change of the eccentricity, in units per second.
inclination: Type: System.Double
Inclination, in radians.
inclinationRate: Type: System.Double
The rate of change of the inclination, in radians per second.
argumentOfPeriapsis: Type: System.Double
Argument of periapsis, in radians.
argumentOfPeriapsisRate: Type: System.Double
The rate of change of the argument of periapsis, in radians per second.
rightAscensionOfAscendingNode: Type: System.Double
Right ascension of the ascending node, in radians.
rightAscensionOfAscendingNodeRate: Type: System.Double
The rate of change of the right ascension of the ascending node, in radians per second.
siderealPeriod: Type: System.Double
The time required to make one full orbit with respect to inertial space, in seconds.
gravitationalParameter: Type: System.Double
Gravitational parameter (meters cubed per second squared).

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The given elements must represent a closed orbit. The exception is thrown if the eccentricity is negative, not below unity, or if the semimajor axis is not finitely positive. For other orbit types, use ModifiedKeplerianElements.
ArgumentOutOfRangeException	The semimajor axis cannot be zero or nearly zero. Thrown if semimajorAxis is < Epsilon8.
ArgumentOutOfRangeException	Thrown if the inclination is less than zero or greater than Pi radians.

Remarks

The classification of the OrbitType is exact so that if the user wants this instance of KeplerianElements to be classified as a Circular orbit, the eccentricity must be exactly zero. For parabolic or hyperbolic orbits, see ModifiedKeplerianElements.

Reference

LifetimeElements Class

AGI.Foundation.Coordinates Namespace