Spacecraft.OrbitWizardRelativeMotionSafetyEllipse(Spacecraft, Variable, Variable, Variable, Variable, Variable) Method

Top 

Description

Configures the orbit state of the calling Spacecraft to fly in a safety ellipse formation with the specified radial and cross-track offsets, the center of the ellipse in track, the center of the ellipse rate of change in track seen by the primarySC, and the radial phase angle, from the primarySC.

 

This formation orbit wizard is based on the HCW system, so it assumes that the primarySC is in a two-body circular orbit, and that the secondarySC is near to the primary and propagated with the HCW propagator. If this is not the case, the actual propagated formation will not maintain the idealized relative motion.

 

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.

 

Method Signature

Spacecraft.OrbitWizardRelativeMotionSafetyEllipse(

Spacecraft primarySC,


Variable radialMagnitude,


Variable crossTrackMaxDistance,


Variable centerOfEllipseInTrack,


Variable centerOfEllipseRateInTrack,


Variable radialPhaseAngle)

 

 

Arguments

primarySC


Description:

The Spacecraft with which the calling Spacecraft will fly in formation. This orbit wizard assumes that the primary Spacecraft is in a circular orbit and using either a TwoBody or HCW propagator.

 

 

radialMagnitude


Description:

Maximum distance in the radial direction, corresponding to the semi-minor axis of the in-plane (i.e. radial-intrack plane) projection of the safety ellipse

Units:

km

Valid Range:

radialMagnitude > 0

 

 

crossTrackMaxDistance


Description:

Maximum distance in the cross-track direction, measured from positive in-track direction.

Units:

km

 

 

centerOfEllipseInTrack


Description:

The center of ellipse in track.

Units:

km

 

 

centerOfEllipseRateInTrack


Description:

The center of ellipse rate in track.

Units:

km/s

 

 

radialPhaseAngle


Description:

Phase angle of the radial motion, with zero defined where the radial offset is max and the radial relative velocity is zero.

Units:

deg

Valid Range:

-360 ≤ radialPhaseAngle ≤ 360

 

 

 

Syntax

mySpacecraft1.OrbitWizardRelativeMotionSafetyEllipse(mySpacecraft2, myVariable1, myVariable2, myVariable3, myVariable4, myVariable5);

 

 

See also

Spacecraft Object

Spacecraft Propagation Guide

Coverage and Contact Analysis Guide