AutoMovie API
    Preparing search index...

    Function solveAirborneTakeoff

    • The take-off angular momentum that turns a body in flight through the requested somersault and twist and lands it with no tilt (#3426), for a given shape history and flight.

      The flight uses Yeadon's somersault, tilt and twist terminology (https://www.lboro.ac.uk/microsites/ssehs/biomechanics/papers/nutation.pdf). In this module's coordinate convention the body's attitude in the frame's axes F relative to its take-off, (q0 F)⁻¹ q(t) F, the identity at take-off whatever the frame, is Rx(φ) Rz(θ) Ry(ψ), a somersault φ about the frame's lateral axis X, then a tilt θ about its forward axis Z, then a twist ψ about the body's long axis Y (angles). The somersault and the twist are unwrapped across the integrator's default step, so a whole turn reads 2π and not zero. The returned residual at touchdown is always against the full request, [φ - 2π somersault, θ, ψ - 2π twist], even when continuation stops early.

      The linearized start is (∫ I⁻¹ dt)⁻¹ (turns + ∫ I⁻¹ h dt), the integrals by Simpson's rule: the fixed integration grid in fixed mode, or adaptive quadrature against the shooting angular budget in adaptive mode. That seed estimate does not certify the nonlinear flight. Newton's Jacobian is the forward sensitivity of that same flight, integrated with the orientation (s' = f_y s + f_p, SUNDIALS CVODES, section 4.2.6, https://sundials.readthedocs.io/en/latest/cvodes/Mathematics_link.html), carried into the derivatives of Yeadon's angles. It does not difference separately adapted integrations at machine-epsilon momentum offsets. Continuation scales the whole turn request: a missed stage is halved, an accepted stage advances and doubles the next increment (Allgower and Georg, Introduction to Numerical Continuation Methods), down to the request's angular tolerance. Newton's starts and trial steps are projected onto the momentum ball when a ceiling is given, and a projected trial is accepted only if it lowers the residual (projected search, Bertsekas 1982, https://web.mit.edu/dimitrib/www/ProjectedNewton.pdf). The ceiling bounds the search as well as the answer; a projected point outside the angular tolerance remains a miss. The search's flights are integrated under the embedded error estimate alone; given a momentum budget, the solution's momentum is then integrated once more under it, with its sensitivity, and that judged flight is the one returned, played back and whose residual decides the miss, so the momentum control is paid once, by the flight that is shown; without one the search's own solution is that flight.

      Parameters

      Returns IAutoMovieSolveAirborneTakeoff.ISolution

      The momentum, its residual and whether the request is met.

      When the flight is not positive and finite, the tolerance is not positive and finite, the somersault or twist request is not finite, or a supplied failure scope is not a symbol.