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 nanosecond timing precision mode.

Click here to see the documentation for this object in millisecond 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);