Click or drag to resize

SpecializedOrbitSolverCreateSunSynchronousOrbitUsingAltitude Method

Creates a circular orbit whose right ascension of the ascending node drifts under J2 perturbations at the same rate as the central body's orbit around the Sun (Sun-synchronous). Thus, the orbit would revisit its ascending node at exactly the same local solar time (and therefore the same lighting conditions) every orbit. However, it would revisit its ascending node at differing longitudes with no exact resonance.

Namespace:  AGI.Foundation.Propagators
Assembly:  AGI.Foundation.Models (in AGI.Foundation.Models.dll) Version: 24.1.418.0 (24.1.418.0)
public static J2Propagator CreateSunSynchronousOrbitUsingAltitude(
	JulianDate orbitEpoch,
	ReferenceFrame inertialFrame,
	ReferenceFrame fixedFrame,
	double altitude,
	Duration ascendingNodeLocalTime,
	double gravitationalParameter,
	double j2UnnormalizedValue,
	double referenceDistance,
	double planetaryMeanMotion,
	bool isObliquityLessThan90Degrees


Type: AGI.Foundation.TimeJulianDate
The epoch associated with the initial conditions of the propagated orbit.
Type: AGI.Foundation.GeometryReferenceFrame
An inertial ReferenceFrame centered at the central body.
Type: AGI.Foundation.GeometryReferenceFrame
A fixed ReferenceFrame centered at the central body.
Type: SystemDouble
The distance above the surface of the central body).
Type: AGI.Foundation.TimeDuration
The local solar time of the ascending node in central body seconds past central body midnight.
Type: SystemDouble
The gravitational parameter of the central body.
Type: SystemDouble
The non-normalized J2 parameter of the central body.
Type: SystemDouble
The equatorial radius of the central body that also serves as a reference distance for the J2 parameter.
Type: SystemDouble
The mean motion of the central body about the Sun. (The central body must be orbiting the Sun.)
Type: SystemBoolean
Sets the orbit to be retrograde if true (for Earth and other planets with posigrade rotations but retrograde Sun-synchronous orbits) or posigrade if false (for Uranus with a retrograde rotation but a posigrade Sun-synchronous orbit). Venus also has a retrograde rotation, but does not have strong enough J2 perturbations to support Sun-synchronous orbits.

Return Value

Type: J2Propagator
A J2Propagator object that is initialized at its ascending node with the desired orbit epoch, orbital elements, and gravity field.
ArgumentNullException Thrown if inertialFrame or fixedFrame is .
ArgumentOutOfRangeException Thrown if altitude is negative or if planetaryMeanMotion is less than or equal to zero.
ArithmeticException Thrown if a Sun-synchronous orbit does not exist for the given input conditions.
See Also