Rel/v1.12.0

[MateusStano]

I am changing how we make realeases a bit. We were previously making three PRs for each release:

• One for merging develop into master
• One for updating master version
• One for updating develop version

This time I am simply making one PR from a branch that already has the correct versioning straight to master.

Important!

Readthedocs is not being built because of #933

[codecov]

Codecov Report

❌ Patch coverage is 87.71704% with 191 lines in your changes missing coverage. Please review.
✅ Project coverage is 81.05%. Comparing base (9cf3dd4) to head (1618fb0).

Files with missing lines	Patch %	Lines
rocketpy/simulation/flight.py	87.63%	45 Missing ⚠️
rocketpy/mathutils/function.py	85.77%	32 Missing ⚠️
rocketpy/tools.py	80.53%	22 Missing ⚠️
rocketpy/environment/environment.py	69.84%	19 Missing ⚠️
rocketpy/simulation/flight_comparator.py	94.62%	15 Missing ⚠️
rocketpy/motors/solid_motor.py	45.83%	13 Missing ⚠️
rocketpy/plots/rocket_plots.py	59.09%	9 Missing ⚠️
rocketpy/simulation/monte_carlo.py	61.90%	8 Missing ⚠️
rocketpy/rocket/rocket.py	89.06%	7 Missing ⚠️
rocketpy/plots/monte_carlo_plots.py	92.20%	6 Missing ⚠️
... and 4 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #935      +/-   ##
==========================================
+ Coverage   80.27%   81.05%   +0.78%     
==========================================
  Files         104      107       +3     
  Lines       12769    13891    +1122     
==========================================
+ Hits        10250    11260    +1010     
- Misses       2519     2631     +112     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Release PR for RocketPy v1.12.0, consolidating version bump + a broad set of feature, test, and documentation updates associated with the release.

Changes:

• Bump package version to 1.12.0, update docs release metadata, and update tooling configuration (Python 3.10+, Ruff target).
• Add/extend multiple simulation & plotting capabilities (e.g., Monte Carlo background maps + save options, confidence intervals, animations, 3-DOF support pieces) with extensive new tests.
• Expand environment and rocket/motor modeling support (e.g., MERRA-2 mapping, rail button bending moments, drag input refactor, point-mass motor/rocket).

Reviewed changes

Copilot reviewed 83 out of 86 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
tests/unit/test_utilities.py	Add fin flutter branch coverage
tests/unit/test_rail_buttons_bending_moments.py	New rail-button bending moment unit tests
tests/unit/test_plots.py	Add animation helper tests + GIF checks
tests/unit/test_flight_data_exporter.py	Regression test for CSV header spacing
tests/unit/simulation/test_monte_carlo_plots_background.py	Unit tests for MC background fetching/errors
tests/unit/simulation/test_monte_carlo.py	Tests for bootstrap CI estimator
tests/unit/simulation/test_flight.py	Tests for axial accel + controller regression
tests/unit/rocket/test_rocket.py	Tests for missing-components warning + drag inputs
tests/unit/rocket/test_point_mass_rocket.py	New PointMassRocket unit tests
tests/unit/rocket/aero_surface/test_generic_surfaces.py	CSV independent-variable order test
tests/unit/motors/test_solidmotor.py	Split/rename motor info tests
tests/unit/motors/test_point_mass_motor.py	New PointMassMotor unit tests
tests/unit/motors/test_hybridmotor.py	Fixture rename + minor loop bound fix
tests/unit/motors/test_genericmotor.py	Mocked ThrustCurve API + cache tests
tests/unit/mathutils/test_function.py	Tests for regular_grid Function interpolation/extrapolation
tests/integration/test_plots.py	Reduce compare flights combinations
tests/integration/simulation/test_monte_carlo_plots_background.py	Integration test for background map outputs
tests/integration/simulation/test_monte_carlo.py	Add save-path coverage + cleanup
tests/integration/simulation/test_flight_comparator_workflow.py	Integration workflow for FlightComparator
tests/integration/simulation/test_flight.py	Add overshoot integration coverage
tests/integration/motors/test_solid_motor.py	Integration coverage for radial burn behavior
tests/integration/motors/test_hybridmotor.py	Add hybrid radial burn integration coverage
tests/integration/environment/test_environment.py	Fix RAP date handling + add MERRA2 test
tests/fixtures/motor/hybrid_fixtures.py	Rename oxidizer tank fixture usage
tests/fixtures/flight/flight_fixtures.py	Add time_overshoot fixture + 3DOF fixtures/constants
tests/fixtures/environment/environment_fixtures.py	Add Kennedy environment fixture
tests/conftest.py	Force matplotlib Agg + add MERRA2 netCDF fixture
tests/acceptance/test_bella_lui_rocket.py	Update drag setup to 7D Function usage
rocketpy/utilities.py	Pass filename= explicitly to flutter plots
rocketpy/units.py	Refactor axis handling to match
rocketpy/stochastic/stochastic_rocket.py	Apply drag factors to 7D drag functions
rocketpy/simulation/monte_carlo.py	Add bootstrap CI estimation + sim monitor change
rocketpy/simulation/flight_data_exporter.py	Fix CSV header comma spacing
rocketpy/simulation/init.py	Export FlightComparator in public API
rocketpy/rocket/rocket.py	Drag input refactor + missing-components warning + serialization changes
rocketpy/rocket/point_mass_rocket.py	New PointMassRocket implementation
rocketpy/rocket/parachute.py	Formatting cleanup for doc + lambda
rocketpy/rocket/aero_surface/tail.py	Minor lambda formatting
rocketpy/rocket/aero_surface/rail_buttons.py	Add button_height + serialization support
rocketpy/rocket/aero_surface/nose_cone.py	Refactor kind selection to match
rocketpy/rocket/aero_surface/generic_surface.py	Use shared CSV loader + accept header order
rocketpy/rocket/init.py	Export PointMassRocket
rocketpy/prints/flight_prints.py	Add bending-moment prints
rocketpy/plots/tank_plots.py	Add tank volume animation
rocketpy/plots/rocket_plots.py	Use Mach-only wrappers for drag curves + refactors
rocketpy/plots/plot_helpers.py	Add animation save/show helper
rocketpy/plots/motor_plots.py	Add propellant mass animation
rocketpy/plots/monte_carlo_plots.py	Add background map fetching + save filename support
rocketpy/plots/flight_plots.py	Add bending moment plots + callable-source handling
rocketpy/plots/compare/compare_flights.py	Fix “Weather”→“Whether” in docstrings
rocketpy/motors/solid_motor.py	Add only_radial_burn behavior + serialization
rocketpy/motors/point_mass_motor.py	New PointMassMotor implementation
rocketpy/motors/motor.py	Add ThrustCurve API loader + persistent cache
rocketpy/motors/hybrid_motor.py	Thread only_radial_burn into hybrid init
rocketpy/motors/init.py	Export PointMassMotor
rocketpy/environment/weather_model_mapping.py	Add MERRA2 variable mapping
rocketpy/environment/environment.py	Add MERRA2 support + refactor to match
rocketpy/init.py	Export PointMassMotor/PointMassRocket
pyproject.toml	Version bump + extras + Ruff target-version
docs/user/rocket/generic_surface.rst	Document CSV column order flexibility
docs/user/mrs.rst	Formatting fixes + add CI example section
docs/user/motors/tanks.rst	Document tank volume animation
docs/user/motors/liquidmotor.rst	Document tank volume animation usage
docs/user/motors/genericmotor.rst	Document ThrustCurve API loader + caching
docs/user/index.rst	Add 3DOF guide link + minor formatting
docs/user/function.rst	Update ND interpolation support docs
docs/user/flight_comparator.rst	New FlightComparator user guide
docs/user/flight.rst	Document rail button bending moments
docs/user/first_simulation.rst	Minor doc formatting fixes
docs/user/environment/1-atm-models/standard_atmosphere.rst	Minor doc formatting fix
docs/user/environment/1-atm-models/reanalysis.rst	Add MERRA-2 docs section
docs/user/compare_flights.rst	Avoid long output in docs example
docs/conf.py	Update release + add jupyter_sphinx kwargs
CHANGELOG.md	Add v1.12.0 section (needs link fixes)
.vscode/settings.json	Add “pointmassmotor” to spellchecker
.pylintrc	Update config (good-names tweak)
.gitignore	Ignore docs GIF outputs

Comments suppressed due to low confidence (1)

rocketpy/rocket/rocket.py:2006

• Rocket.to_dict() now always serializes power_off_drag/power_on_drag as the processed 7D Functions, while the class docstring says the original user input is preserved for reconstruction/Monte Carlo workflows. This also means a Rocket reconstructed from dict will not retain the original input type/shape. If the intent is to preserve both, consider exporting both the raw inputs (when serializable) and the normalized 7D Functions (for simulation), or updating the docstring/serialization contract accordingly.

[Copilot]

requests.get(...) calls to the ThrustCurve API are made without an explicit timeout. This can hang indefinitely in offline/slow network environments (including CI) and makes the feature operationally fragile. Consider adding a conservative default timeout (and possibly retries/backoff) to both the search and download requests, and include it in the raised error context.

[Copilot]

Rocket.power_off_drag / Rocket.power_on_drag are now assigned to the raw user input, whereas historically these attributes were Function objects (and other parts of the codebase still treat drag curves as Functions, e.g. plots previously accessed .x_array/.y_array). This is a breaking public API change and also makes the attribute type inconsistent depending on construction path (e.g., from_dict currently passes a Function). Consider preserving backward compatibility by keeping power_off_drag/power_on_drag as Function wrappers (e.g., Mach-only), and storing the original user input under a new attribute like power_off_drag_input/power_on_drag_input.

[Copilot]

allow_errors=True will let documentation builds succeed even when examples/cells are failing, which can hide regressions and produce incomplete docs. If this is only a temporary workaround for the current RTD issue, consider gating it behind an env var (e.g., only on RTD), or keeping allow_errors=False and selectively skipping known-problematic cells/files instead.

Suggested change

	jupyter_execute_kwargs = {
	"timeout": 300, # 5 minutes timeout per cell
	"allow_errors": True, # Continue building even if cells raise errors
	jupyter_allow_errors_env = os.environ.get("ROCKETPY_JUPYTER_ALLOW_ERRORS", "")
	jupyter_allow_errors = jupyter_allow_errors_env.lower() in {
	"1",
	"true",
	"yes",
	"on",
	}
	jupyter_execute_kwargs = {
	"timeout": 300, # 5 minutes timeout per cell
	"allow_errors": jupyter_allow_errors, # Optionally continue building even if cells raise errors

[Copilot]

The v1.12.0 changelog entries have broken/mismatched links (e.g., [#914] link is missing a closing )/has a trailing _, and the confidence interval entry label [#891] points to PR #897). This will render incorrectly on GitHub/PyPI. Please fix the markdown link syntax and ensure the PR numbers match the URLs.

[Copilot]

This test prints to stdout (print(f"Calculated Elevation: ...")), which adds noise to test output and can make CI logs harder to read. Prefer removing the print or asserting via the existing assert message (or capturing output with capsys if you need to validate it).

[Copilot]

In the only_radial_burn branch, the Jacobian sets inner_radius_derivative_wrt_height = 0, but grain_inner_radius_derivative = -volume_diff / (2π r h) still depends on grain_height. This makes the Jacobian mathematically incorrect and can degrade/derail LSODA integration. Please compute the correct partial derivative w.r.t. height (and keep only height_derivative_* at zero since dh/dt=0).