Click or drag to resize

SpecializedOrbitSolverCreateSunSynchronousOrbitUsingInclination 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 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.2.419.0 (24.2.419.0)
Syntax
Copy
public static J2Propagator CreateSunSynchronousOrbitUsingInclination(
	JulianDate orbitEpoch,
	ReferenceFrame inertialFrame,
	ReferenceFrame fixedFrame,
	double inclination,
	Duration ascendingNodeLocalTime,
	double gravitationalParameter,
	double j2UnnormalizedValue,
	double referenceDistance,
	double planetaryMeanMotion,
	bool isObliquityLessThan90Degrees
)

Parameters

orbitEpoch
Type: AGI.Foundation.TimeJulianDate
The epoch associated with the initial conditions of the propagated orbit.
inertialFrame
Type: AGI.Foundation.GeometryReferenceFrame
An inertial ReferenceFrame centered at the central body.
fixedFrame
Type: AGI.Foundation.GeometryReferenceFrame
A fixed ReferenceFrame centered at the central body.
inclination
Type: SystemDouble
Either the altitude (distance above the surface of the central body) or the inclination of the circular orbit.
ascendingNodeLocalTime
Type: AGI.Foundation.TimeDuration
The local solar time of the ascending node in central body seconds past central body midnight.
gravitationalParameter
Type: SystemDouble
The gravitational parameter of the central body.
j2UnnormalizedValue
Type: SystemDouble
The non-normalized J2 parameter of the central body.
referenceDistance
Type: SystemDouble
The equatorial radius of the central body that also serves as a reference distance for the J2 parameter.
planetaryMeanMotion
Type: SystemDouble
The mean motion of the central body about the Sun. (The central body must be orbiting the Sun.)
isObliquityLessThan90Degrees
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.
Exceptions
ExceptionCondition
ArgumentNullException Thrown when inertialFrame or fixedFrame is .
ArgumentOutOfRangeException Thrown when inclination is negative or greater than π, or when planetaryMeanMotion is less than or equal to zero.
ArithmeticException Thrown when a Sun-synchronous orbit does not exist for the given input conditions.
See Also