Skip to content

DOC: add notes on the inputs of the drag coefficient models - #1232

Open
MateusStano wants to merge 1 commit into
developfrom
doc/drag-coefficient-notes
Open

MateusStano wants to merge 1 commit into
developfrom
doc/drag-coefficient-notes

Conversation

@MateusStano

Copy link
Copy Markdown
Member

Related to #1209 and #1142. This is the #1142 item of the v1.14.0 checklist.

Pull request type

  • ReadMe, Docs and GitHub updates

Checklist

Current behavior

The drag section that #1142 added to rocket_usage.rst is correct, but leaves out three things a user needs to build a drag model:

  1. alpha and beta are separate signed angles, and neither is the total angle of attack. The example only used alpha.
  2. The Reynolds number uses the rocket diameter as the reference length. Many tools use the length.
  3. A drag CSV with a missing combination of values still loads, with no warning, but the values between the points change.

New behavior

Two notes in the section cover the three points, and the example now uses alpha**2 + beta**2.

Each point was checked in the code:

  • Flight.__compute_drag_7d_inputs takes alpha from the body y and axial velocity components and beta from the x and axial ones, and computes the Reynolds number with 2 * rocket.radius.
  • A CSV that is not a full grid falls back from regular-grid interpolation to interpolation between scattered points. On a 3 x 3 table, removing one point changed a value between the points from 0.4750 to 0.4375.

Breaking change

  • No

🤖 Generated with Claude Code

- alpha and beta are separate signed angles, to be combined for the total
  angle of attack. The example now uses both.
- The Reynolds number uses the rocket diameter as reference length.
- A drag CSV with a missing combination loads, but interpolates differently.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@MateusStano
MateusStano requested a review from a team as a code owner November 20, 2026 17:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant