Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
32fe618
ENH: first aero refactor draft
MateusStano Jun 23, 2026
b45178f
ENH: second draft
MateusStano Jun 27, 2026
e76c31c
TST: add tests
MateusStano Jul 2, 2026
b0c5233
MNT: polish event and flight-phase helper docstrings
MateusStano Jul 10, 2026
63cad27
ENH: rework aerodynamic coefficients onto a body-frame GenericSurface
MateusStano Jul 10, 2026
f6dd040
DOC: improve generic_surfaces rst
MateusStano Jul 10, 2026
a2c617c
TST: rebuild calisto_linear_generic from extracted Barrowman curves
MateusStano Jul 10, 2026
fb236c6
ENH: add force convention to LinearGenericSurface
MateusStano Jul 11, 2026
8fd3b16
ENH: apply review changes
MateusStano Jul 23, 2026
c926bdd
DOC: creat CP rst page and review reference docs
MateusStano Jul 24, 2026
3260573
TST: minor fixes
MateusStano Jul 25, 2026
84d3b6a
TST: minor fixes
MateusStano Jul 25, 2026
8dfb153
Merge branch 'enh/events' into enh/aero-refactor
MateusStano Sep 19, 2026
bdd4a8c
Merge branch 'enh/events' into enh/aero-refactor
MateusStano Sep 20, 2026
aac6a1b
ENH: stability, generic surface and disturbance response rework
MateusStano Oct 4, 2026
052babd
DOC: update stability and generic surface guides
MateusStano Oct 4, 2026
f315df7
ENH: rate derivatives on GenericSurface
MateusStano Oct 4, 2026
841ad04
DOC: remove a broken link from the stability guide
MateusStano Oct 4, 2026
f107bb7
Merge branch 'enh/events' into enh/aero-refactor
MateusStano Oct 5, 2026
a6fb24f
ENH: switch aerodynamic surfaces on and off with event commands
MateusStano Oct 5, 2026
ee92cdc
MNT: give the generic surfaces one argument order, keyword-only after…
MateusStano Oct 5, 2026
b1b2eff
DOC: explain which drag a rocket with generic surfaces uses
MateusStano Oct 5, 2026
1fbf86b
STY: fix pylint warnings
MateusStano Oct 5, 2026
8ec2c8b
STY: ruff update
MateusStano Oct 5, 2026
b5d20ca
Merge branch 'enh/events' into enh/aero-refactor
MateusStano Oct 5, 2026
17d32fe
STY: put the unused-argument disable where pylint 4.1 reads it
MateusStano Oct 5, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions .pylintrc
Original file line number Diff line number Diff line change
Expand Up @@ -231,12 +231,29 @@ good-names=FlightPhases,
R_uncanted,
R_body_to_fin,
Re, # Reynolds number
cL_alpha,
cQ_beta,
cN_alpha,
cY_beta,
cL,
cD,
cQ,
cN,
cY,
cA,
cNf,
cNd,
cYf,
cYd,
cAf,
cAd,

# Good variable names regexes, separated by a comma. If names match any regex,
# they will always be accepted
good-names-rgxs= ^[a-z][0-9]?$, # Single lowercase characters, possibly followed by a single digit
^[A-Z][0-9]{0,2}$, # Single uppercase characters, possibly followed by one or two digits
^[A-Z]+_\d+(_dot)?$, # Uppercase characters followed by underscore and digits, optionally followed by _dot
^[A-Z][0-9]_[a-z]+$, # An equation symbol with a lowercase suffix, such as M1_cm
^(dry_|propellant_)[A-Z]+_\d+$, # Variables starting with 'dry_' or 'propellant_', followed by uppercase characters, underscore, and digits
^[a-z]+_ISA$, # Lowercase words ending with '_ISA'
^plot(1D|2D)$, # Variables starting with 'plot' followed by '1D' or '2D'
Expand Down
Empty file.
100 changes: 100 additions & 0 deletions data/monte_carlo/stability_dispersion.inputs.txt

Large diffs are not rendered by default.

100 changes: 100 additions & 0 deletions data/monte_carlo/stability_dispersion.outputs.txt

Large diffs are not rendered by default.

839 changes: 640 additions & 199 deletions docs/notebooks/getting_started.ipynb

Large diffs are not rendered by default.

3 changes: 3 additions & 0 deletions docs/reference/classes/Function.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,7 @@ Function Classes
.. seealso:: :doc:`Function Class Usage </user/function>`

.. autoclass:: rocketpy.Function
:members:

.. autoclass:: rocketpy.PiecewiseFunction
:members:
5 changes: 5 additions & 0 deletions docs/reference/classes/PointMassRocket.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
PointMassRocket Class
---------------------

.. autoclass:: rocketpy.PointMassRocket
:members:
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
Controllable Generic Surface Class
----------------------------------

.. autoclass:: rocketpy.ControllableGenericSurface
:members:
3 changes: 2 additions & 1 deletion docs/reference/classes/aero_surfaces/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,5 @@ AeroSurface Classes
RailButtons
AirBrakes
GenericSurface
LinearGenericSurface
LinearGenericSurface
ControllableGenericSurface
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ input parameters, enabling robust Monte Carlo simulations.
stochastic_trapezoidal_fins
stochastic_elliptical_fins
stochastic_tail
stochastic_air_brakes
stochastic_rail_buttons
stochastic_rocket
stochastic_parachute
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
Stochastic Air Brakes
---------------------

.. autoclass:: rocketpy.stochastic.StochasticAirBrakes
:members:
5 changes: 5 additions & 0 deletions docs/reference/classes/motors/EmptyMotor.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
EmptyMotor Class
----------------

.. autoclass:: rocketpy.EmptyMotor
:members:
5 changes: 5 additions & 0 deletions docs/reference/classes/motors/PointMassMotor.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
PointMassMotor Class
--------------------

.. autoclass:: rocketpy.PointMassMotor
:members:
2 changes: 2 additions & 0 deletions docs/reference/classes/motors/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ Motor Classes
HybridMotor
LiquidMotor
GenericMotor
PointMassMotor
EmptyMotor
Fluid
Tank Classes <tanks/index>
Tank Geometry Classes <geometries/index>
Expand Down
1 change: 1 addition & 0 deletions docs/reference/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ This reference manual details functions, modules, methods and attributes include
AeroSurface Classes <classes/aero_surfaces/index>
classes/Components
classes/Rocket
classes/PointMassRocket
classes/Parachute
classes/sensors/index.rst
classes/Flight
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
AeroSurface Plots Class
-----------------------

.. autoclass:: rocketpy.plots.aero_surface_plots._AeroSurfacePlots
.. autoclass:: rocketpy.plots.aero_surface_plots._GenericSurfacePlots
:members:
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
AeroSurface Prints Class
------------------------

.. autoclass:: rocketpy.prints.aero_surface_prints._AeroSurfacePrints
.. autoclass:: rocketpy.prints.aero_surface_prints._GenericSurfacePrints
:members:
Binary file modified docs/static/rocket/aeroframe.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/rocket/cal-per-length.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/rocket/damped-oscillation.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/rocket/stable-unstable.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 0 additions & 7 deletions docs/technical/aerodynamics/elliptical_fins.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,6 @@
Elliptical Fins Equations
=========================

:Author: Mateus Stano Junqueira,
:Author: Franz Masatoshi Yuri,
:Author: Kaleb Ramos Wanderley Santos,
:Author: Matheus Gonçalvez Doretto,
:Date: February 2022


Nomenclature
============

Expand Down
8 changes: 0 additions & 8 deletions docs/technical/aerodynamics/individual_fins.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,6 @@
Individual Fin Model
====================

:Author: Mateus Stano Junqueira
:Date: March 2025

Introduction
============

Expand Down Expand Up @@ -491,8 +488,3 @@ rocket:

# Angle of sideslip
test_flight.angle_of_sideslip.plot(test_flight.out_of_rail_time, 5)





26 changes: 0 additions & 26 deletions docs/technical/aerodynamics/roll_equations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,6 @@
Roll equations for high-powered rockets
=======================================

:Author: Bruno Abdulklech Sorban,
:Author: Mateus Stano Junqueira
:Date: February 2022

Nomenclature
============

Expand Down Expand Up @@ -236,25 +232,3 @@ For the damping moment lift coefficient derivative:
.. math:: (C_{lf\delta})_{K_{f}} = K_{f} \cdot C_{lf\delta}

.. math:: (C_{ld\omega})_{K_{d}} = K_{d} \cdot C_{ld\omega}

Comments
========

Roll moment is expected to increase linearly with velocity. This
relationship can be verified in the rotation frequency equilibrium
equation, described by [Niskanen]_ in equation
(3.73), and again stated below:

.. math:: f_{eq} = \frac{\omega}{2\pi} = \frac{A_{ref}\beta \overline{Y_t} (C_{N\alpha})_1 }{4\pi^2 \sum_{i} c_i \xi^2 \Delta \xi} \, \delta V_0

The auxiliary value :math:`\beta` is defined as:
:math:`\beta = \sqrt{|1-M|}`, where M is the speed of the rocket in
Mach.

.. .. math:: k = 1 + \frac{\frac{\sqrt{s^2-r_{t}^2}\Bigl(2C_{r}r_{t}^2\ln\Bigl(\frac{2s\sqrt{s^2-r_{t}^2}+2s^2}{r_{t}}\Bigr)-2C_{r}r_{t}^2\ln\Bigl(2s\Bigr)\Bigr)+2C_{r}s^3-{\pi}C_{r}r_{t}s^2-2C_{r}r_{t}^2s+{\pi}C_{r}r_{t}^3}{2r_{t}s^3-2r_{t}^3s}}{C_{r}\cdot\Bigl(\dfrac{s^2}{3}+\dfrac{{\pi}r_{t}s}{4}\Bigr)}

.. .. math::

.. k = 1 + \frac{\sqrt{s^2-r_{t}^2}\Bigl(2r_{t}^2\ln\Bigl(\frac{2s\sqrt{s^2-r_{t}^2}+2s^2}{r_{t}}\Bigr)-2r_{t}^2\ln\Bigl(2s\Bigr)\Bigr)+2s^3-{\pi}r_{t}s^2-2r_{t}^2s+{\pi}r_{t}^3}
.. {(2r_{t}s^3-2r_{t}^3s) \cdot\Bigl(\dfrac{s^2}{3}+\dfrac{{\pi}r_{t}s}{4}\Bigr)}

Loading
Loading