IterativeImpulsiveManeuver:

--------------------------------------------------------------------------
   Computes the delta-v's required to implement a formation flying maneuver for
   a single spacecraft. The desired relative state is iteratively recomputed,
   bringing the desired state closer to the current state, until the 
   largest single delta-v in the maneuver is under the maximum limit.

   A fixed thrust actuator is assumed when converting delta-v to burn duration.
   Algorithms do not account for gravitational perturbations or disturbances.

   Since version 7.
--------------------------------------------------------------------------
   Usage:
   [maneuver, foundSoln, resetGoals] = IterativeImpulsiveManeuver( state, goals, window, parameters );
--------------------------------------------------------------------------

   ------
   Inputs
   ------
   state             (.)  Data structure of the orbit state with following fields
                          - el           Measured mean orbital elements of reference, Alfriend format: [a,i,W,w,e,M]
                          - xH           Measured relative state in Hills frame
                          - mass         Spacecraft mass                              [kg]
                          - tM           Timetag of measurement                       [sec]

   goals             (.)  Geometric goals describing desired relative periodic trajectory 


   window            (.)  Data structure of commanded time window with following fields
                          - startTime       Earliest possible start time                    [sec since 1970]
                          - nOrbMin         Minimum number of orbits maneuver may last      [orbits]
                          - nOrbMax         Maximum number of orbits maneuver may last      [orbits]
                          - nManeuvers      Number of maneuvers to search over
                          - timeWeightExp   Time-weighting exponent (greater than 0)

   parameters        (.)  Data structure of planning parameters with following fields
                          - fNom         Nominal Thruster force                             [kN]
                          - dTMax        Maximum allowable burn duration                    [sec]
                          - horizon      Minimum time between planning and first burn       [sec]
                          - tDelayOOP    Minimum time between final IP burn and OOP burn    [sec]
                          - nSPOCoarse   Number of samples per orbit for LP (coarse computation)
                          - nSPOFine     Number of samples per orbit for LP (fine computation)
                          - maxDeltaV    Maximum delta-v

   -------
   Outputs
   -------
   maneuver          (.)  Maneuver data structure with following fields
                          - t0           Earliest burn start time
                          - tF           Latest burn finish time
                          - nBurns       Number of burns required
                          + burnData[]   Array of burn data structures with following fields
                             - t   Burn start time   [sec since 1970]
                             - dT  Burn duration     [sec]
                             - dV  Delta-V           [km/s]
                             - uX  unit x Hills direction 
                             - uY  unit y Hills direction
                             - uZ  unit z Hills direction
   foundSoln         (1)  Flag indicating whether a solution was found or not
   resetGoals        (1)  Flag indicating whether the goals were reset or not
   
--------------------------------------------------------------------------

Children:

FormationFlying: Control/ImpulsiveLPManeuver
FormationFlying: Control/ImpulsiveManeuver
FormationFlying: Coord/IsCircGeom
FormationFlying: Coord/IsEccGeom
FormationFlying: DataStructures/PlanningParameters_Structure
FormationFlying: DataStructures/Window_Structure
FormationFlying: Guidance/PCGoals
FormationFlying: Transformation/FFEccGoals2Hills
FormationFlying: Transformation/FFEccHills2Goals
FormationFlying: Transformation/GeometryCirc2Ecc
FormationFlying: Transformation/GeometryEcc2Circ
FormationFlying: Transformation/Goals2Hills
FormationFlying: Transformation/Hills2Goals
FormationFlying: Utility/NOrbVector
Orbit: OrbitCoord/El2Alfriend
OrbitMiniToolbox: Support/M2Nu
SC: BasicOrbit/OrbRate