Natural Motion Circumnavigation¶

Script Type: WsfNaturalMotionCircumnavigation

maneuver natural_motion_circumnavigation
   Common Maneuver Commands …
   target_platform ...
   orbit_size ...
   orbit_phase ...
   out_of_plane_amplitude ...
   out_of_plane_phase ...
   delta_time ...
   maximum_delta_time ...
   maximum_delta_v ...
   optimize_time ...
   optimize_delta_v ...
   optimize_cost ...
   tolerance ...
end_maneuver

Perform a maneuver that brings the executing platform into a natural motion circumnavigation (NMC) of another platform. The resulting motion of the executing platform is the superposition of an elliptical relative orbit in the orbital plane of the target platform, and a harmonic oscillation in the out-of-plane direction. For details on the relative orbit, please see Natural Motion Circumnavigation Details.

In addition to the final relative motion, the executing platform will perform maneuvers similar to a Rendezvous to transfer from its initial orbit to the final NMC. Because of this transfer, this maneuver also has many options that overlap with Rendezvous.

target_platform <string-value>¶: The target platform around which the executing platform will perform a NMC.

orbit_size <length-value>¶: The semi-major-axis of the relative orbit.

orbit_phase <angle-value>¶: The phase along the relative orbit at which the executing platform will be inserted into the NMC.

out_of_plane_amplitude <length-value>¶: The amplitude of the out-of-plane oscillation.

out_of_plane_phase <angle-value>¶: The phase in the harmonic oscillation at which the executing platform will be inserted into the NMC.

delta_time <time-value>¶: The desired time past the current time for execution of the maneuver. No Optimizations are performed.

Note

One of delta_time, maximum_delta_time or maximum_delta_v must be set. If maximum_delta_time is not set and maximum_delta_v is set, maximum_delta_time will be set to one orbital period of the target platform.

maximum_delta_time <time-value>¶: The maximum time after the current time to be considered for execution of the maneuver. Optimizations in time will occur between the time of the constraint and the provided time.

maximum_delta_v <speed-value>¶: The maximum delta_v to be considered for execution of the maneuver. Optimizations in time to find minimum delta-v will occur between the time of the constraint and any time limit set by maximum_delta_time.

Note

This value is constrained to be less than or equal to the delta-v specified in the maneuvering model.

optimize_time¶: Optimize the targeting solution such that it executes at the earliest possible time. This optimization is also constrained by the maximum_delta_v value, if provided.

optimize_delta_v¶: Optimize the targeting solution such that it executes at a time that minimizes total delta-v expended.

optimize_cost <cost_type> …¶

Optimize the targeting solution such that the specified cost is minimized. The available cost functions are:

blended <A value> <B value> <C value>

This cost function depends on the transfer duration, $\Delta t$ , and the change in velocity, $\Delta V$ as follows:

$g(\Delta t, \Delta V) = A \Delta t + B \Delta V + C \Delta t \Delta V$ .

The values of $A$ , $B$ , and $C$ are provided as additional real arguments after the specification of the ‘blended’ cost.