Skip to content

Commit a564397

Browse files
committed
DOC: three_dof_simulation.rst update to add explanation of weather cocking coeff usage and value.
1 parent fc4228c commit a564397

File tree

1 file changed

+23
-2
lines changed

1 file changed

+23
-2
lines changed

docs/user/three_dof_simulation.rst

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -356,6 +356,27 @@ restoring moments from fins and other stabilizing surfaces. The 3-DOF
356356
weathercocking model provides a simplified representation of this behavior
357357
without 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+
359380
The ``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

Comments
 (0)