Module precession_nutation 

Precession and Nutation Physics for Ballistic Projectiles

This module implements the complex angular motion of spinning projectiles:

• Precession: Slow coning motion of the projectile axis
• Nutation: Fast oscillatory motion superimposed on precession
• Angular momentum conservation
• Gyroscopic effects

Structs

AngularState

Complete angular state of the projectile

PrecessionNutationParams

Parameters for precession and nutation calculations

Functions

calculate_combined_angular_motion

Calculate the combined precession and nutation motion

calculate_epicyclic_motion

Calculate the epicyclic (combined precession + nutation) motion

calculate_limit_cycle_yaw

Calculate the limit cycle yaw angle

calculate_nutation_amplitude

Calculate nutation amplitude with exponential damping

calculate_nutation_frequency

Calculate the natural nutation frequency

calculate_precession_frequency

Calculate the natural precession frequency