@@ -356,6 +356,27 @@ restoring moments from fins and other stabilizing surfaces. The 3-DOF
356356weathercocking model provides a simplified representation of this behavior
357357without requiring full 6-DOF rotational dynamics.
358358
359+ The weathercocking coefficient (``weathercock_coeff ``, often abbreviated
360+ ``wc ``) represents the rate at which the rocket's body axis aligns with
361+ the relative wind. This simplified model does not consider aerodynamic
362+ surfaces (for example, fins) or compute aerodynamic torques. In a
363+ full 6-DOF model, weathercocking depends on quantities such as the
364+ static margin and the normal-force coefficient, which produce restoring
365+ moments that turn the rocket into the wind. A 3-DOF point-mass
366+ simulation cannot compute those moments, so the model enforces
367+ alignment of the body axis toward the freestream with a proportional
368+ law.
369+
370+ Treat ``weathercock_coeff `` as a tuning parameter that approximates the
371+ combined effect of static stability and restoring moments. It has no
372+ direct physical units; designers typically select values by trial and
373+ error and validate them later against full 6-DOF simulations.
374+
375+ Sources:
376+
377+ - `Weathercocking (NASA Bottle Rocket tutorial) <https://www.grc.nasa.gov/www/k-12/VirtualAero/BottleRocket/airplane/rktcock.html >`_
378+ - `Rocket weather-cocking (NASA beginners guide) <https://www1.grc.nasa.gov/beginners-guide-to-aeronautics/rocket-weather-cocking/#new-flight-path >`_
379+
359380The ``weathercock_coeff `` Parameter
360381^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
361382
@@ -371,7 +392,7 @@ in the :class:`rocketpy.Flight` class:
371392 longitude=-106.974998,
372393 elevation=1400
373394 )
374- env.set_atmospheric_model(type="StandardAtmosphere ")
395+ env.set_atmospheric_model(type="standard_atmosphere ")
375396
376397 motor = PointMassMotor(
377398 thrust_source=1500,
@@ -460,7 +481,7 @@ accuracy.
460481 longitude=9.003336,
461482 elevation=407,
462483 )
463- env.set_atmospheric_model(type="StandardAtmosphere ")
484+ env.set_atmospheric_model(type="standard_atmosphere ")
464485 env.max_expected_height = 2000
465486
466487 # Full 6-DOF Motor
0 commit comments