Spacecraft.CardinalPoints Method

Top 

Description

Returns the times when the Spacecraft is at each of the cardinal points. The cardinal point calculations are based on the alpha angle, which is the angle between the Spacecraft's position and the target CelestialObject's position with respect to the Spacecraft's central body when both vectors are projected onto the Spacecraft's orbit plane. Note that the target CelestialObject is modeled as a point.

 

The cardinal points, as a function of the alpha angle, are defined as:

 

- Noon (alpha angle = 0)

- Dusk (alpha angle = 90)

- Midnight (alpha angle = 180)

- Dawn (alpha angle = 270)

 

The mathematical definition of the alpha angle is:

 

 

Below is a diagram depicting how the alpha angle is defined:

 

A visual representation of the Alpha angle.

A visual representation of the Alpha angle.

 

Timing Precision Mode

This page describes functionality in millisecond timing precision mode. Millisecond timing precision mode is deprecated and will be removed in a future release. We recommend that you migrate your Mission Plans to nanosecond timing precision mode.

Click here to see the documentation for this object in nanosecond timing precision mode.

 

Overload List

Signatures

Return Value

Description

Spacecraft.CardinalPoints()

String

Returns the times when the Spacecraft is at each of the cardinal points. The cardinal point calculations are based on the alpha angle, which is the angle between the Spacecraft's position and the Sun's position with respect to the Spacecraft's central body when both vectors are projected onto the Spacecraft's orbit plane. Note that the Sun is modeled as a point.

Spacecraft.CardinalPoints(CelestialObject target)

String

Returns the times when the Spacecraft is at each of the cardinal points. The cardinal point calculations are based on the alpha angle, which is the angle between the Spacecraft's position and the target CelestialObjects's position with respect to the Spacecraft's central body when both vectors are projected onto the Spacecraft's orbit plane. Note that the target CelestialObject is modeled as a point.

Spacecraft.CardinalPoints(Array EventTime, Array EventType)

Variable

Returns the times when the Spacecraft is at each of the cardinal points. The cardinal point calculations are based on the alpha angle, which is the angle between the Spacecraft's position and the Sun's position with respect to the Spacecraft's central body when both vectors are projected onto the Spacecraft's orbit plane. Note that the Sun is modeled as a point.

Spacecraft.CardinalPoints(CelestialObject target, Array EventTime, Array EventType)

Variable

Returns the times when the Spacecraft is at each of the cardinal points. The cardinal point calculations are based on the alpha angle, which is the angle between the Spacecraft's position and the target CelestialObjects's position with respect to the Spacecraft's central body when both vectors are projected onto the Spacecraft's orbit plane. Note that the target CelestialObject is modeled as a point.

 

 

See also

Spacecraft Object

Spacecraft.SpacecraftNoon

Spacecraft.SunTerminatorCrossingTimes

Spacecraft Propagation Guide

Coverage and Contact Analysis Guide