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.
The momentum, its residual and whether the request is met.
Throws
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.
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
Frelative to its take-off,(q0 F)⁻¹ q(t) F, the identity at take-off whatever the frame, isRx(φ) 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.